Note: Applies to CLI v2.
(See What is a Stemcell? for an introduction to stemcells.)
As described earlier, each resource pool references a specific stemcell on the Director. Before the Director can form a deployment, all referenced stemcells must be uploaded to the Director.
The stemcells section of bosh.io lists official stemcells.
Assuming the CLI is already targeted at the Director, the CLI provides a single command to upload a stemcell.
If you have a URL to a stemcell tarball (for example URL provided by bosh.io):
$ bosh upload-stemcell URL --sha1 SHA1
If you have a stemcell tarball on your local machine:
$ bosh upload-stemcell ~/Downloads/bosh-stemcell-3421.4-warden-boshlite-ubuntu-trusty-go_agent.tgz
Once the command succeeds you can view all uploaded stemcells in the Director:
$ bosh -e vbox stemcells Using environment '192.168.50.6' as client 'admin' Name Version OS CPI CID bosh-warden-boshlite-ubuntu-trusty-go_agent 3421.4* ubuntu-trusty - 6c9c002e-bb46-4838-4b73-ff1afaa0aa21 (*) Currently deployed 1 stemcells Succeeded
To use uploaded stemcell in your deployment, add stemcells:
stemcells: - alias: default os: ubuntu-trusty version: 3421.4
Next: Uploading Releases
Previous: Deployment Basics