bosh-stemcell 1.2801.0 → 1.2807.0

data/README.md

@@ -2,9 +2,9 @@
 
 Tools for creating stemcells
 
-## Building a stemcell
+## Bringing up stemcell building VM
 
-#### Once-off manual steps:
+### Once-off manual steps:
 
 0. Upload a keypair called "bosh" to AWS that you'll use to connect to the remote vm later
 0. Create "bosh-stemcell" security group on AWS to allow SSH access to the stemcell (once per AWS account)
@@ -15,7 +15,7 @@ Tools for creating stemcells
         vagrant plugin install vagrant-omnibus
         vagrant plugin install vagrant-aws --plugin-version 0.5.0
 
-#### Bring up the vagrant stemcell building VM
+### Bring up the vagrant stemcell building VM
 
 From a fresh copy of the bosh repo:
 
@@ -23,96 +23,55 @@ From a fresh copy of the bosh repo:
     export BOSH_AWS_SECRET_ACCESS_KEY=YOUR-AWS-SECRET-KEY
     cd bosh-stemcell
     vagrant up remote --provider=aws
+    
+## Updating source code on stemcell building VM
 
-#### Build the stemcell from inside the VM
-
-Substitute *\<current_build\>* with the current build number, which can be found by looking at [bosh artifacts](http://bosh_artifacts.cfapps.io).
-The final two arguments are the S3 bucket and key for the OS image to use, which can be found by reading the OS\_IMAGES document in this project.
-
-    vagrant ssh -c '
-      cd /bosh
-      CANDIDATE_BUILD_NUMBER=<current_build> http_proxy=http://localhost:3142/ bundle exec rake stemcell:build[vsphere,esxi,centos,nil,go,bosh-os-images,bosh-centos-6_5-os-image.tgz]
-    ' remote
-
-# Run the stemcell locally with Fusion
-
-VMware Fusion is the preferred local virtual environment.  You can [purchase it here](http://www.vmware.com/products/fusion/).  Once you have Fusion installed:
-
-* Unpack the stemcell tarball.
-* Rename the new `image` file to `image.tgz` and untar that as well.  You should now have an `image.ovf` file.
-* Start VMware Fusion and import this file (**File** -> **Import**)
-* Save the imported OVF as `image.vmwarevm` in the `tmp` folder.
-* You should see a new VM in your VM library.
-* Double click that new VM and it should be booted.
-
-## Add the NIC
-
-Before starting the VM in VirtualBox:
-
-1. Add a network interface (**Virtual Machine** > **Settings** > **Add Device...** > **Network Adapter**)
-1. Select NAT networking (the default)
-
-# Run the stemcell locally with VirtualBox
-
-## Import the VM
-
-- The stemcell is dropped into `bosh/tmp/bosh-stemcell-???-vsphere-esxi-centos.tgz`.
-- Untar that file.  You now have a file named `image`.
-- Rename that to `image.tgz`, and untar *that* file.  You now have a file named `image.ovf`.
-- Double click on that file to open it in VirtualBox.
-
-## Add the NIC
-
-Before starting the VM in VirtualBox:
-
-1. Add a network interface (**Settings** > **Network** > **Adapter 1** > **Enable**)
-1. Select NAT networking (the default)
-1. Click on advanced
-1. Click on Port Forwarding and enable the following rule:
-    * Name: SSH
-    * Protocol: TCP
-    * Host IP: 127.0.0.1
-    * Host Port: 3333
-    * Guest IP: blank
-    * Guest Port: 22
+With existing stemcell building VM run:
 
-# Boot the VM
-
-Save the configuration and boot the VM.  Once you're booted, login as `root`/`c1oudc0w`.
-
-## Configure network locally
+    export BOSH_AWS_ACCESS_KEY_ID=YOUR-AWS-ACCESS-KEY
+    export BOSH_AWS_SECRET_ACCESS_KEY=YOUR-AWS-SECRET-KEY
+    cd bosh-stemcell
+    vagrant provision remote --provider=aws
 
-### Fusion
 
-```bash
-$ grep subnet /Library/Preferences/VMware\ Fusion/*/dhcpd.conf
-/Library/Preferences/VMware Fusion/vmnet1/dhcpd.conf:subnet 172.16.0.0 netmask 255.255.255.0 {
-/Library/Preferences/VMware Fusion/vmnet8/dhcpd.conf:subnet 172.16.210.0 netmask 255.255.255.0 {
-```
+## Build an OS image
 
-```bash
-ifconfig eth0 172.16.210.30/24 up
-route add default gw 172.16.210.2 eth0
-```
+If you have changes that will require new OS image you need to build one. A stemcell with a custom OS image can be built using the stemcell-building VM created earlier.
 
-### VirtualBox
+    vagrant ssh -c '
+      cd /bosh
+      bundle exec rake stemcell:build_os_image[ubuntu,trusty,/tmp/ubuntu_base_image.tgz]
+    ' remote
+    
+See below [Building the stemcell with local OS image](#building-the-stemcell-with-local-os-image) on how to build stemcell with the new OS image.
 
-You'll want to pick an IP that's not in use by your stemcell building vm. 10.0.2.30 *should* be fine.
+## Building a stemcell
 
-```bash
-ifconfig eth0 10.0.2.30/24 up
-route add default gw 10.0.2.2 eth0
-```
+### Building the stemcell with published OS image
 
-Test the network with `ping 8.8.8.8`
+Substitute *\<current_build\>* with the current build number, which can be found by looking at [bosh artifacts](http://bosh_artifacts.cfapps.io).
+The final two arguments are the S3 bucket and key for the OS image to use, which can be found by reading the OS\_IMAGES document in this project.
 
-# Build an OS image
+    vagrant ssh -c '
+      cd /bosh
+      CANDIDATE_BUILD_NUMBER=<current_build> http_proxy=http://localhost:3142/ bundle exec rake stemcell:build[vsphere,esxi,centos,nil,go,bosh-os-images,bosh-centos-6_5-os-image.tgz]
+    ' remote
 
-A stemcell with a custom OS image can be built using the stemcell-building VM created earlier.
+    
+### Building the stemcell with local OS image
 
     vagrant ssh -c '
       cd /bosh
-      bundle exec rake stemcell:build_os_image[ubuntu,trusty,/tmp/ubuntu_base_image.tgz]
       bundle exec rake stemcell:build_with_local_os_image[aws,xen,ubuntu,trusty,go,/tmp/ubuntu_base_image.tgz]
     ' remote
+    
+### Building light stemcell
+
+AWS stemcells can be shipped in light format which includes a reference to a public AMI. This speeds up the process of uploading the stemcell to AWS. To build a light stemcell:
 
+    vagrant ssh -c '
+      cd /bosh
+      export BOSH_AWS_ACCESS_KEY_ID=YOUR-AWS-ACCESS-KEY
+      export BOSH_AWS_SECRET_ACCESS_KEY=YOUR-AWS-SECRET-KEY
+      bundle exec rake stemcell:build_light[/tmp/bosh-stemcell.tgz,hvm]
+    ' remote

data/lib/bosh/stemcell/version.rb

@@ -1,5 +1,5 @@
 module Bosh
   module Stemcell
-    VERSION = '1.2801.0'
+    VERSION = '1.2807.0'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bosh-stemcell
 version: !ruby/object:Gem::Version
-  version: 1.2801.0
+  version: 1.2807.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-12-24 00:00:00.000000000 Z
+date: 2014-12-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bosh_aws_cpi
@@ -18,7 +18,7 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 1.2801.0
+        version: 1.2807.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 1.2801.0
+        version: 1.2807.0
 - !ruby/object:Gem::Dependency
   name: fakefs
   requirement: !ruby/object:Gem::Requirement
@@ -187,7 +187,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 1158491856683510751
+      hash: -1513076373355622662
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.23