{"id":22859390,"url":"https://github.com/stevenjdh/covid-tracker","last_synced_at":"2025-03-31T08:20:22.357Z","repository":{"id":62796761,"uuid":"382779389","full_name":"StevenJDH/covid-tracker","owner":"StevenJDH","description":"Tracks the number of infected cases with the Covid-19 virus.","archived":false,"fork":false,"pushed_at":"2024-01-27T16:39:58.000Z","size":5326,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-02-06T12:48:00.753Z","etag":null,"topics":["covid-19","microservice","tracker"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/StevenJDH.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"StevenJDH","custom":["https://www.paypal.me/stevenjdh","https://www.buymeacoffee.com/stevenjdh"]}},"created_at":"2021-07-04T06:21:58.000Z","updated_at":"2021-10-02T22:58:32.000Z","dependencies_parsed_at":"2025-02-06T12:51:42.292Z","dependency_job_id":null,"html_url":"https://github.com/StevenJDH/covid-tracker","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StevenJDH%2Fcovid-tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StevenJDH%2Fcovid-tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StevenJDH%2Fcovid-tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StevenJDH%2Fcovid-tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/StevenJDH","download_url":"https://codeload.github.com/StevenJDH/covid-tracker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246436340,"owners_count":20776995,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["covid-19","microservice","tracker"],"created_at":"2024-12-13T09:06:49.617Z","updated_at":"2025-03-31T08:20:22.351Z","avatar_url":"https://github.com/StevenJDH.png","language":"Java","funding_links":["https://github.com/sponsors/StevenJDH","https://www.paypal.me/stevenjdh","https://www.buymeacoffee.com/stevenjdh"],"categories":[],"sub_categories":[],"readme":"# COVID-19 Tracker\n\n[![build](https://github.com/StevenJDH/covid-tracker/actions/workflows/maven-sonar-container-workflow.yml/badge.svg?branch=main)](https://github.com/StevenJDH/covid-tracker/actions/workflows/maven-sonar-container-workflow.yml)\n![GitHub release (latest by date including pre-releases)](https://img.shields.io/github/v/release/StevenJDH/covid-tracker?include_prereleases)\n[![Codacy Badge](https://app.codacy.com/project/badge/Grade/9c6b7925766c4c9ea36480a2f3e2d315)](https://www.codacy.com/gh/StevenJDH/covid-tracker/dashboard?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=StevenJDH/covid-tracker\u0026amp;utm_campaign=Badge_Grade)\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=StevenJDH_covid-tracker\u0026metric=alert_status)](https://sonarcloud.io/dashboard?id=StevenJDH_covid-tracker)\n[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=StevenJDH_covid-tracker\u0026metric=sqale_rating)](https://sonarcloud.io/dashboard?id=StevenJDH_covid-tracker)\n[![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=StevenJDH_covid-tracker\u0026metric=reliability_rating)](https://sonarcloud.io/dashboard?id=StevenJDH_covid-tracker)\n[![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=StevenJDH_covid-tracker\u0026metric=sqale_index)](https://sonarcloud.io/dashboard?id=StevenJDH_covid-tracker)\n[![Sonar Violations (long format)](https://img.shields.io/sonar/violations/StevenJDH_covid-tracker?format=long\u0026server=https%3A%2F%2Fsonarcloud.io)](https://sonarcloud.io/dashboard?id=StevenJDH_covid-tracker)\n[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=StevenJDH_covid-tracker\u0026metric=security_rating)](https://sonarcloud.io/dashboard?id=StevenJDH_covid-tracker)\n[![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=StevenJDH_covid-tracker\u0026metric=vulnerabilities)](https://sonarcloud.io/dashboard?id=StevenJDH_covid-tracker)\n[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=StevenJDH_covid-tracker\u0026metric=coverage)](https://sonarcloud.io/dashboard?id=StevenJDH_covid-tracker)\n[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=StevenJDH_covid-tracker\u0026metric=ncloc)](https://sonarcloud.io/dashboard?id=StevenJDH_covid-tracker)\n![Maintenance](https://img.shields.io/maintenance/yes/2024)\n![GitHub](https://img.shields.io/github/license/StevenJDH/covid-tracker)\n\nCOVID-19 Tracker is a microservice that tracks the number of infected cases with the COVID-19 virus. The Coronavirus disease (COVID-19) is the name given to a newly discovered strain of Coronavirus, called SARS-CoV-2, which was officially declared a Pandemic on 11 March 2020. Statistical data associated with COVID-19 changes rapidly, and there are various sources aggregating this data that update at different times, so do expect some variation in the data from other sites and sources. For more information regarding COVID-19, see the WHO's [COVID-19 Q\u0026A](https://www.who.int/news-room/q-a-detail/coronavirus-disease-covid-19) page.\n\n[![Buy me a coffee](https://img.shields.io/static/v1?label=Buy%20me%20a\u0026message=coffee\u0026color=important\u0026style=flat\u0026logo=buy-me-a-coffee\u0026logoColor=white)](https://www.buymeacoffee.com/stevenjdh)\n\nReleases: [https://github.com/StevenJDH/covid-tracker/releases](https://github.com/StevenJDH/covid-tracker/releases)\n\n## Features\n* Global COVID-19 statistics provided by Johns Hopkins University CSSE.\n* Total infected cases along with total new infections since previous day.\n* Dynamic filtering of geographic data.\n* Scheduled cache control of source data.\n\n## Prerequisites\n* [Docker](https://www.docker.com/products/docker-desktop)/[Rancher](https://rancherdesktop.io) Desktop or Kubernetes for running the container.\n* Optional: Java 17+ ([Temurin/Adopt](https://adoptium.net)) OpenJDK for compiling.\n* Optional: [Maven](https://maven.apache.org) 3.8.4+ CLI for compiling.\n\n## Container registries\nCOVID-19 Tracker container images are currently hosted on the following platforms:\n\n* [Docker Hub](https://hub.docker.com/r/stevenjdh/covid-tracker)\n* [Amazon Elastic Container Registry (ECR)](https://gallery.ecr.aws/stevenjdh/covid-tracker)\n* [GitHub Container Registry](https://github.com/users/StevenJDH/packages/container/package/covid-tracker)\n\nFor production use cases, it is not recommended to pull an image with the `:latest` tag, or no tag since these are equivalent.\n\n## Helm chart\nCOVID-19 Tracker can be optionally deployed to a Kubernetes cluster using the [COVID-19 Tracker Helm Chart](https://github.com/StevenJDH/helm-charts/tree/main/charts/covid-tracker) that is managed in a separate repository. All of the features described below and more are supported by this chart.\n\n## Usage\nTo run the application locally, or access it without an Ingress resource, use one of the following approaches below.\n\n**Docker/Rancher Desktop:**\n\n```bash\ndocker run --name covid-tracker -p 127.0.0.1:80:8080/tcp -d stevenjdh/covid-tracker:latest\n# OR\nnerdctl run --name covid-tracker -p 127.0.0.1:80:8080/tcp -d stevenjdh/covid-tracker:latest\n```\n\n**Kubernetes:**\n\n```bash\nkubectl run covid-tracker --image=stevenjdh/covid-tracker:latest --port 8080\nkubectl expose po covid-tracker --port 80 --target-port=8080 --name=covid-tracker\nkubectl port-forward svc/covid-tracker 80:80\n```\n\nOnce the application is running, the UI can be accessed via http://localhost.\n\n## Endpoints\nBelow are the URL references used in the app.\n\n```text\nGET :8080/\nGET :8081/actuator/info\nGET :8081/actuator/health\nGET :8081/actuator/health/liveness\nGET :8081/actuator/health/readiness\n```\n\n## Schedule for cached statistics\nCached statistics expire every 6 hours by default in UTC time, but it can be overridden using the `SPRING_CRON_SCHEDULE` environment variable. The cron syntax used by Spring is different, so use [CronMaker](http://www.cronmaker.com) to generate the desired schedule. Take the result, and remove the last argument to make it valid. For example, `0 0 0/1 1/1 * ? *` is edited to become `0 0 0/1 1/1 * ?` for use in Spring.\n\n## Disclaimer\nCOVID-19 Tracker is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.\n\n## Contributing\nThanks for your interest in contributing! There are many ways to contribute to this project. Get started [here](https://github.com/StevenJDH/.github/blob/main/docs/CONTRIBUTING.md).\n\n## Do you have any questions?\nMany commonly asked questions are answered in the FAQ:\n[https://github.com/StevenJDH/covid-tracker/wiki/FAQ](https://github.com/StevenJDH/covid-tracker/wiki/FAQ)\n\n## Want to show your support?\n\n|Method          | Address                                                                                   |\n|---------------:|:------------------------------------------------------------------------------------------|\n|PayPal:         | [https://www.paypal.me/stevenjdh](https://www.paypal.me/stevenjdh \"Steven's Paypal Page\") |\n|Cryptocurrency: | [Supported options](https://github.com/StevenJDH/StevenJDH/wiki/Donate-Cryptocurrency)    |\n\n\n// Steven Jenkins De Haro (\"StevenJDH\" on GitHub)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstevenjdh%2Fcovid-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstevenjdh%2Fcovid-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstevenjdh%2Fcovid-tracker/lists"}