GoogleCloudPlatform/konlet

Name: konlet

Owner: Google Cloud Platform

Description: null

Created: 2017-05-29 09:51:26.0

Updated: 2018-05-17 14:26:05.0

Pushed: 2018-05-21 12:40:26.0

Homepage: null

Size: 2272

Language: Go

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Compute Engine Container Startup Agent

The Compute Engine container startup agent starts a container deployed on a VM instance using Deploying Containers on VMs and Managed Instance Groups method.

The agent parses container declaration that is stored in VM instance metadata under gce-container-declaration key and starts the container with the declared configuration options.

The agent is bundled with Container-Optimized OS image, version 62 or higher.

Building the agent

Container startup agent is deployed as a Docker container and is hosted in Container Registry: gcr.io/gce-containers/konlet.

To build the agent using bazel run this command from the repository root:

zel build gce-containers-startup

Export your GCP project name to an environment variable:

port MY_PROJECT=your-project-name

To build a Docker image, copy the build binary to the 'docker' directory and invoke the docker build command:

 bazel-bin/gce-containers-startup/gce-containers-startup docker/
cker build docker/ -t gcr.io/$MY_PROJECT/gce-containers-startup

To push resulting Docker image to Google Container Registry you can use gcloud command:

loud docker -- push gcr.io/$MY_PROJECT/gce-containers-startup
Usage

If you would like to install the container startup agent on your VM, copy its systemd service definition and scripts:

You can also those scripts directly by a startup script, cloud-init or rc.d scripts.

License

Compute Engine container startup agent is licensed under Apache License 2.0. The license is available in the LICENSE file.

You can find out more about the Apache License 2.0 at: http://www.apache.org/licenses/LICENSE-2.0.


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.