Tool Management

Tools refer to applications that interact with the DevOps Console to support CI/CD functionality.

Please refer to Tool Classification for the list of tools supported by DevOps Console.

Getting Started with Tool Management

To begin tool management, follow the steps below.

1. Click the Management icon at the top right of the Main page. You will be taken to the Tenant Dashboard page.
2. From the left menu, click the Tools & Templates > Tools menu. You will be taken to the Tools page.

Tool type

Each tool’s applicable domain varies according to its type.

Tool classification

The list of tools currently supported by the DevOps Console is as follows.

Admin

Indicates the selected tenant or project group when adding a tool with the tenant/project group type.
Distinguish the types of management affiliation using the following icons.

• The management belongs to the tenant.
• The management affiliation is the project group.

Add tool

To add a tool, follow these steps.

1. On the Tool page, click the Add button. The Add Tool popup appears.

Select tool support type

1. Add Tool Select the tool’s supported type in the popup window.
2. Complete the selection and click the Next button. The Basic Information input screen appears.

   Item	Explanation
   type	Select the tool’s supported type Refer to 툴 유형 for descriptions by type.
   Tenant/Project Group	Select which tenant/project group to map to.

   Table. Supported type selection items when adding a tool

Enter basic information

1. Add Tool In the Basic Information input screen of the popup, select the tool category and the tool. The input screen changes based on the selected tool.
   • Refer to Tool Classification for explanations by tool category.
2. After entering the required information, click the Connection Test button.
3. Click the Next button.

SCM Repository

CICD Pipeline

Image Registry

Code Quality

Artifact Repository

Helm Chart Repository

Project Management Software

Enter additional information

1. Tool addition In the popup window’s Basic Information input screen, when you click the Next button, the Additional Information input screen appears.
2. Select each item and click the Complete button.
3. In the confirmation popup, click the Confirm button to complete adding the tool.

   Item	description
   Use status	Select whether to use the tool in this tenant/project group.
   Whether new creation is possible	Select whether to allow creating a new repository in the given tenant/project group. It is displayed only when the tool category is SCM Repository.

   Table. Additional Information Input Items

Tool Details

To begin managing the tool’s detailed information, follow these steps.

1. On the Tool page, click the tool for which you want to manage detailed information. You will be taken to the Tool Details page.

Manage tool basic information

To check the tool’s basic information, follow these steps.

1. On the Tool Details page, click the Basic Information tab.

To modify the tool’s basic information, follow these steps.

1. On the Tool Details page, click the Basic Information tab.
2. Click the Edit button.
3. After editing the required information, click the Save button.

Managing Global Tools

Jenkins web interface’s Jenkins Management > Global Tool Configuration menu can be operated from the DevOps Console.
Only one-way registration to Jenkins is supported from the DevOps Console. (In other words, changes made by the user in the DevOps Console will overwrite the information in Jenkins.)
Users can manage the list of tools available in Jenkins, and tools registered in Global Tools are used in Tools when configuring a stage.

To manage the global tool, follow the steps below.

1. On the Tool Details page, click the Global Tool tab.

Add global tool

To add a global tool, follow these steps.

1. In the Global Tool tab, click the Edit icon of the item you want to add. The Global Tool Management popup opens.
   • Essential tool is automatically configured in the DevOps Console.
   • essential tool cannot be deleted, and only the home path can be modified.
2. Click the Add button. A new row will be added at the bottom of the list.
3. Enter the information in the newly added row and click the Save button.
4. Click the Confirm button in the confirmation popup to complete.

   Item	description
   Tool types	The tool type is set automatically.
   Name	Please enter the tool name.
   Home path	Enter the path where the tool is installed.

   Table. Global Tool Additional Input Items

Modify Global Tool

To modify the global tool, follow these steps.

1. Click the Edit icon of the item you want to add in the Global Tool tab. The Global Tool Management popup opens.
2. After editing the content, click the Save button.
3. In the confirmation popup, click the Confirm button to complete.

