25 lines
1021 B
Plaintext
25 lines
1021 B
Plaintext
---
|
|
layout: vagrant-cloud
|
|
page_title: API Release Workflow
|
|
description: "Automate box creation with the Vagrant Cloud API."
|
|
---
|
|
|
|
# API Release Workflow
|
|
|
|
Creating new boxes through their [release lifecycle](/vagrant/vagrant-cloud/boxes/lifecycle)
|
|
is possible through the Vagrant Cloud website, but you can also automate
|
|
the task via the Vagrant Cloud API.
|
|
|
|
1. Create box, or locate a boxes `tag`, like `hashicorp/bionic64`
|
|
2. After some event, like the end of a CI build, you may want to
|
|
release a new version of the box. To do this, first use the API to
|
|
create a new version with a version number and a short description
|
|
of the changes
|
|
3. Then, create any providers associated with the version, like
|
|
`virtualbox`
|
|
4. Once your system has made the necessary requests to the API and the
|
|
version is ready, make a request to the `release` endpoint on the version
|
|
5. The version should now be available to users of the box via
|
|
the command `vagrant box outdated` or via the automated checks on
|
|
`vagrant up`
|