{"id":18564348,"url":"https://github.com/heyman/http-warmup","last_synced_at":"2025-06-11T04:14:14.828Z","repository":{"id":66681147,"uuid":"496246479","full_name":"heyman/http-warmup","owner":"heyman","description":"Python script \u0026 Docker image that waits for an HTTP server to come online and optionally warms it up with a specified number of requests","archived":false,"fork":false,"pushed_at":"2022-05-25T18:51:50.000Z","size":6,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-15T18:47:20.661Z","etag":null,"topics":["devops","docker","http"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/heyman.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null}},"created_at":"2022-05-25T13:38:03.000Z","updated_at":"2022-05-25T14:03:12.000Z","dependencies_parsed_at":"2023-03-11T00:13:29.877Z","dependency_job_id":null,"html_url":"https://github.com/heyman/http-warmup","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heyman%2Fhttp-warmup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heyman%2Fhttp-warmup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heyman%2Fhttp-warmup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heyman%2Fhttp-warmup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/heyman","download_url":"https://codeload.github.com/heyman/http-warmup/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heyman%2Fhttp-warmup/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259198000,"owners_count":22820153,"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":["devops","docker","http"],"created_at":"2024-11-06T22:14:54.923Z","updated_at":"2025-06-11T04:14:14.819Z","avatar_url":"https://github.com/heyman.png","language":"Python","readme":"# http-warmup\n\nPython script / Docker image that waits for an HTTP server to come online and optionally \nwarms it up by sending some requests to it.\n\nThis can be used to warm up a web server before starting to redirect real HTTP requests from \nusers, when doing zero downtime deployments.\n\n## Usage\n\n**Wait for a host to reply with an HTTP 2xx response:**\n\n```\ndocker run --rm -it heyman/http-warmup https://example.org\n```\n\n**Send 20 warm-up requests using three threads once the server has come alive:**\n\n```\ndocker run --rm -it heyman/http-warmup --warmup-requests=20 --warmup-threads=3 https://example.org\n```\n\n**Set the max time that we should wait for the server to come alive to 5 minutes**:\n\n```\ndocker run --rm -it heyman/http-warmup --timeout=300 https://example.org\n```\n\n## Options\n\n```\nUsage: warmup.py [OPTIONS] URLS...\n\n  At least one URL must be specified. The first URL is pinged until it returns\n  a 2xx HTTP response.\n\n  If --warmup-requests is used the URLs will be round robin picked from all\n  specified URLS\n\nOptions:\n  --timeout INTEGER          Number of seconds to wait for the host to come\n                             online. Default: 60\n  --warmup-requests INTEGER  Number of warm-up requests to send. Default: 0\n  --warmup-threads INTEGER   Number of threads used to send the warm-up\n                             requests. Default: 1\n  --request-timeout INTEGER  Request timeout for individual HTTP requests.\n                             Default: 5\n  --hostname TEXT            Overrides the `Hostname` HTTP request header if\n                             specified\n  -v, --verbose\n  --help                     Show this message and exit.\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheyman%2Fhttp-warmup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fheyman%2Fhttp-warmup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheyman%2Fhttp-warmup/lists"}