Add notes detailing the relationship between the GCE images and the cloud team.
|Deletions are marked like this.||Additions are marked like this.|
|Line 3:||Line 3:|
Debian images available on GCE are not published by Debian and are considered derivatives from Debian's perspective. In particular, they enable third-party apt sources and install software in the default image that is not part of Debian. If you are interested in enabling Debian to publish working images to GCE in the future, please contact the [[Teams/Cloud|cloud team]].
Debian images available on GCE are not published by Debian and are considered derivatives from Debian's perspective. In particular, they enable third-party apt sources and install software in the default image that is not part of Debian. If you are interested in enabling Debian to publish working images to GCE in the future, please contact the cloud team.
Cloud/GoogleComputeEngine Image lists for Google Compute Engine
Google Compute Engine Documentation
Google Compute Engine documentation: https://cloud.google.com/compute/docs/
Google Cloud SDK (gcloud CLI) Documentation https://cloud.google.com/sdk/
Google Compute Engine Debian 10 Buster images are built with fai from the official Debian cloud image project https://salsa.debian.org/cloud-team/debian-cloud-images.
Google Compute Engine Debian 9 Stretch images are built with bootstrap-vz. All the configuration and manifest data is provided open source as part of that project https://github.com/andsens/bootstrap-vz/tree/master/manifests/official/gce.
Debian community members are welcome to help improve and maintain the images in Google Compute Engine. Issues can be filed in the compute-image-packages Github project https://github.com/GoogleCloudPlatform/compute-image-packages/issues.
More details about what is configured or added is maintained in the Google Compute Engine Images documentation https://cloud.google.com/compute/docs/images.
For discussion about Debian on various cloud providers, please visit the debian-cloud mailing list.
SSH user accounts
SSH in Google Compute Engine is provided using user provided SSH keys. There is not a default account or password configured in GCE images. For more information on how to SSH into GCE Debian instances, refer to the Google Compute Engine SSH documentation: https://cloud.google.com/compute/docs/instances/connecting-to-instance
The software to facilitate SSH key based login via metadata is provided in the base images and is open source licensed under the Apache License 2.0 https://github.com/GoogleCloudPlatform/compute-image-packages.
Listing Current Images
To list the currently-recommended, newest versions of Debian images on Google Compute Engine, use the Google Cloud SDK command line tool gcloud https://cloud.google.com/compute/docs/gcloud-compute/:
gcloud compute images list --project=debian-cloud --no-standard-images
Using An Image
To use the most up to date Debian 10 Buster image, use the "debian-10" image family when creating a new instance.
gcloud compute instances create "<instance-name>" --image-project debian-cloud --image-family debian-10 --zone="<zone>"
To use the most up to date Debian 9 Stretch image, use the "debian-9" image family when creating a new instance.
gcloud compute instances create "<instance-name>" --image-project debian-cloud --image-family debian-9 --zone="<zone>"
Listing Older and Deprecated Images
As Google Compute Engine releases new images, older images will be deprecated and eventually removed. When this happens, Google Compute Engine sets the deprecation status on an image.
gcloud compute images list --project=debian-cloud --no-standard-images --show-deprecated
Building a Google Compute Engine Image
To build a Debian image for Google Compute Engine, use the tools and configurations from the open source Google provided tools which wrap the fai build https://github.com/GoogleCloudPlatform/compute-image-tools/tree/master/daisy_workflows/image_build/debian or the Debian cloud images build tools directly https://salsa.debian.org/cloud-team/debian-cloud-images.
If you have any questions, concerns, or general feedback, please don’t hesitate to contact the Google Compute team (email@example.com) or open an issue in the compute-image-packages Github project https://github.com/GoogleCloudPlatform/compute-image-packages/issues.
Google Compute Engine Debian Experiments Project
A project, "debian-cloud-experiments", for Debian is available with limited quota for Debian Developers to experiment with the platform. Please let us know if you would like access to experiment in this project.