This page is a supplemental guide to the container readme for each
[Google Cloud Marketplace container product](https://console.cloud.google.com/marketplace/browse?filter=solution-type:container).
It provides additional information for deploying a container to a
brand new Google Kubernetes Engine cluster or to a local Minikube cluster.
It also provides links for using Docker.

> [!CAUTION]
> As of July 18, 2018, the container registry
> `launcher.gcr.io` and its alias `l.gcr.io` are deprecated.
> Docker images in `launcher.gcr.io` remain available, but are
> no longer updated.
>
> If you are currently pulling images from `launcher.gcr.io`, you
> must:
>
> - Change all your references to `marketplace.gcr.io`.
> - Set up [authentication](https://docs.cloud.google.com/container-registry/docs/advanced-authentication) for Container Registry, using the following command:
>
>   ```
>       gcloud auth configure-docker
>       
>   ```

# Deploy a container

The following sections describe how to deploy to Kubernetes and to Docker.

## Deploy to Kubernetes

There are two methods to deploy containers to Kubernetes. You can deploy to
Google Kubernetes Engine, or locally to your machine using Minikube. Both methods are
described below.

### Deploy to Google Kubernetes Engine

1. **Install the required tools**   

   Follow the steps in the
   [Quickstart for Google Kubernetes Engine](https://docs.cloud.google.com/kubernetes-engine/docs/deploy-app-cluster.md.txt).
   These steps will help you setup your environment with `gcloud` and `kubectl`.

2. **Verify that `kubectl` can connect to the clusters**   

   After your environment is set up, verify `kubectl` can reach the clusters you
   created. You can run the following to see if your nodes are running:

        kubectl get nodes

3. **Follow the getting started documentation for the container in the
   Kubernetes section**   

   Each container product on Cloud Marketplace contains a getting
   started guide. You can access the container getting started document by
   selecting the container you want to deploy from
   [the Google Cloud console](https://console.cloud.google.com/marketplace/browse?filter=solution-type:container),
   and then clicking the **Get Started with {** *product name* **}** button near
   the top of the page.

### Deploy to Minikube

1. **Install the required tools**   

   Follow the steps in the
   [Minikube Setup guide](https://kubernetes.io/docs/getting-started-guides/minikube/).
   These steps will help you setup a local Minikube environment. After
   **minikube start** in the linked instructions, you can then follow the
   instructions below.

2. **Verify that `kubectl` can connect to the clusters**   

   While Minikube is running (after running `minikube start`), you can use the
   following command to check if your nodes are running:

        kubectl get nodes

3. **Follow the getting started documentation for the container in the Kubernetes section**

   Each container product on Cloud Marketplace contains a getting
   started guide. You can access the container getting started document by
   selecting the container you want to deploy from
   [the Google Cloud console](https://console.cloud.google.com/marketplace/browse?filter=solution-type:container),
   and then clicking the **Get Started with \[product_name\]** button
   near the top of the page.

## Deploy to Docker

1. **Install Docker**

   To deploy a container to Docker, first install Docker on your local machine
   or virtual machine. The Docker installation guide is available from the
   Docker [website](https://docs.docker.com/engine/installation/).
2. **Follow the steps in the getting started guide**

   Each container product on Cloud Marketplace contains a getting
   started guide. You can access the container's getting started guide by
   selecting the container you want to deploy from
   [the Google Cloud console](https://console.cloud.google.com/marketplace/browse?filter=solution-type:container)
   and then clicking the **Get Started with \[product_name\]** button near
   the top of the page.