Differences between revisions 48 and 49
Revision 48 as of 2016-01-04 15:03:33
Size: 6397
Editor: ThomasKoch
Comment: jkaplowitz@google.com doesn't work at google anymore
Revision 49 as of 2016-07-27 20:58:17
Size: 3682
Editor: ?ZachMarano
Comment:
Deletions are marked like this. Additions are marked like this.
Line 5: Line 5:
Google Compute Engine home page, including documentation:
https://developers.google.com/compute/
Google Compute Engine documentation:
[[https://cloud.google.com/compute/docs/]]
Line 10: Line 10:
These images result from a collaboration between Debian and Google. Debian community members are welcome to help improve and maintain the images in Google Compute Engine. This includes directly uploading the Debian images which Google publicizes to Google Compute Engine customers. Google Compute Engine Debian 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]].
Line 12: Line 12:
The images deviate in these ways from official Debian images:
 * Certain non-Debian software is installed to facilitate integration, all freely licensed under the Apache License 2.0:
  * DEBs: `google-startup-scripts`, `google-compute-daemon`, and `image-bundle` (mostly or completely replaceable with cloud-init if someone does the work)
  * Unpackaged command-line utilities installed in /usr/local/share/google and symlinked into /usr/local/bin: `bq`, `gcloud`, `gcutil`, and `gsutil` (optimal packaging situation TBD)
  * The google-startup-scripts deb manages user accounts by default - see below.
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]].
Line 18: Line 14:
Google is interested in working with Debian to make the images even more standard and achieve official Debian image status. In the meantime, Debian has indicated that it's okay to label these images as Debian instead of Debian-based. The images deviate from official Debian images in order to make Debian work correctly on the platform and provide a baseline user experience. Details about what is configured or added is maintained in the Google Compute Engine Images documentation [[https://cloud.google.com/compute/docs/images]].
Line 23: Line 19:
One intentional difference from Debian's Amazon EC2 images is that, instead of
sshing in via a default “admin” account, we install a cron job in /etc/cron.d
to manage accounts in line with the Google Compute Engine documentation. For more information, review [[https://developers.google.com/compute/docs/hello_world#ssh|how ssh works|target="_blank"]] on Google Compute Engine. The cron job can be safely removed or disabled to use alternative ways of managing 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]].
Line 29: Line 27:
To list the currently-recommended, newest versions of Debian images on Google Compute Engine, use [[https://developers.google.com/cloud/sdk/gcloud/|gcloud]]: 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/]]:
Line 35: Line 33:
As of 27 Sep 2014, the current images are: == Using An Image ==

To use the most up to date Debian 8 Jessie image, use the "debian-8" image family when creating a new instance.
Line 38: Line 38:
NAME PROJECT DEPRECATED STATUS
backports-debian-7-wheezy-v20140924 debian-cloud READY
debian-7-wheezy-v20140924 debian-cloud READY
gcloud compute instances create "<instance-name>" --image-project debian-cloud --image-family debian-8 --zone="<zone>"
Line 42: Line 40:

See also: [[https://developers.google.com/cloud/sdk/gcloud/reference/compute/images/list|gcloud compute images list]] command reference.

== Using An Image ==

To use an image, use [[https://developers.google.com/cloud/sdk/gcloud/|gcloud]]:

{{{
gcloud compute instances create "<instance-name>" --image="<image-name>" --image-project=debian-cloud --zone="<zone>" --machine-type="<machine-type>"
}}}

See also: [[https://developers.google.com/cloud/sdk/gcloud/reference/compute/instances/create|gcloud compute instances create]] command reference.
Line 57: Line 43:
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 and if your instances or disks uses a deprecated image, you will need to restart them with a newer, non-deprecated image.

Use [[https://developers.google.com/cloud/sdk/gcloud/|gcloud]] to list images and review their deprecation status, if any:
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.
Line 65: Line 49:
A list of deprecation statuses are available in the [[https://developers.google.com/compute/docs/reference/latest/images|Images reference|target="_blank"]] documentation.
Line 69: Line 51:
To build a Debian image for Google Compute Engine, follow these instructions: To build a Debian image for Google Compute Engine, follow the guide for building custom images in Google Compute Engine:
[[h
ttps://cloud.google.com/compute/docs/tutorials/building-images]]
Line 71: Line 54:
 1. '''Request access to Google Compute Engine'''
  If you want to help with the Cloud/GoogleComputeEngineImage effort and don't already have a Google Compute Engine space to work in, contact David (cache@google.com).
  Be sure to provide the following information in your email:

      * A description of how you can help
      * The email of your Google account (Google Apps and consumer accounts are both fine)

  We will add people to the appropriate projects, within certain constraints. See "Access To Test Account for Debian Developers" below for more information.

 1. '''Create images using the build script (see below) on any Linux machine'''
  Sample command lines (root access is needed for the loopback mounting process):

  * regular wheezy package:

  {{{
sudo ./bootstrap-vz manifests/gce.manifest.yml
  }}}

  * backports image:

  {{{
sudo ./bootstrap-vz manifests/gce-backports.manifest.yml
  }}}

 1. '''Follow [[https://developers.google.com/compute/docs/images#creating_an_image_from_a_tar_file | these instructions]] to upload and use a custom image'''

=== Image Build Script ===

Anders Ingemann has created a [[https://github.com/andsens/bootstrap-vz | build script]] for bootstrapping instances that runs automatically and needs no user interaction. You can also attach custom scripts to the script as well. Download or clone the script on [[https://github.com/andsens/bootstrap-vz | GitHub]]. Any bugs or suggestions should be reported via the !GitHub issue tracker or discussed on debian-cloud.
You can also create your own bootstrap-vz manifest and build an image using the baseline manifests as an example:
[[https://github.com/andsens/bootstrap-vz/tree/master/manifests/official/gce]]
Line 103: Line 59:
If you have any questions, concerns, or general feedback, please don’t hesitate to contact the Google Compute team (gc-team@google.com) or David !McWherter (cache@google.com) directly about this effort. If you have any questions, concerns, or general feedback, please don’t hesitate to contact the Google Compute team (gc-team@google.com) or open an issue in the compute-image-packages Github project [[https://github.com/GoogleCloudPlatform/compute-image-packages/issues]].
Line 105: Line 61:
== Access to test account, for Debian Developers interested in testing, or working on Debian images == == Google Compute Engine Debian Experiments Project ==
Line 107: Line 63:
Google has created two Google Compute Engine projects for Debian’s use. Billing for Google Compute Engine and Google Cloud Storage has been waived on these projects. The first project, ‘debian-cloud’, is intended for pushing new images to customers. The second project, ‘debian-cloud-experiments’, is intended for Debian volunteers to experiment with the project. It has a small quota and must be shared. Google will work with Debian to manage access to these projects. 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.

Cloud/GoogleComputeEngine Image lists for Google Compute Engine

Google Compute Engine Documentation

Google Compute Engine documentation: https://cloud.google.com/compute/docs/

Debian Images

Google Compute Engine Debian 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.

The images deviate from official Debian images in order to make Debian work correctly on the platform and provide a baseline user experience. 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 8 Jessie image, use the "debian-8" image family when creating a new instance.

gcloud compute instances create "<instance-name>" --image-project debian-cloud --image-family debian-8 --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, follow the guide for building custom images in Google Compute Engine: https://cloud.google.com/compute/docs/tutorials/building-images

You can also create your own bootstrap-vz manifest and build an image using the baseline manifests as an example: https://github.com/andsens/bootstrap-vz/tree/master/manifests/official/gce

Google Contacts

If you have any questions, concerns, or general feedback, please don’t hesitate to contact the Google Compute team (gc-team@google.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.