Delete Global Tool

To delete the global tool, follow these steps.

1. Click the Edit icon of the item you want to add in the Global Tool tab. The Global Tool Management popup window opens.
2. After deleting the list, click the Save button.
3. In the confirmation popup, click the Confirm button to complete.

Managing agents (kubernetes)

Users can manage the agents (slave) used for builds in Jenkins.

Jenkins web screen’s 1) Jenkins Management > System Configuration > Cloud > Pod Templates or 2) Jenkins Management > Node Management > Configure Clouds > Pod Templates menu is a feature that can be operated from the DevOps Console.

DevOps Console only supports one-way registration to Jenkins. (In other words, changes made by the user in DevOps Console will overwrite the information in Jenkins.)

To manage the agent (Kubernetes), follow the steps below.

1. On the Tool Details page, click the Agent (Kubernetes) tab.
2. Click the information icon in the Pod Template Management list. The Pod Template Usage Guide popup opens.

Adding Container Resource Types

To add a container resource type, follow these steps.

1. On the Tool Details page, click the Agent (Kubernetes) tab.
2. Click the Edit icon of Container Resource Type Management. The Container Resource Type Management popup window opens.
3. Click the Add button, enter the content, and then click the Save button.
4. In the confirmation popup, click the Confirm button to complete.

   Item	description
   Whether to use	Set the usage. To change the usage, there must be no build pipeline configured using the Jenkins tool.
   Resource Type	Please enter the resource name.
   CPU/Memory (Request)	When configuring the Kubernetes Pod Agent, enter the requested resource values to be used.
   CPU/Memory (Limit)	Enter the limit values for the resources to be used when configuring the Kubernetes Pod Agent.

   Table. Container Resource Type Additional Input Items

Modify container resource type

To modify the container resource type, follow these steps.

1. On the Tool Details page, click the Agent (Kubernetes) tab.
2. Click the Edit icon of Container Resource Type Management. The Container Resource Type Management popup opens.
3. After editing the content, click the Save button.
4. In the confirmation popup, click the Confirm button to complete.

Delete Container Resource Type

To delete a container resource type, follow these steps.

1. On the Tool Details page, click the Agent (Kubernetes) tab.
2. Click the Edit icon of Container Resource Type Management. The Container Resource Type Management popup opens.
3. After deleting the content, click the Save button.
4. In the confirmation popup, click the Confirm button to complete.

Add Pod Template

To add a Pod Template, follow these steps.

1. On the Tool Details page, click the Agent (Kubernetes) tab.
2. Pod Template Management Click the Add button in the list. The Add Agent (Kubernetes) screen appears.
3. After entering the content, click the Save button.
4. In the confirmation popup, click the Confirm button to complete.

   Item	description
   Target Kubernetes	Select the target Kubernetes to which the Pod Template will be added Displays the list of Kubernetes clusters registered in Jenkins.
   Agent name	Enter the name of the Pod Template.
   Label	Enter the Label value to invoke the agent in the Jenkins Pipeline Script.
   Inherited Pod Template	Select the Pod Template that inherits configuration values (environment variables, Volume…) Shows the list of Pod Templates registered in the actual Jenkins.
   container	Enter the name, Docker image, working directory, command, and argument values that map to the Container Template field in Jenkins. Required container information cannot be deleted, and its name cannot be changed.
   Tool path	Information that maps to the Tool Locations field in Jenkins, enter the name/home path Only tools that have been added to the global tool list can be selected.
   Support stage	Select the supported stage configuration This information is used for configuring the build pipeline template in the DevOps Console. Required stage information cannot be deselected.

   Table. Input items for adding a Pod Template

Pod Template Details

To view the detailed information of a Pod Template, follow these steps.

1. On the Tool Details page, click the Agent (Kubernetes) tab.
2. Pod Template Management Click the Details button of the agent you want to view from the list. The Agent (Kubernetes) Details screen appears.

Modify Pod Template

To modify the Pod Template, follow these steps.

