Note: Document uses CLI v2.

(See What is a Stemcell? for an introduction to stemcells.)

As described earlier, each deployment can reference one or more stemcells. For a deploy to succeed, necessary stemcells must be uploaded to the Director.

Finding Stemcells

The stemcells section of bosh.io lists official stemcells.


Uploading to the Director

CLI provides bosh upload-stemcell command.

  • If you have a URL to a stemcell tarball (for example URL provided by bosh.io):

    $ bosh -e vbox upload-stemcell https://bosh.io/d/stemcells/bosh-warden-boshlite-ubuntu-trusty-go_agent?v=3421.9 --sha1 1396d7877204e630b9e77ae680f492d26607461d
    
  • If you have a stemcell tarball on your local machine:

    $ bosh upload-stemcell ~/Downloads/bosh-stemcell-3421.9-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.9*  ubuntu-trusty  -    6c9c002e-bb46-4838-4b73-ff1afaa0aa21

(*) Currently deployed

1 stemcells

Succeeded

Deployment Manifest Usage

To use uploaded stemcell in your deployment, add stemcells:

stemcells:
- alias: default
  os: ubuntu-trusty
  version: 3421.4

Next: Upload Releases

Previous: Build Deployment Manifest


Contribute changes to this page