Skip to content

01-simply.md

Latest commit

 

History

History
96 lines (59 loc) · 3.28 KB

01-simply.md

File metadata and controls

96 lines (59 loc) · 3.28 KB

1. Deploy Simply

In this page, you will deploy an application to your platform in a simple way.

1. Prepare config files

1-1. Edit configuration files of one platform under /src/deploy/ in your cloned repository as bellow.

Note

Each platform has a deployment config file (app.pipecd.yaml) + platform specific files.

  • For Kubernetes:
    • You will run a helloworld service.
    • Use kubernetes/simple/. You do not need to edit.
  • For Google Cloud Run:
    • You will run a helloworld service.
    • Use cloudrun/simple/. You do not need to edit.
  • For Amazon ECS:
    • You will run an nginx service.
    • Edit ecs/simple/ as below.
      • app.pipecd.yaml: Edit targetGroupArn.
      • servicedef.yaml: Edit cluster, securityGroups, and subnets.
      • taskdef.yaml: Edit executionRoleArn.
  • For AWS Lambda:
    • You will create a function using a simple Python source code package.
    • Edit lambda/simple/ as below.
      • Build the function package: Run ./build.sh (Linux/Mac) or build.bat (Windows)
      • Upload the generated zip file to your S3 bucket
      • function.yaml: Edit role, s3Bucket, and s3Key
  • For Terraform:
    • You will generate a file on local.
    • Edit terraform/simple/ as below.
      • main.tf: Edit path and filename.

1-2. Commit and push the changes to remote.

2. Register the application

2-1. Go to the applications page. http://localhost:8080

2-2. Click + ADD.

2-3. Enter values and click SAVE->SAVE.

  • Piped: Your Piped
  • Platform Provider: The platform
  • Application: The application you configured in 1.

add-application-input

2-4. If successful, you will see the dialog like the following image.

application-is-added

3. Watch the first deployment

3-1. Go to the deployments page. http://localhost:8080/deployments

3-2. Wait until a new deployment automatically appears. Then click it to see details.

Note

You do NOT need to invoke a deployment by yourself since your Piped automatically starts it. This is GitOps.

deployment-before-appear deployment-appear

3-3. Wait until the status becomes SUCCESS/FAILURE. If it shows FAILURE, check the log in the page.

deployment-deploying

3-4. When the status becomes SUCCESS, the deloyment is successfully finished.

deployment-success

3-5. Check your platform (Kubernetes cluster, cloud console, etc.) to confirm the result.

4. Edit the config and watch a new deployment

4-1. Edit the config file you deployed. (e.g. Change the image tag, sizing, etc.)

4-2. Commit and push the change to remote.

4-3. Go to the deployments page again. http://localhost:8080/deployments

4-4. A new deployment will start in a few minutes.

Next: Deploy with a Customized Pipeline >

< Previous: Deploy