{"id":23060103,"url":"https://github.com/meck93/distroless-http-healthcheck","last_synced_at":"2025-04-03T07:15:15.174Z","repository":{"id":268157728,"uuid":"903452105","full_name":"meck93/distroless-http-healthcheck","owner":"meck93","description":"a small, statically linked http client for distroless container health checks","archived":false,"fork":false,"pushed_at":"2025-02-16T18:57:45.000Z","size":12,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-16T19:33:23.568Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/meck93.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}},"created_at":"2024-12-14T16:35:41.000Z","updated_at":"2025-02-16T18:52:43.000Z","dependencies_parsed_at":"2024-12-14T19:32:27.355Z","dependency_job_id":"14132b5c-509c-42b8-a7e7-da2cb7927d32","html_url":"https://github.com/meck93/distroless-http-healthcheck","commit_stats":null,"previous_names":["meck93/distroless-http-healthcheck"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meck93%2Fdistroless-http-healthcheck","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meck93%2Fdistroless-http-healthcheck/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meck93%2Fdistroless-http-healthcheck/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meck93%2Fdistroless-http-healthcheck/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/meck93","download_url":"https://codeload.github.com/meck93/distroless-http-healthcheck/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246952275,"owners_count":20859812,"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":[],"created_at":"2024-12-16T03:11:27.265Z","updated_at":"2025-04-03T07:15:15.154Z","avatar_url":"https://github.com/meck93.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# healthcheck\n\n[![release](https://github.com/meck93/distroless-http-healthcheck/actions/workflows/release.yml/badge.svg)](https://github.com/meck93/distroless-http-healthcheck/actions/workflows/release.yml)\n[![build](https://github.com/meck93/distroless-http-healthcheck/actions/workflows/build.yml/badge.svg)](https://github.com/meck93/distroless-http-healthcheck/actions/workflows/build.yml)\n\nA tiny HTTP client for distroless container health checks.\nIt sends a HTTP GET request to the URL passed as argument and exits with 0 if the request succeeds, or 1 if it the URL is invalid, unreachable, or the request fails.\nThe binary is self-contained (statically linked), so it can be easily copied into containers which require a healthcheck but don't have any other dependencies.\n\n## Binary Size\n\n| Binary        | Size   |\n| ------------- | ------ |\n| `curl`        | 6.1mb  |\n| `wget`        | 1.4mb  |\n| `healthcheck` | 0.54mb |\n\n## Installing `healthcheck`\n\nBinaries are provided for both `x86_64` and `arm64` architectures, both as Docker images and as direct download from the Github releases page.\n\n### Docker\n\nSince this binary is primarily meant to be used for Docker health checks, the easiest way to consume this binary is through Docker.\nThe binaries are published in the `ghcr.io/meck93/distroless-http-healthcheck` repository in scratch containers, and you can use the version tags or `latest`.\n\nSee below for an examplary usage in a Dockerfile.\n\n```dockerfile\nFROM ghcr.io/meck93/distroless-http-healthcheck:latest AS healthcheck\n\nFROM scratch AS runner\n\nCOPY --from=healthcheck /healthcheck /healthcheck\n\nHEALTHCHECK --interval=30s --timeout=30s --start-period=5s --retries=3 CMD [\"/healthcheck\", \"http://localhost:8080/healthz\"]\n\nCMD [\"/example\"]\n```\n\n### Github Releases (Direct Download)\n\nThe binary is available through Github Releases, and can be downloaded [here](https://github.com/meck93/distroless-http-healthcheck/releases).\n\n## Credits\n\nThis work is heavily inspired by the following project and blog post:\n\n- [cryptaliagy/httpget](https://github.com/cryptaliagy/httpget) - by [Natalia Maximo](https://github.com/cryptaliagy)\n- [Docker Health Checks on Distroless Containers with Rust](https://natalia.dev/blog/2023/03/docker-health-checks-on-distroless-containers-with-rust/) - by [Natalia Maximo](https://github.com/cryptaliagy)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmeck93%2Fdistroless-http-healthcheck","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmeck93%2Fdistroless-http-healthcheck","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmeck93%2Fdistroless-http-healthcheck/lists"}