# Deploy Based on Git Source Code

Before you begin, please confirm that you have finished project and application creation.

# Prepare Code Sample

It is a simple web service based on Spring Boot Web Service, with its code hosted on GitHub (opens new window).

# Download to the Local

git clone https://github.com/bzdgn/docker-spring-boot-java-web-service-example.git

# Push to the Platform

Erda has a built-in Git code repository based on the Git protocol, that allows you to complete the entire process from development to deployment without relying on external repositories (such as GitLab).

Go to My Application > Select Application > Source > Repo Address to view the address of remote repository.

git remote add erda http://dice.dev.terminus.io/wb/erda-test/java-demo
git push -u erda --all
git push -u erda --tags

After code pushing, you can view the detailed code information.

# Define Pipeline

Add configuration files, pipeline.yml and dice.yml, to the project.

# pipeline.yml

pipeline.yml is a configuration file that describes pipeline from compilation, building to deployment, generally consists of four stages, executed in the following order:

1. Git pull.
2. Compilation and building for Docker image.
3. Artifact release.
4. Artifact deployment.

The four stages can be executed as the following actions:

1. Git-Checkout (opens new window)
2. Java (opens new window)
3. Release (opens new window)
4. Erda (opens new window)

An example of pipeline.yml for this project is as follows. For more information, see pipeline.yml.

version: "1.1"
stages:
- stage:
  - git-checkout:

- stage:
  - java:
      alias: java-demo
      # Caching the corresponding directory will speed up the next build.
      caches:
        - path: /root/.m2/repository
      params:
        build_type: maven
        # The working directory for packaging, usually the path of the root pom.xml.
        # ${git-checkout} means to reference the output from the previous stage process, or use an alias if there is one.
        workdir: ${git-checkout}
        # The packaged artifact is generally a JAR file and fill in the relative path compared to workdir. The file is required, otherwise an error will occur.
        target: ./target/docker-java-app-example.jar
        # Run the container required by target (such as JAR). For example, the packaged artifact here is the fat JAR of spring-boot, so spring-boot container is used.
        container_type: spring-boot

- stage:
  - release:
      params:
        dice_yml: ${git-checkout}/erda.yml
        image:
          java-demo: ${java-demo:OUTPUT:image}

- stage:
  - dice:
      params:
        release_id: ${release:OUTPUT:releaseID}

# dice.yml

dice.yml is a configuration file that describes the service architecture of an application, the configuration of resources such as CPU and memory and the dependency of service plugins.

An example of dice.yml for this project is as follows. For more information, see dice.yml.

version: "2.0"
services:
  java-demo:
    ports:
      - port: 8080
        expose: true
    resources:
      cpu: 0.2
      mem: 512
    deployments:
      replicas: 1

# Commit Files

Commit the two YAML files to the code repository of the platform.

git add .
git commit -m "add pipeline.yml and dice.yml"
git push erda feature/demo

# Run Pipeline

1. On the Pipeline page, select the feature/demo branch to add a new pipeline.
2. It is pending for execution after analysis. Click the execution icon in the upper right corner to run it.
3. During the process, you can view the status of each step in real time and click the log icon to check the execution information of the corresponding node.

# View Deployment Results

After building and deployment, you can view the runtime of application instance successfully deployed in Environments. Click the runtime for more operations of application management, such as domain configuration and instance scaling.