Deploying a service to Cloud Run

Now that you're all set up, you can deploy your service to Cloud Run and view your service live.

Defining your run configuration

Before you deploy your service, you must create your run configuration:

  1. Navigate to Run/Debug configurations selector in the Navigation bar and click Edit Configurations.
  2. Choose your Cloud Code: Cloud Run run configuration (or add a new one).
  3. Set your Google Cloud project ID.
  4. Choose your platform preferences under Deployment Platform, either Cloud Run (fully managed) or Cloud Run for Anthos on GKE. Refer to the Cloud Run platform guide for a detailed description of each option.

    • If Fully Managed is selected, choose a region to deploy to.
    • If Anthos on GKE is selected, configure the Kubernetes cluster information.

      Deployment platform options: Fully Managed (chosen) and Anthos on GKE with a region specified

  5. Choose Allow unauthenticated invocations for your authentication preferences, if your service is a public API or website. Otherwise, select Require authentication.

  6. Under Revision Settings, Cloud Code automatically populates the container image URL field with the storage location of your container image (where it stores your service, once it builds and containerizes it).

    This value is based on your Google Cloud project and service name.

    If you need to, you can choose to override this value:

    • For both Cloud Run (fully managed) and Cloud Run for Anthos, you can store your images on Google Container Registry and use the following format:{project-name}/{image-name} where {project-name} is the name of your GCP project and {image-name} refers to the container image repository.
    • If you're using Cloud Run for Anthos, you can choose to store your images on Docker Hub (ensure that you are properly authenticated if you are using a private Docker Hub repository), use the following format:{account} where {account} is the name of your Docker Hub account.

      Run/Debug configuration open with sample fields (project ID and region) filled in

  7. Specify your builder option and its relevant settings.

    Cloud Code supports Docker, Jib, and Buildpacks artifact types.

  8. Click 'OK'.

Optional: Customizing your configuration

When deploying your service, you can also specify additional settings like a service account, environment variables, and when using Cloud Run (fully managed), a VPC Connector and SQL connections, using the Advanced revision settings section when you choose Edit Configurations.

Environment variables:

The following environment variables are automatically added to the running containers:

Name Description Example
PORT The port your HTTP server should listen on. 8080
K_SERVICE The name of the Cloud Run service being run. hello-world
K_REVISION The name of the Cloud Run revision being run. hello-world.1
K_CONFIGURATION The name of the Cloud Run configuration that created the revision. hello-world

Deploying your service

To deploy your service, follow these steps:

  1. Choose your run target from the Run/Debug configurations dialog on the top taskbar.
  2. Click Run run action icon.
  3. View your running service by following the URL displayed in the output window.
  4. You can also view the status of your service (metrics, revision details, and more) by following the logs URL displayed in the output window.

    Viewing the status of your service in the Console

Getting support

To send feedback, report an issue on GitHub or ask a question on Stack Overflow.