cloudfoundry / bosh-io-releases

List of releases tracked by bosh.io
Apache License 2.0
3 stars 55 forks source link

releases

List of releases tracked by https://bosh.io.

PR changes to index.yml to submit additional releases for review.

Checklist for submission:

FAQ

How do I get a new release on bosh.io/releases?

First, make sure you can create a final BOSH release. Note that this is different than making a dev release. See docs on bosh.io for more info.

Next, Submit a PR to add your release to index.yml.

Without specifying a min_version, bosh-io will pick up every release version, including old and possibly broken releases. If you only want releases after a specific version, add a min_version to the release configuration in index.yml.

How does bosh.io find my release?

bosh.io does not pay attention to GitHub releases. It watches the releases directory within your GitHub repository on the default branch, which contains the metadata for final releases. See the cloudfoundry/bosh releases directory. Note that the releases directory is automatically updated when creating a final release, you should not need to manually update releases.

What is the .final_builds directory, do I need it?

Yes, you need it. Creating a final release will update both the releases directory and the .final_builds directory. The releases directory contains metadata about what goes into the release for each version. The .final_builds directory has references to blobs for all the assets associated with a release: job templates, packaging scripts, etc. Without the .final_builds directory, your release will not be added to bosh.io. Make sure to commit .final_builds to Github.

Why isn't the latest version of my release on bosh.io/releases?

Check the default branch of your GitHub repository and make sure the release is listed in the releases directory. Without that file, bosh.io won't be able to import the release.

Make sure you cut a final release, not a dev release.

Ensure that running bosh create-release releases/<release-name>-<version>.yml from your github repo succeeds.

If everything is working in your release, it is possible there has been an internal Concourse failure. Reach out to the BOSH team on slack or github to check the Concourse builds.

I accidentally cut a bad release, how do I get it removed from bosh.io/releases?

Generally, existing releases listed on bosh.io will not be removed. If you'd like to discourage use of an existing release, cut a new release with a higher minor version. In extreme cases, feel free to reach out to the BOSH team.

Additional Documentation