Add a Published version API

[iwahbe]

This is a very simple API, just allowing other repositories to get the latest version of a provider. The API is listed as v0, marking it as experimental and without backwards comparability guarantees. I don't expect this API to survive the IA transition the registry will undergo.

[github-actions]

Your site preview for commit 5fbdd87 is ready! 🎉

http://registry--origin-pr-5995-5fbdd870.s3-website.us-west-2.amazonaws.com/registry.

[github-actions]

Your site preview for commit 62af648 is ready! 🎉

http://registry--origin-pr-5995-62af6487.s3-website.us-west-2.amazonaws.com/registry.

[guineveresaenger]

I'm not sure I entirely understand the use case.

Is there a reason we wouldn't be able to query the version found in themes/default/data/registry/packages/<provider>.yaml ?

[iwahbe]

I'm not sure I entirely understand the use case.

The use case is a into-registry pipeline being able to check what version a provider is currently at, to determine if an update should be sent to the registry.

Is there a reason we wouldn't be able to query the version found in themes/default/data/registry/packages/<provider>.yaml ?

AFAIK Hugo doesn't present the data folder in the generated site.

[github-actions]

Your site preview for commit 0b6e74a is ready! 🎉

http://registry--origin-pr-5995-0b6e74a8.s3-website.us-west-2.amazonaws.com/registry.

[guineveresaenger]

Sure, but why would we need to query an endpoint on the generated site? Couldn't we query this repo? I suppose I'm not sure how sophisticated this pipeline needs to be, but it's been my impression that these files are absolutely meant to be used for version update reconciliation.

[iwahbe]

Sure, but why would we need to query an endpoint on the generated site? Couldn't we query this repo? I suppose I'm not sure how sophisticated this pipeline needs to be, but it's been my impression that these files are absolutely meant to be used for version update reconciliation.

I'm trying to move to a model where the registry presents an API distinct from it's implementation details. If we want to move our metadata files from themes/default/data/registry/packages/ to data/registry/packages/ (where they should be) or change the way they are represented, I don't want that to break other systems. Likewise, if the registry decides to remove the experimental API, then I want to be able to do so without changing the layout of the repo.

[iwahbe]

I revisited this, moving the entire API into Hugo instead of resourcedocsgen.

[github-actions]

Your site preview for commit 443ace0 is ready! 🎉

http://registry--origin-pr-5995-443ace02.s3-website.us-west-2.amazonaws.com/registry.

[iwahbe]

Your site preview for commit 443ace0 is ready! 🎉

http://registry--origin-pr-5995-443ace02.s3-website.us-west-2.amazonaws.com/registry.

To "use" the API, you would run

$ curl http://registry--origin-pr-5995-443ace02.s3-website.us-west-2.amazonaws.com/registry/api/v0/packages/azure/version
{"version":"v6.9.0"}

[github-actions]

Your site preview for commit 305e770 is ready! 🎉

http://registry--origin-pr-5995-305e7708.s3-website.us-west-2.amazonaws.com/registry.

[guineveresaenger]

Discussed offline and LGTM.

Thank you for the smaller change as well.

[github-actions]

Site previews for this pull request have been removed. ✨