1. On the Tool Details page, click the Agent (Kubernetes) tab.
2. Pod Template Management Click the View Details button of the agent you want to view in the list. The Agent (Kubernetes) Details screen appears.
3. Click the Edit button.
4. After editing the content, click the Save button.
5. In the confirmation popup, click the Confirm button to complete the edit.

Delete Pod Template

To delete a Pod Template, follow these steps.

1. On the Tool Details page, click the Agent (Kubernetes) tab.
2. Pod Template Management In the list, click the Details button of the agent you want to view. Agent (Kubernetes) Details screen appears.
3. Click the Delete button.
4. In the confirmation popup, click the Confirm button to complete the deletion.

Managing Agents (VM)

You can manage the list of Nodes available for use in Jenkins.
This feature allows you to operate the Jenkins Management > Node Management menu of Jenkins from the DevOps Console.
DevOps Console only supports one-way registration to Jenkins. (In other words, changes made by the user in DevOps Console will overwrite the information in Jenkins.)

To manage the agent (VM), follow the steps below.

1. On the Tool Details page, click the Agent (VM) tab.
2. Click the Info icon in the Node Management list. The Node Usage Guide popup opens.

Manage Agent Connections

Register the tunneling port that connects the actual Jenkins and the agent (VM). The tunneling port may vary for each Jenkins.

To manage agent connections, follow these steps.

1. On the Tool Details page, click the Agent (VM) tab.
2. Click the Edit icon of Agent Connection Management. The Agent Connection Management popup window opens.
3. After entering the content, click the Save button.

Add Agent (VM)

To add an agent (VM), follow the steps below.

1. On the Tool Details page, click the Agent (VM) tab.
2. Click the Add button in Agent Connection Management. The Add Agent (VM) screen appears.
3. After entering the content, click the Save button.
4. In the confirmation popup, click the Confirm button to complete the deletion.

   Item	description
   Target OS	Enter the VM’s OS information.
   Agent name	Enter the VM name.
   Remote root directory	Enter the directory path.
   Label	Enter the Label value to invoke the agent in the Jenkins Pipeline Script.
   Tool path	Information that maps to the Jenkins Tool Locations field, enter the name/home path Only tools added to the global tool list can be selected.
   Support stage	Select the supported stage configuration This information is used for configuring the build pipeline template in the DevOps Console. Required stage information cannot be deselected.

   Table. Agent (VM) Add Input Items

Agent (VM) Details

To view the detailed information of an agent (VM), follow the steps below.

1. On the Tool Details page, click the Agent (VM) tab.
2. In the Node Management list, click the agent. The Agent (VM) Details screen appears.
3. Click the Information icon of Jenkins - Agent Connection Information.
4. Agent Connection Guide The popup window opens.

Integrate Agent (VM)

To register and use the agent (VM), you must connect to the actual VM server.

To integrate the agent (VM), follow these steps.

1. On the Tool Details page, click the Agent (VM) tab.
2. From the Node Management list, click the agent you want to integrate. The Agent (VM) Details screen appears.
3. Refer to jnlpUrl and secret.
4. Click the Info icon of Jenkins - Agent Connection Information. The Agent Connection Guide popup opens.
5. Agent File Download Click the button to download the agent.jar file.
   • There may be issues running depending on the version of agent.jar.
   • You can also download it directly from your own Jenkins. ({JENKINS_URL}/jnlpJars/agent.jar)
6. Connect to the VM server to be deployed and create a directory.
7. Copy the downloaded agent.jar file to the generated directory.
8. Run the following command in the generated directory path.

java -jar agent.jar -jnlpUrl {jnlpUrl} -secret {secret}

java -jar agent.jar -jnlpUrl {jnlpUrl} -secret {secret}

Modify Agent (VM)

To modify the agent (VM), follow the procedure below.

1. On the Tool Details page, click the Agent (VM) tab.
2. Click the agent you want to edit in the Node Management list. The Agent (VM) Details screen appears.
3. Click the Edit button.
4. After editing the content, click the Save button.
5. In the confirmation popup, click the Confirm button to complete.

