Skip to content

Move registries.conf files to v2 format #6801

Merged
mtrmac merged 3 commits intocontainers:mainfrom
Luap99:registries-v2
Apr 23, 2026
Merged

Move registries.conf files to v2 format #6801
mtrmac merged 3 commits intocontainers:mainfrom
Luap99:registries-v2

Conversation

@Luap99
Copy link
Copy Markdown
Member

@Luap99 Luap99 commented Apr 21, 2026

What type of PR is this?

/kind api-change
/kind bug
/kind cleanup
/kind deprecation
/kind design
/kind documentation
/kind failing-test
/kind feature
/kind flake
/kind other

What this PR does / why we need it:

the v1 format support is being dropped so we must use the v2 format going forward. Since this does not need the vendor as part of the same PR we might as well merge this now so the vendoring for others is easier.

How to verify it

#6799

Which issue(s) this PR fixes:

Special notes for your reviewer:

Does this PR introduce a user-facing change?

None

@dosubot dosubot Bot added the size:XS This PR changes 0-9 lines, ignoring generated files. label Apr 21, 2026
Copy link
Copy Markdown
Member

@nalind nalind left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@nalind
Copy link
Copy Markdown
Member

nalind commented Apr 22, 2026

@containers/buildah-maintainers PTAL

Copy link
Copy Markdown
Contributor

@mtrmac mtrmac left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ACK to the conversions. It’s not clear to me that removing the test-global registries.conf does not change semantics, but tests are passing and I can’t see any indication that this was added for any specific test.

Non-blocking: also documentation in docs/samples/registries.conf, install.md and troubleshooting.md. Feel free to merge as is, or update those and merge.

@Luap99
Copy link
Copy Markdown
Member Author

Luap99 commented Apr 22, 2026

ACK to the conversions. It’s not clear to me that removing the test-global registries.conf does not change semantics, but tests are passing and I can’t see any indication that this was added for any specific test.

If any test actually depend on the custom global file in /etc/ they would have been already broken IMO. These tests should work locally, in podman CI, and all kinds of package gating envs, fedora, RHEL, debian...

@dosubot dosubot Bot added size:L This PR changes 100-499 lines, ignoring generated files. and removed size:XS This PR changes 0-9 lines, ignoring generated files. labels Apr 22, 2026
@Luap99
Copy link
Copy Markdown
Member Author

Luap99 commented Apr 22, 2026

updated the docs as well

Comment thread install.md Outdated
### [registries.conf](https://github.com/containers/container-libs/blob/main/image/registries.conf)

#### Man Page: [registries.conf.5](https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md)
#### Man Page: [containers-registries.conf.5](https://github.com/container-libs/blob/main/image/blob/main/docs/containers-registries.conf.5.md)
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

https://github.com/containers/container-libs/blob/main/image/docs/containers-registries.conf.5.md

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks not sure how I managed to screw this up

Comment thread troubleshooting.md Outdated

* Verify that the `/etc/containers/registries.conf` file exists. If not, verify that the containers-common package is installed.
* Verify that the entries in the `[registries.search]` section of the /etc/containers/registries file are valid and reachable.
* Verify that a `registries.conf` file exists, see [containers-registries.conf(5)](https://github.com/container-libs/blob/main/image/blob/main/docs/containers-registries.conf.5.md). If not, verify that the containers-common package is installed.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

https://github.com/containers/container-libs/blob/main/image/docs/containers-registries.conf.5.md

Comment thread install.md Outdated
# # location = "internal-registry-for-example.net/bar"
# # requests for the image example.com/foo/myimage:latest will actually work with the
# # internal-registry-for-example.net/bar/myimage:latest image.
# location = internal-registry-for-example.com/bar"
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
# location = internal-registry-for-example.com/bar"
# location = "internal-registry-for-example.com/bar"

is wrong in the container-libs version as well.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

containers/container-libs#782 is the other fix.

@mtrmac
Copy link
Copy Markdown
Contributor

mtrmac commented Apr 22, 2026

(Merge without another review round.)

@TomSweeneyRedHat
Copy link
Copy Markdown
Member

LGTM once @mtrmac 's changes are incorporated, especially the links.

Luap99 added 3 commits April 23, 2026 12:43
All the tests use their own registries.conf from tests/registries.conf
so there is no need to overwrite the global config on the CI system.

Signed-off-by: Paul Holzinger <pholzing@redhat.com>
The v1 format is no longer accepted.

Signed-off-by: Paul Holzinger <pholzing@redhat.com>
Remove the old sample file from the repo and just like to main upstream
one from the container-libs repo. We also already have the fedora
example in the install.md files just below so no need for two files.
Update the fedora file to the latest content to ensure it is using v2
syntax. Lastly, update the troubleshooting.md as well with the v2
references and a link to the main docs as it can be set in many different
locations.

Signed-off-by: Paul Holzinger <pholzing@redhat.com>
@mtrmac mtrmac enabled auto-merge April 23, 2026 10:52
@mtrmac mtrmac merged commit 3529246 into containers:main Apr 23, 2026
40 checks passed
@Luap99 Luap99 deleted the registries-v2 branch April 23, 2026 13:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:L This PR changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants