aulanov / compute-image-packages

Scripts and tools for Google Compute Engine images.

Image Packages for Google Compute Engine

This repository is the collection of packages that are installed on the standard Google Compute Engine images.

1. Image Bundle - Tool that creates an image file out of a disk attached to a GCE VM.
2. Google Startup Scripts - Scripts and configuration files that setup a Linux-based image to work smoothly with GCE.
3. Google Daemon - A service that manages user accounts, maintains ssh login keys, syncs the system clock after migration, and syncs public endpoint IP addresses.

Installation

From Release Tarballs

The easiest way to install these packages into a Linux-based image is to extract each tarball to / (root). Image Bundle does not have a directory structure, it is recommended to it extract to /usr/share/imagebundle. The tarballs are available in releases.

Refer to Building a Google Compute Engine Image for the complete guide.

From Source Repository

Occasionally you may want to install the latest commits to the repository even if they have not been released. This is not recommended unless there is a change that you specifically need and cannot wait for. To do this:

1. Log in to your target machine.

2. Clone the repository with

    git clone https://github.com/GoogleCloudPlatform/compute-image-packages.git
   

3. Copy the google-daemon and google-startup-scripts files to your root directory with

    sudo cp -R compute-image-packages/{google-daemon/{etc,user},google-startup-scripts/{etc,usr,lib}} /
   

4. Configure the packages to run on startup with (Debian)

    sudo update-rc.d google-starup-scripts defaults && sudo update-rc.d google-accounts-manager defaults && sudo update-rc.d google-address-manager defaults && sudo update-rc.d google-clock-sync-manager defaults
   

   or (Redhat)

    sudo chkconfig --add google-startup-scripts && sudo chkconfig --add google-accounts-manager && sudo chkconfig --add google-address-manager && sudo chkconfig --add google-clock-sync-manager
   

5. Either restart so the packages run or start them with (Debian and Redhat)

    sudo service google-accounts-manager restart && sudo service google-address-manager restart && sudo service google-clock-sync-manager restart
   

6. Install gcimagebundle with

    cd compute-image-packages/gcimagebundle && sudo python setup.py install
   

Source Code

This repository is structured so that each package is located in its own top-level directory. google-startup-scripts and google-daemon are stored as the directory structure of where the files would be from root. image-bundle has no directory structure.

Contributing

Have a patch that will benefit this project? Awesome! Follow these steps to have it accepted.

1. Please sign our Contributor License Agreement.
2. Fork this Git repository and make your changes.
3. Run the unit tests. (gcimagebundle only)
4. Create a Pull Request
5. Incorporate review feedback to your changes.
6. Accepted!

License

All files in this repository are under the Apache License, Version 2.0 unless noted otherwise.