How to download swagger API specs?

[lispyclouds]

Hello!

I maintain https://github.com/lispyclouds/contajners a well used tool to interface with Podman in the Clojure world. It is a fully data driven client meaning it allows users to directly call ops via the swagger yaml without much abstractions and as part of its releases it downloads these automatically.
It uses https://storage.googleapis.com/libpod-master-releases to download them and since v5.8.3 I've stopped seeing uploads to this. Also since v6.0.0 the docs linking seems to have changed and I'm not entirely sure where to look for it now as I keep track of all the versions til current.
I tried to take a look at issues, discussions and changelogs and might've missed something obvious and any help to locate the new links is much appreciated!

Thanks for Podman as always!

[Luap99]

Hi, that is correct we switched the locations. Previously we build and uploaded the swagger in a separate bucket on our gce account. But we recently had to chnage CI providers so we no longer use the GCE account so we had to make some changes.

The fact that the docs and swagger versions where maintained in two places was a bit awkward as we needed an additional version selector on read the docs and then manually maintain versions there which never really worked well.

As such I reworked the entire process and build the file as part of the readthedocs main build: #29017

In short the new path is: https://docs.podman.io/en/latest/_static/swagger.yaml

where latest == main branch and stable would be the last tag in the URL. Or well https://docs.podman.io/en/v6.0.0/_static/swagger.yaml where v6.0.0 is the tag. Since readthedocs only build the page going forward that location only works for 6.0.0 or newer.

I guess I must backport this change to v5.8 as well so we can upload the next 5.8.4 yaml there as well

[Luap99]

I saw I forgot to update our docs which still refer to the old location so I update that here #29039

[lispyclouds]

This is very helpful, thank you!

[lispyclouds]

@Luap99 one more quick ask, by any chance are the images that were being pushed to https://quay.io/repository/podman/stable?tab=tags moved somewhere else too?

[Luap99]

the location should stays the same but the entire CI over these has not been ported
https://github.com/podman-container-tools/image_build

Also note the build process always pulled packages from fedora stable, podman 6 will not be shipped in fedora stable until f45 releases which will be in fall so for unless the process changes there wont be a 6.0 image until then.