{"id":34231572,"url":"https://github.com/binxio/fromage","last_synced_at":"2026-03-10T08:33:33.170Z","repository":{"id":57560915,"uuid":"324201588","full_name":"binxio/fromage","owner":"binxio","description":"list and update container references in Dockerfiles in a git repository","archived":false,"fork":false,"pushed_at":"2023-02-16T08:41:47.000Z","size":129,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":5,"default_branch":"main","last_synced_at":"2026-01-14T14:07:08.376Z","etag":null,"topics":["bump","dockerfile","semver"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/binxio.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":"2020-12-24T17:02:17.000Z","updated_at":"2024-07-29T10:49:19.000Z","dependencies_parsed_at":"2024-06-20T04:40:17.743Z","dependency_job_id":"fc38cc68-d4c1-4c51-be0f-bdf317488a8e","html_url":"https://github.com/binxio/fromage","commit_stats":null,"previous_names":["binxio/git-fromage"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/binxio/fromage","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/binxio%2Ffromage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/binxio%2Ffromage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/binxio%2Ffromage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/binxio%2Ffromage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/binxio","download_url":"https://codeload.github.com/binxio/fromage/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/binxio%2Ffromage/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30328251,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T05:25:20.737Z","status":"ssl_error","status_checked_at":"2026-03-10T05:25:17.430Z","response_time":106,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["bump","dockerfile","semver"],"created_at":"2025-12-16T01:17:14.877Z","updated_at":"2026-03-10T08:33:33.069Z","avatar_url":"https://github.com/binxio.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Name\n  fromage - list, checks and bump container references in Dockerfiles in git repositories\n\n# Usage\n\n```\n  fromage list  [--verbose] [--format=FORMAT] [--no-header] [--only-references]  [--branch=BRANCH ...] URL\n  fromage check [--verbose] [--format=FORMAT] [--no-header] [--only-references]  [--branch=BRANCH ...] [--pin=LEVEL] URL\n  fromage bump  [--verbose] [--dry-run] [--pin=LEVEL] [--latest] --branch=BRANCH URL\n  fromage move  [--verbose] [--dry-run] --from=FROM_REPOSITORY --to=TO_REPOSITORY --branch=BRANCH URL\n```\n\n# Options\n```\n--branch=BRANCH        to inspect, defaults to all branches.\n--format=FORMAT        to print: text, json or yaml [default: text].\n--no-header            do not print header if output type is text.\n--only-references      output only container image references.\n--pin=LEVEL            pins the MAJOR or MINOR version level\n--latest               bump to the latest version available\n--from=FROM_REPOSITORY from repository context\n--to=TO_REPOSITORY     to repository context\n\n```\n\n# Description\nfromage lists all container references in dockerfiles in your git repository and indicates whether there are\nnewer versions available. To show all container images references in Dockerfiles, type:\n\n```sh\n./fromage list --branch master --verbose https://github.com/binxio/kritis\nIMAGE                                   PATH                                            BRANCH  NEWER\ngolang:1.12                             helm-hooks/Dockerfile                           master  1.13,1.14,1.15\ngcr.io/gcp-runtimes/ubuntu_16_0_4       helm-release/Dockerfile                         master  \nubuntu:trusty                           vendor/golang.org/x/net/http2/Dockerfile        master  \ngolang:1.12                             deploy/Dockerfile                               master  1.13,1.14,1.15\ngcr.io/distroless/base:latest           deploy/Dockerfile                               master  \ngcr.io/google-appengine/debian10:latest deploy/gcr-kritis-signer/Dockerfile             master  \ngcr.io/gcp-runtimes/ubuntu_16_0_4       deploy/kritis-int-test/Dockerfile               master  \ngcr.io/google-appengine/debian10:latest deploy/kritis-signer/Dockerfile                 master  \n```\n\nThe columns show the container reference, the filename and branch in which it was found and available newer\nversions.\n\n## checking out-of-date references\nto check whether there are newer references available, type:  \n```sh\n./fromage check --branch master --verbose https://github.com/binxio/kritis\nIMAGE                                   PATH                                            BRANCH  NEWER\ngolang:1.12                             helm-hooks/Dockerfile                           master  1.13,1.14,1.15\ngolang:1.12                             deploy/Dockerfile                               master  1.13,1.14,1.15\nexit code 1\n```\nThis will only list the references which are out of date. If found, it exits with code 1.\n\n\n## bumping container references\nTo bump the references to the next level, type:\n\n```\n./fromage bump --branch master --verbose git@github.com:binxio/kritis.git\n2021/01/21 21:05:42 INFO: updating reference golang:1.12 to golang:1.13 in helm-hooks/Dockerfile\n2021/01/21 21:05:42 INFO: updating reference golang:1.12 to golang:1.13 in helm-hooks/Dockerfile\n2021/01/21 21:05:46 INFO: updating reference golang:1.12 to golang:1.13 in deploy/Dockerfile\n2021/01/21 21:05:46 INFO: changes committed with 67847a0\n2021/01/21 21:05:46 INFO: pushing changes to git@github.com:binxio/kritis.git\n``` \n\nAs you can see from the available versions, this process can be repeated until golang is at \nthe highest level.\n\nThe bump will commit the changes to the repository. If it is a \nremote repository reference, the change will also be pushed.\n\nRead more at [How to keep your Dockerfile container image references up-to-date](https://binx.io/blog/2021/01/30/how-to-keep-your-dockerfile-container-image-references-up-to-date/)\n\n## moving container registry\n\nIf you need to move your container registry images from for instance docker hub to AWS Public ECR registry, type:\n\n```\n$ fromage move --verbose --from index.docker.io/library --to public.aws.ecr/docker/library --branch master git@github.com:binxio/kritis.git\n2023/02/15 16:02:43 INFO: updating reference ubuntu:trusty to public.aws.ecr/docker/library/ubuntu:trusty in vendor/golang.org/x/net/http2/Dockerfile\n2023/02/15 16:02:43 INFO: updating reference golang:1.13 to public.aws.ecr/docker/library/golang:1.13 in deploy/Dockerfile\n2023/02/15 16:02:43 INFO: updating reference golang:1.13 to public.aws.ecr/docker/library/golang:1.13 in helm-hooks/Dockerfile\n2023/02/15 16:02:43 INFO: updating reference golang:1.13 to public.aws.ecr/docker/library/golang:1.13 in helm-hooks/Dockerfile\n2023/02/15 16:02:43 INFO: moved references from index.docker.io/library to public.aws.ecr/docker/library\n2023/02/15 16:02:43 INFO: changes committed with 1234ef\n2023/02/15 16:02:43 INFO: pushing changes to git@github.com:binxio/kritis.git\n``` \n\n# Caveats\n- The bump will update all container references it finds in all files\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbinxio%2Ffromage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbinxio%2Ffromage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbinxio%2Ffromage/lists"}