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` | - |