docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #562 from classmarkets/machine-gce-image-family 

machine/gce: explain how to use image families
This commit is contained in:
John Mulhausen 2016-11-14 17:06:38 -08:00 committed by GitHub
parent 53d8efdfcf 5bde9b0fde
commit 6ec5958447
1 changed files with 16 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
machine/drivers/gce.md
View File

@ -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 `<PROJECT>` and `<FAMILY>` in the following template.
https://www.googleapis.com/compute/v1/projects/<PROJECT>/global/images/family/<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` | - |
| `--google-use-existing` | `GOOGLE_USE_EXISTING` | - |