Delete Agent (VM)

To delete the agent (VM), follow these steps.

1. On the Tool Details page, click the Agent (VM) tab.
2. Click the agent you want to delete from the Node Management list. The Agent (VM) Details screen appears.
3. Click the Delete button.
4. Click the Confirm button in the confirmation popup to complete.

Managing Global Libraries

You can manage the list of libraries available in the build pipeline. The Jenkins Management → System Settings → Global Pipeline Libraries menu of Jenkins can be managed through the DevOps Console.
The Credential information linked to the library can be viewed in the Jenkins Management > Manage Credentials menu.
DevOps Console only supports one-way registration to Jenkins. (In other words, changes made by the user in DevOps Console will overwrite the information in Jenkins.)

To manage the agent(VM), follow these steps.

1. On the Tool Details page, click the Global Library tab.

Add Global Library

To add a global library, follow these steps.

1. Tool Details on the page, click the Global Library tab.
2. Click the Add button. The Add Global Library screen appears.
3. After entering the content, click the Save button.
4. In the confirmation popup, click the Confirm button to complete.

   Item	description
   Library name	Enter the name of the library.
   type	It is fixed to SCM and cannot be changed.
   Library URL	Enter the Git repository URL where the library is located.
   Default version	Enter the branch name or tag of the Git repository that contains the library.
   ID	Enter the ID to pull the library.
   password	Enter the password to pull the library.

   Table. Global Library Additional Input Items

Global Library Details

To view the detailed information of the global library, follow these steps.

1. On the Tool Details page, click the Global Library tab.
2. In the Global Library list, click the item you want to view in detail. The Global Library Details screen appears.

Modify Global Library

To modify the global library, follow these steps.

1. On the Tool Details page, click the Global Library tab.
2. From the Global Library list, click the item you want to view in detail. The Global Library Details screen appears.
3. Click the Edit button.
4. After editing the content, click the Save button.
5. Click the Confirm button in the confirmation popup to complete.

Delete Global Library

To delete the global library, follow these steps.

1. Tool Details on the page, click the Global Library tab.
2. Global Library Click the item you want to delete from the list. Global Library Detail screen appears.
3. Click the Delete button.
4. In the confirmation popup, click the Confirm button to complete.

Manage supported tenants/project groups

The user can manage the tenant or project group that will use the tool.

To manage supported tenants or project groups, follow these steps.

1. On the Tool Details page, click the Supported Tenant or Supported Information tab.

Add supported tenant/project group

To add a supported tenant or project group, follow these steps.

1. On the Tool Details page, click the Supported Tenant or Supported Information tab.
2. Click the Add button. The Add Tenant/Project Group popup window opens.
3. After entering the content, click the Save button.
4. In the confirmation popup, click the Confirm button to complete.

   Item	description
   Tenant/Project Group	Select the tenant/project group that will use the tool.
   Use status	Select whether to use the tool in this tenant/project group.
   Whether new creation is possible	Select whether to allow creating new repositories in this tenant/project group. This setting can only be configured for the tool categories listed below. SCM Repository Image Registry Code Quality Artifact Repository Helm Chart Repository Test Management Project Management Software

   Table. Additional Input Items for Supported Tenant/Project Group

Modify supported tenant/project group

To modify the supported tenant/project group, follow these steps.

1. On the Tool Details page, click the Supported Tenant or Support Information tab.
2. In the Supported Tenant or Supported Information list, select Usage status and New creation allowed to modify.

Transfer Management Tenant/Project Group

To transfer the management tenant/project group, follow the steps below.

1. On the Tool Details page, click the Supported Tenant or Supported Information tab.
2. Click the Transfer Management Tenant or Transfer Management Project Group button. The Transfer Management Tenant or Transfer Management Project Group popup window opens.
3. Select the target tenant or project group for transfer, then click the Save button.

