From 5bde9b0fde155bbd3c5004b4adcc5324bee182ee Mon Sep 17 00:00:00 2001 From: Peter Schultz Date: Sun, 13 Nov 2016 17:54:28 +0100 Subject: [PATCH] machine/gce: explain how to use image families --- machine/drivers/gce.md | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/machine/drivers/gce.md b/machine/drivers/gce.md index 5e56d075cc..b0c0d9a5c1 100644 --- a/machine/drivers/gce.md +++ b/machine/drivers/gce.md @@ -52,6 +52,21 @@ list of image URLs run: gcloud compute images list --uri +Google Compute Engine supports [image families](https://cloud.google.com/compute/docs/images#image_families). +An image family is like an image alias that always points to the latest image in the family. To create an +instance from an image family, set `--google-machine-image` to the family's URL. + +The following command will show images and which family they belong to (if any): + + gcloud compute images list + +To obtain a family URL, replace `` and `` in the following template. + + https://www.googleapis.com/compute/v1/projects//global/images/family/ + +For example, to create an instance from the latest Ubuntu 16 LTS image, specify +`https://www.googleapis.com/compute/v1/projects/ubuntu-os-cloud/global/images/family/ubuntu-1604-lts`. + #### Environment variables and default values | CLI option | Environment variable | Default | @@ -68,4 +83,4 @@ list of image URLs run: | `--google-preemptible` | `GOOGLE_PREEMPTIBLE` | - | | `--google-tags` | `GOOGLE_TAGS` | - | | `--google-use-internal-ip` | `GOOGLE_USE_INTERNAL_IP` | - | -| `--google-use-existing` | `GOOGLE_USE_EXISTING` | - | \ No newline at end of file +| `--google-use-existing` | `GOOGLE_USE_EXISTING` | - |