Merge lp:~facundo/tanuki-agent/tutorial-first-boot into lp:tanuki-agent

[Facundo Batista]

Added a section regarding first boot tests.

Added a section regarding first boot tests.

[Roberto Alsina (ralsina)]

review: Approve

=== modified file 'docs/tutorial-products.md'
--- docs/tutorial-products.md	2015-12-15 20:34:26 +0000
+++ docs/tutorial-products.md	2015-12-22 20:08:11 +0000
@@ -579,7 +579,7 @@
 
 If all went well, you should now see both versions 1 and 2 of test-snap listed. If you don't see version 2 listed under the Edge channel, try refreshing the page. 
 
-You now have an updated applicaiton snap published to the ```edge``` channel. 
+You now have an updated application snap published to the ```edge``` channel. 
 
 ## Running the Update Test
 
@@ -598,7 +598,7 @@
 
 ## Promote to Stable
 
-Assuming the test has passed and you are ready to release this version of the applicaiton to your customers, it is now time to Promote the package via the MyApps site:
+Assuming the test has passed and you are ready to release this version of the application to your customers, it is now time to Promote the package via the MyApps site:
 
 - visit: https://myapps.developer.ubuntu.com/dev/click-apps/?format=snap
 - click on the test-snap package name to get to the package details page
@@ -620,3 +620,25 @@
   </div>
 </div>
 
+
+## First-boot tests
+
+When you promote images, as said above, the system will generate new Gold Master candidate tests, creating Product Base Images that are the base for when testing Updates.
+
+Update tests will be created always using the latest Product Base Image, but if you release images you'll need the Update tests to also be created using those released images. This is handled automatically by the system, all you need is to mark the Product Base Image as released, and the Update tests will be generated using not only the latest Product Base Image, but also all those that were ever released (until you deactivate them).
+
+This way you can list all the Product Base Images for a given product.
+
+    ./api_example.py -X GET config.ini https://spi.canonical.com/products/$PRODUCT_ID/baseimages
+
+To mark any of those as released, just do:
+
+    ./api_example.py -X PUT config.ini https://spi.canonical.com/products/$PRODUCT_ID/baseimages/<baseimage_id> --data '{
+        "released": true
+    }'
+
+After this step, that Product Base Image will be used in the Update tests. The moment you decide that any Product Base Image shouldn't be used for Update tests, you can deactivate it, by doing:
+
+    ./api_example.py -X PUT config.ini https://spi.canonical.com/products/$PRODUCT_ID/baseimages/<baseimage_id> --data '{
+        "active": false
+    }'