Update Cloud Run docs

Signed-off-by: Tihomir Jovicic <tihomir.jovicic.develop@gmail.com>
This commit is contained in:
Tihomir Jovicic 2021-07-05 12:40:45 +02:00
parent 104928f062
commit 31714de4e3
3 changed files with 99 additions and 35 deletions

View File

@ -4,52 +4,112 @@ slug: /learn/106-cloudrun
# Dagger 106: deploy to Cloud Run
This tutorial illustrates how to use dagger to push and deploy Docker
images to CloudRun.
This tutorial illustrates how to use Dagger to build, push and deploy Docker images to Cloud Run.
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
# Deploy an application to GCP Cloud Run
## Initialize a Dagger Workspace and Environment
This example shows how to deploy an application to GCP Cloud Run. Read the deployment [plan](https://github.com/dagger/dagger/tree/main/examples/cloud-run-app)
### (optional) Setup example app
NOTE: this example requires an EKS cluster to allow authentication with your AWS credentials; but can easily be adapter to deploy to any Kubernetes cluster.
You will need the local copy of the [Dagger examples repository](https://github.com/dagger/examples) used in previous guides
Components:
- [Cloud Run](https://cloud.google.com/run)
How to run:
1. Initialize a new workspace
```sh
cd ./cloud-run-app
dagger init
```shell
git clone https://github.com/dagger/examples
```
2. Create a new environment
Make sure that all commands are being ran from the todoapp directory:
```sh
dagger new cloud-run-app
cp *.cue ./.dagger/env/cloud-run-app/plan/
```shell
cd examples/todoapp
```
3. Configure the Cloud Run service
### (optional) Initialize a Cue module
```sh
dagger input text serviceName MY_APP_NAME
dagger input text region MY_GCP_REGION
dagger input text image MY_GCR_IMAGE_NAME
In this guide we will use the same directory as the root of the Dagger workspace and the root of the Cue module; but you can create your Cue module anywhere inside the Dagger workspace.
dagger input text gcpConfig.project MY_GCP_PROJECT
dagger input secret gcpConfig.serviceKey -f MY_GCP_SERVICE_KEY_FILE
```shell
cue mod init
```
4. Deploy!
### Organize your package
```sh
dagger up
Let's create a new directory for our Cue package:
```shell
mkdir cue.mod/gcpcloudrun
```
### Create a basic plan
```cue title="todoapp/cue.mod/gcpcloudrun/source.cue"
package gcpcloudrun
import (
"alpha.dagger.io/dagger"
"alpha.dagger.io/docker"
"alpha.dagger.io/gcp"
"alpha.dagger.io/gcp/cloudrun"
"alpha.dagger.io/gcp/gcr"
)
// Source code of the sample application
src: dagger.#Artifact & dagger.#Input
// GCR full image name
imageRef: string & dagger.#Input
image: docker.#Build & {
source: src
}
gcpConfig: gcp.#Config
creds: gcr.#Credentials & {
config: gcpConfig
}
push: docker.#Push & {
target: imageRef
source: image
auth: {
username: creds.username
secret: creds.secret
}
}
deploy: cloudrun.#Service & {
config: gcpConfig
image: push.ref
}
```
## Set up the environment
### Create a new environment
Now that your Cue package is ready, let's create an environment to run it:
```shell
dagger new 'gcpcloudrun' -m cue.mod/gcpcloudrun
```
### Configure user inputs
```shell
dagger input dir src . -e gcpcloudrun
dagger input text deploy.name todoapp -e gcpcloudrun
dagger input text imageRef gcr.io/<your-project>/todoapp -e gcpcloudrun
dagger input text gcpConfig.region us-west2 -e gcpcloudrun
dagger input text gcpConfig.project <your-project> -e gcpcloudrun
dagger input secret gcpConfig.serviceKey -f ./gcp-sa-key.json -e gcpcloudrun
```
## Deploy
Now that everything is properly set, let's deploy on Cloud Run:
```shell
dagger up -e gcpcloudrun
```

View File

@ -10,7 +10,7 @@ import (
// GCP Config
config: gcp.#Config
// service name
// Cloud Run service name
name: string @dagger(input)
// GCR image ref
@ -19,6 +19,9 @@ import (
// Cloud Run platform
platform: *"managed" | string @dagger(input)
// Cloud Run service exposed port
port: *"80" | string @dagger(input)
#up: [
op.#Load & {
from: gcp.#GCloud & {
@ -35,7 +38,7 @@ import (
"pipefail",
"-c",
#"""
gcloud run deploy "$SERVICE_NAME" --image "$IMAGE" --region "$REGION" --platform "$PLATFORM" --allow-unauthenticated
gcloud run deploy "$SERVICE_NAME" --image "$IMAGE" --region "$REGION" --port "$PORT" --platform "$PLATFORM" --allow-unauthenticated
"""#,
]
env: {
@ -43,6 +46,7 @@ import (
PLATFORM: platform
REGION: config.region
IMAGE: image
PORT: port
}
},
]

View File

@ -9,6 +9,6 @@ TestConfig: gcpConfig: gcp.#Config
TestCloudRun: deploy: cloudrun.#Service & {
config: TestConfig.gcpConfig
name: "cloudrun-test"
image: "gcr.io/dagger-ci/cloudrun-test:latest"
name: "todoapp"
image: "gcr.io/dagger-ci/todoapp:latest"
}