Tutorial (Project Creation to Build/Deployment)

The user can create a DevOps Console project and build the source to create an image and deploy a Helm chart to a Kubernetes cluster through the following procedure.

Creating a Project Group

The user can create a project group. The user must be a member of the tenant to create a project group.

Creating a Project Group

To create a project group, follow these steps:

1. Click the Create Project Group and Start button or Create Project Group button on the Main page. The Create Project Group popup window opens.
2. Enter the items and click the Save button to complete the project group creation.

Joining a Tenant

To join a tenant, follow the procedure below.

1. Project Group Creation popup window, click the Join Tenant Shortcut link. The Tenant Join Request popup window will open.
2. In the Tenant Search field, enter the tenant code you want to join exactly and click the Search icon. The tenant information will be retrieved.
3. Verify that the searched tenant is correct, enter the Reason for Request, and click the Add button. It will be added to the list below.
4. Select the authority for the tenant added to the list below and click the Save button.

Creating a Project (Helm Chart Deployment)

The user can create a project that deploys an application to a specific Kubernetes cluster using App Template, Helm Chart, and Tool Management.

Starting Project Creation

To start creating a project, follow these steps:

1. Click the Create Project button on the Main page. The Create Project page opens.

Entering Basic Information

Enter the project’s basic information. The project name and project ID must be unique and cannot be duplicated.

To enter basic information, follow these steps:

1. Project Creation page, select Project Configuration Method item’s App. Template Utilization.
2. Select Kubernetes for the Deployment Target item.
3. Enter additional content and click the Start button.

   Item	Description
   Project Name	Enter the project name.
   Project ID	Enter the project ID.
   Project Configuration Method	Select the project configuration method App. Template Utilization: Select a pre-provided App. template. Direct Configuration: Configure directly without an App. template.
   Deployment Target	Select the deployment target Kubernetes: Deploy the application to a Kubernetes cluster. Kubernetes(ArgoCD): Deploy the application to a Kubernetes cluster using ArgoCD. VM(Artifact): Deploy the application to a VM server. VM(Docker): Deploy the application to a VM server as a Docker image. N/A: Select if the build result is not deployed.
   K8S Cluster	Select the target cluster to deploy DevOps Console K8S cluster’s cluster, only clusters with user access rights can be selected.
   Namespace	Select the target namespace to deploy K8S cluster’s retrieved cluster, only namespaces with user access rights can be selected.

   Table. Project Creation Basic Information Input Items

Selecting an Application Template

Users can select an application template to configure their project.

If you create a project based on an application template with sample source code, you can verify the application to be deployed.

On the other hand, using a template marked as Environment Only configures only the build/deployment environment without sample source code.

If you are using an already configured source code repository to configure your project, select a template marked as Environment Only.

To start choosing an application template, follow these steps:

1. Application Template screen, enter the template name to select the desired application template card and click it.
2. When the Next button is activated, click the Next button.

Setting Up a Code Repository

The user can set up a repository to manage the source code through the code repository setting step.

Creating a New Repository and Using an Existing Repository activation conditions vary depending on the Application Template and Tool.

To modify or delete saved authentication information, please refer to Managing Authentication Information.

To set up a code repository, follow these steps:

1. In the Code Repository section, select the Code Repository type.
2. Select Create a New Repository or Use an Existing Repository and enter the information.
3. Enter the Authentication Information and click the Connection Test button.
4. If the Next button is activated, click the Next button.

Setting Up Code Quality

The user can configure a repository for quality management.

To set up code quality, follow the procedure below.

1. Code Quality item, select the Repository Type.
2. Enter Basic Information and Authentication Information, then click the Connection Test button.
3. When the Next button is activated, click the Next button.

Setting Up an Image Repository

The user can set up the repository to store the built container image through the image repository setting step.

To modify or delete saved authentication information, please refer to Managing Authentication Information.

To set up an image repository, follow these steps:

1. Image Repository section, select the Repository Type.
2. Select Create New Repository/Use Existing Repository and enter the information.
3. Enter the Authentication Information and click the Connection Test button.
4. When the Next button is activated, click the Next button.

Setting Up a Release Target Environment

The user can deploy through direct configuration using Helm charts.

When selecting Helm release name and Helm chart, the Helm chart installation items and the default Values.yaml items included in the chart are displayed.

Available Helm charts are linked to App templates. You can modify or delete them through Managing Supported Helm Charts.

To set up the deployment target environment, follow these steps:

1. Select direct configuration using Helm charts in the deployment target section.
2. Enter the Helm release name.
3. Click the Search button to select the Helm chart to use.
4. Modify the Values.yaml and click the Validation Check button.
5. Click the Next button when it is activated.

Setting Up a Build Pipeline

Users can configure pipelines for building and deploying applications.

You can check each stage of the pipeline to be configured and change the build job name.

To set up a build pipeline, follow these steps:

1. Build Pipeline screen branches according to IDP connection.
   • For IDP-connected Jenkins, click the User Check button to verify user registration.
   • For non-IDP-connected Jenkins, enter authentication information and click the Connection Test button.
2. When the Next button is activated, click the Next button.

Setting Up User Definitions

Users can specify and modify the path of the Dockerfile file to be used for building.

Additionally, you can check and modify the final script generated based on the information set up in Configuring the Build Pipeline.

To configure Dockerfile and pipeline scripts, follow these steps:

1. Customize settings page, enter information, and click the Connection Test button.
2. When the Next button is activated, click the Next button.

Completing Project Creation

The user can finally check the project and tool information to be created and start creating the project.

To complete the project creation, follow the procedure below.

1. Summary Information screen, check the information and click the Complete button.
2. The Project Creation popup window opens and the project creation proceeds.
3. After the project creation is complete, click the Confirm button to move to the Project page.

Checking Build Pipeline Execution

On the Project page, you can check the pipeline execution status, and the build pipeline is automatically executed when the project is created for the first time.

If the build pipeline fails, modify and re-execute the pipeline through the Build Pipeline menu on the left.

To check the build pipeline execution, follow these steps:

1. Click the Project card on the Main page. Move to the Project Dashboard page.
2. Click the Build/Deployment > Build Pipeline menu on the left.

Checking Deployment Results

After the pipeline execution is complete, you can check the Helm chart deployment results.

For more information on Helm chart deployment results, refer to Helm Release.

To check the deployment results, follow these steps:

1. Click the Project card on the Main page. Move to the Project Dashboard page.
2. Click the Build/Deployment > Kubernetes Deployment menu on the left. Move to the Kubernetes Deployment page.
3. Click the Helm Release list to check the detailed deployment results.