| .. | ||
| cloudrun-app | ||
| README.md | ||
Dagger Examples
All example commands should be executed in the examples/ directory
in an up-to-date checkout of the dagger repository.
Deploy a static page to S3
This example shows how to generate a simple HTML page and serve it from an S3 bucket.
Components:
- Amazon S3 for hosting
- Initialize a new workspace
cd ./simple-s3
dagger init
- Create a new environment
dagger new simple-s3
cp *.cue ./.dagger/env/simple-s3/plan/
- Configure your AWS credentials
dagger input secret awsConfig.accessKey MY_AWS_ACCESS_KEY
dagger input secret awsConfig.secretKey MY_AWS_SECRET_KEY
- Specify the source code location
dagger input dir source website
- Deploy!
dagger up
- Check the URL
curl -i $(dagger query url -f text)
Deploy a simple React application
This example shows how to deploy an example React Application. Read the deployment plan
Audience: Javascript developers looking to deploy their application.
Components:
- Netlify for application hosting
- Yarn for building
- Github for source code hosting
- React-Todo-App by Kabir Baidhya as a sample application.
- Initialize a new workspace
cd ./react
dagger init
- Create a new environment
dagger new react
cp *.cue ./.dagger/env/react/plan/
- Configure the deployment with your Netlify access token. You can create new tokens from the Netlify dashboard.
dagger input secret www.account.token MY_TOKEN
NOTE: there is a dedicated command for encrypted secret inputs, but it is not yet implemented. Coming soon!
- Deploy!
dagger up
Deploy a complete JAMstack app
This example shows how to deploy a complete app with a backend, a database and a frontend.
This app assumes the following infrastructure is available:
- AWS ECS Cluster
- AWS ALB with a TLS certificate
- AWS RDS Instance (MySQL or PostgreSQL)
- AWS ECR repository
- Initialize a new workspace
cd ./jamstack
dagger init
- Create a new environment
dagger new jamstack
cp *.cue ./.dagger/env/jamstack/plan/
- Edit the inputs
Edit the file inputs.yaml and review all values to match to your infrastructure.
Add the inputs to the deployment:
dagger input yaml "" -f ./inputs.yaml
- Deploy!
dagger up
The example inputs.yaml from the ./examples/jamstack directory takes the source code from a remote git repository, but you can remove this from the file and instead points to a local source code:
dagger input dir backend.source ./my/local/backend/code
And the same mechanism applies for every single key in this file.
- Get the App URL
dagger query url
Provision a Kubernetes cluster on AWS
This example shows how to provision a new Kubernetes cluster on AWS, and configure your kubectl client to use it. Read the deployment plan
Audience: infrastructure teams looking to provisioning kubernetes clusters as part of automated CICD pipelines.
Components:
- Amazon EKS for Kubernetes hosting
- Amazon CloudFormation for infrastructure provisioning
- Kubectl as kubernetes client
- Initialize a new workspace
cd ./kubernetes-aws
dagger init
- Create a new environment
dagger new kubernetes-aws
cp *.cue ./.dagger/env/kubernetes-aws/plan/
- Configure the deployment with your AWS credentials
dagger input secret awsConfig.accessKey MY_AWS_ACCESS_KEY
dagger input secret awsConfig.secretKey MY_AWS_SECRET_KEY
- Deploy!
dagger up
- Export the generated kubectl config
dagger query kubeconfig.kubeconfig | jq . > kubeconfig
Add HTTP monitoring to your application
This example shows how to implement a robust HTTP(s) monitoring service on top of AWS. Read the deployment plan.
Audience: application team looking to improve the reliability of their application.
Components:
- Amazon Cloudwatch Synthetics for hosting the monitoring scripts
- Amazon CloudFormation for infrastructure provisioning
- Initialize a new workspace
cd ./monitoring
dagger init
- Create a new environment
dagger new monitoring
cp *.cue ./.dagger/env/monitoring/plan/
- Configure the deployment with your AWS credentials
dagger input text awsConfig.accessKey MY_AWS_ACCESS_KEY
dagger input text awsConfig.secretKey MY_AWS_SECRET_KEY
- Configure the monitoring parameters
dagger input text website https://MYWEBSITE.TLD
dagger input text email my_email@my_domain.tld
- Deploy!
dagger up
Deploy an application to your Kubernetes cluster
This example shows two different ways to deploy an application to an existing Kubernetes cluster: with and without a Helm chart. Read the deployment plan](https://github.com/dagger/dagger/tree/main/examples/kubernetes-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.
Components:
- Amazon EKS for Kubernetes hosting
- Kubectl as kubernetes client
- Helm to manage kubernetes configuration (optional)
How to run:
- Initialize a new workspace
cd ./kubernetes-app
dagger init
- Create a new environment
dagger new kubernetes-app
cp *.cue ./.dagger/env/kubernetes-app/plan/
- Configure the deployment with your AWS credentials
dagger input secret awsConfig.accessKey MY_AWS_ACCESS_KEY
dagger input secret awsConfig.secretKey MY_AWS_SECRET_KEY
- Configure the EKS cluster to deploy to
Note: if you have run the kubernetes-aws example, you may skip this step.
dagger input text cluster.clusterName MY_CLUSTER_NAME
- Load the Helm chart
dagger input dir helmChart.chart ./testdata/mychart
- Deploy!
dagger up
Deploy an application to GCP Cloud Run
This example shows how to deploy an application to GCP Cloud Run. Read the deployment plan
NOTE: this example requires the right GCP IAM permissions: https://cloud.google.com/run/docs/reference/iam/roles#additional-configuration
Components:
How to run:
- Initialize a new workspace
cd ./cloudrun-app
dagger init
- Create a new environment
dagger new cloudrun-app
cp main.cue ./.dagger/env/cloudrun-app/plan/
- Configure the Cloud Run service
dagger input text serviceName MY_APP_NAME
dagger input text image MY_GCR_IMAGE_NAME
dagger input text gcpConfig.project MY_GCP_PROJECT
dagger input text gcpConfig.region MY_GCP_REGION
dagger input secret gcpConfig.serviceKey -f MY_GCP_SERVICE_KEY_FILE
- Deploy!
dagger up