Delete supported tenant/project group

To delete a managed tenant/project group, follow these steps.

1. On the Tool Details page, click the Supported Tenant or Supported Information tab.
2. Select the checkbox of the tenant/project group you want to delete.
3. Click the Delete button.
4. Click the Confirm button in the confirmation popup to complete.

Support K8S cluster management

The user can manage the K8S cluster where the tool will be used.

To manage the supported K8S cluster, follow these steps.

1. On the Tool Details page, click the Supported K8S Cluster tab.

Add supported K8S cluster

To add a supported K8S cluster, follow the steps below.

1. On the Tool Details page, click the Supported K8S Cluster tab.
2. On the Supported K8S Cluster page, click the Add button. The Add K8S Cluster popup window opens.
3. After entering the content, click the Save button.
4. In the confirmation popup, click the Confirm button to complete.

   Item	description
   K8S cluster	Select the K8S cluster to use with the tool.
   Use status	Select whether to use the tool in this tenant/project group.
   Whether new creation is possible	Select whether to allow creating new repositories in this tenant/project group. This setting can only be configured for the tool categories below. SCM Repository Image Registry Code Quality Artifact Repository Helm Chart Repository Test Management Project Management Software

   Table. Additional input fields for supported K8S clusters

Modify supported K8S cluster

To modify the supported K8S cluster, follow the steps below.

1. On the Tool Details page, click the Supported K8S Cluster tab.
2. In the Supported K8S Clusters list, select Usage Status and New Creation Availability to edit.

Delete supported K8S cluster

To delete the supported K8S cluster, follow these steps.

1. Click the Supported K8S Cluster tab on the Tool Details page.
2. Supported K8S clusters list, select the checkbox of the K8S cluster you want to delete.
3. Click the Delete button.
4. In the confirmation popup, click the Confirm button to complete.

Manage tool operators

To manage tool operators, follow the steps below.

1. On the Tool Details page, click the Tool Operator tab.

Add tool operator

To add a tool operator, follow these steps.

1. Tool Details page, click the Tool Operator tab.
2. Click the Add button. The Add Tool Operator popup opens.
3. Select the operator and click the Save button.
4. In the confirmation popup, click the Confirm button to complete.

Delete tool operator

To delete a tool operator, follow these steps.

1. Tool Details page, click the Tool Operator tab.
2. Select the checkbox for the item you want to delete from the tool administrator list.
3. Click the Delete button.
4. In the confirmation popup, click the Confirm button to complete.

Managing Jenkins Recommended Plugins

You can check the installed Jenkins version and whether recommended plugins are installed and their version information, and you can update and install the recommended plugins.

• Tool version: Jenkins version information
• Recommended plugins: installation status and version information

Check tool version and recommended plugin information

To check the tool version and recommended plugin information, follow these steps.

1. Tool Details page, click the Basic Information tab.
2. If there is recommended plugin information that requires installation or update, an informational popup appears, and clicking OK moves you to the Plugins tab.
3. On the Tool Details page, click the Plugin tab.
4. Check the entries for Tool Version, Recommended Plugins.

Install recommended plugins

To install the recommended plugin, follow these steps.

1. In the Recommended plugins area, select the Install button of the plugin you want to install.
2. In the Recommended Plugin Installation popup, select the OK button.
3. A popup appears indicating that the installation request has been completed, and the actual installation details can be viewed via the link in the popup.

Update recommended plugins

To update the recommended plugin, follow these steps.

1. In the Recommended plugins area, select the Update button of the plugin you want to update.
2. Select the Confirm button in the Recommended Plugin Update popup.
3. A popup appears indicating that the installation request has been completed, and the actual installation details can be viewed via the link in the popup.
4. You must restart Jenkins to apply the update you need to do so.

Delete tool

To uninstall the tool, follow these steps.

1. On the Tool page, click the tool you want to delete. You will be taken to the Tool Details page.
2. Click the Delete button.
3. In the confirmation popup, click the Confirm button to complete.