The page has been translated by Gen AI.

K8S Cluster

Users can register a K8S cluster in DevOps Console and deploy various applications through DevOps Console.

Users can add, edit, and delete K8S clusters and namespaces. Added K8S clusters and namespaces can be selected and used in various menus such as project creation (Getting Started with Project Creation), helm install (Getting Started with Helm Install), etc.

Reference
To use the K8S cluster from menus such as project creation and helm install, you must have permissions on the namespace.

Getting Started with a K8S Cluster

To begin managing the K8S cluster, follow these steps.

  1. Click the Admin icon at the top right of the Main page. Navigate to the Tenant Dashboard page.
  2. From the left menu, click the Deploy Target > K8S Cluster menu. You will be taken to the K8S Cluster page.

Add a K8S cluster

To add a K8S cluster, follow the steps below.

  1. Click the Admin 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 Deploy Target > K8S Cluster menu. You will be taken to the K8S Cluster page.
  3. On the K8S Cluster page, click the Add button. You will be taken to the Add K8S Cluster page.
  4. Add K8S Cluster page, after entering the basic information and connection details, click the Connection Test button.
  5. After selecting the Helm version, click the Save button.
    ItemExplanation
    K8S cluster namePlease enter the cluster name.
    K8S Cluster IDEnter the cluster ID.
    The cluster ID is a unique identifier used to distinguish clusters; please determine and enter it yourself.
    CA CertificateEnter the server’s certificate information to be used for configuring the kubeconfig file
    • Enter the contents of clusters[0].cluster.certificate-authority-data from the existing kubeconfig file.
    • Contact the cluster provider (administrator) and then enter it.
    • If verification is not possible, enter a temporary value (e.g., temp) and replace it with the correct value once verification is possible.
    Authentication methodSelect the admin token method.
    API server URLEnter the Kubernetes API Server address.
    admin tokenEnter the Token with Admin privileges to use for configuring the kubeconfig file.
    Please refer to Check Cluster Admin Token.
    Helm versionSelect Helm version
    • A list of Helm versions available for the K8S cluster version is displayed.
    Table. Add K8S Cluster – Add using admin token authentication
    ItemExplanation
    Authentication methodSelect the client certificate method.
    API server URLEnter the Kubernetes API Server address.
    client certificateEnter the client certificate information.
    Client KeyEnter the client Key information.
    Table. Add K8S Cluster - Item for adding by authenticating with a client certificate
    ItemExplanation
    Authentication methodSelect the kubeconfig file upload method.
    kubeconfig fileBrowse button to select the kubeconfig file
    • Only files with the .yml or .yaml extension can be uploaded.
    • If the file is uploaded successfully, the CA Certificate, API server URL, user, admin token, or client certificate will be populated automatically.
    API server URLSelect the Kubernetes API Server address.
    userSelect the user to authenticate
    • Depending on the selected user, the admin token or client certificate information is displayed below
    Table. Adding K8S Cluster - Adding via kubeconfig file upload item

Managing a K8S cluster

Modify K8S cluster

To modify the K8S cluster, follow these steps.

  1. Click the Admin 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 Deploy Target > K8S Cluster menu. You will be taken to the K8S Cluster page.
  3. From the list on the K8S Cluster page, click the K8S cluster. You will be taken to the K8S Cluster Details page of the selected K8S cluster.
  4. On the K8S Cluster Details page, click the Edit button.
  5. After editing the information, click the Connection Test button.
  6. After selecting the Helm version, click the Save button.

Delete K8S cluster

To delete a K8S cluster, follow these steps.

  1. Click the Admin 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 Deploy Target > K8S Cluster menu. You will be taken to the K8S Cluster page.
  3. From the list on the K8S Cluster page, click the K8S cluster. You will be taken to the K8S Cluster Details page of the selected K8S cluster.
  4. On the K8S Cluster Details page, click the Delete button.
  5. Click the Confirm button in the confirmation popup to complete the deletion.

Add a member to a K8S cluster

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

  1. Click the Admin icon at the top right of the Main page. Navigate to the Tenant Dashboard page.
  2. From the left menu, click the Deploy Target > K8S Cluster menu. You will be taken to the K8S Cluster page.
  3. In the list on the K8S Cluster page, click the K8S cluster. You will be taken to the K8S Cluster Details page of the selected K8S cluster.
  4. On the K8S Cluster Details page, click the Members tab.
  5. When you click the Add button in the Member tab, the Add Member popup window opens.
  6. Add Member In the popup, enter the email address and click the Search icon.
  7. Click the Add button to add the member to the list below.
  8. After selecting the permission, click the Save button to complete adding the member.

Delete K8S cluster member

To delete a K8S cluster member, follow these steps.

  1. Click the Admin 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 Deploy Target > K8S Cluster menu. You will be taken to the K8S Cluster page.
  3. From the list on the K8S cluster page, click the K8S cluster. You will be taken to the K8S cluster details page of the selected K8S cluster.
  4. On the K8S Cluster Details page, click the Members tab.
  5. In the Member tab, select the checkbox of the user you want to delete.
  6. Click the Delete button to remove the selected user from the members.

Managing K8S Cluster Permission Requests

To approve or reject a K8S cluster access request, follow these steps.

  1. Click the Admin 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 Deploy Target > K8S Cluster menu. You will be taken to the K8S Cluster page.
  3. Click the K8S cluster permission request item for the cluster whose permission request you want to approve. The displayed number indicates the number of permissions requested.
  4. K8S Cluster Permission Request Approval The popup window opens.
  5. Click the application you want to approve or reject.
  6. After entering your comment, click the Approve or Reject button.
Note
A comment is required to reject a permission request.

View K8S cluster permission approval history

To view the K8S cluster permission request approval history, follow these steps.

  1. Click the Admin 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 Deploy Target > K8S Cluster menu. You will be taken to the K8S Cluster page.
  3. From the list on the K8S Cluster page, click the K8S Cluster. You will be taken to the K8S Cluster Details page of the selected K8S Cluster.
  4. Click the Approval History tab. The approval history list appears.
Note
Access is allowed only for users with Administrator privileges on the K8S cluster.

Managing namespaces

Notice
  • To use the K8S cluster from menus such as project creation and helm install, you must have permissions on the namespace.
  • You cannot create a namespace in the actual K8S cluster. You can only import an already created namespace into the DevOps Console.

Import namespace

To import the namespace, follow these steps.

  1. Click the Admin 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 Deploy Target > K8S Cluster menu. You will be taken to the K8S Cluster page.
  3. On the K8S Cluster page, click the K8S cluster from the list. You will be taken to the K8S Cluster Details page of the selected K8S cluster.
  4. Click the Namespace tab. The namespace list appears.
  5. On the Namespace tab screen, clicking the Import button opens the Import Namespace popup.
  6. Namespace Import In the popup window, select the namespace and click the Save button to complete the namespace import.

Delete namespace

Notice
Only the namespace information managed by the DevOps Console is deleted, and the actual namespace in the cluster is not deleted.

To delete a namespace, follow these steps.

  1. Click the Admin 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 Deploy Target > K8S Cluster menu. You will be taken to the K8S Cluster page.
  3. On the K8S cluster page, click the K8S cluster from the list. You will be taken to the K8S cluster details page of the selected K8S cluster.
  4. Click the Namespace tab. The namespace list appears.
  5. On the Namespace tab screen, clicking a namespace navigates to the Namespace Details page.
  6. On the Namespace Details page, click the Delete button to complete the namespace deletion.

Adding a namespace member

To add a namespace member, follow these steps.

  1. Main page, click the Admin icon at the top right. It navigates to the Tenant Dashboard page.
  2. From the left menu, click the Deploy Target > K8S Cluster menu. You will be taken to the K8S Cluster page.
  3. From the list on the K8S Cluster page, click the K8S cluster. You will be taken to the K8S Cluster Details page of the selected K8S cluster.
  4. Click the Namespace tab. The namespace list appears.
  5. Namespace tab screen, when you click the namespace, you are taken to the Namespace Details page.
  6. Namespace Details page, when you click the Members tab, the namespace member list appears.
  7. When you click the Add button, the Add Member popup opens.
  8. In the Add Member popup, enter the email address and click the Search icon.
  9. Click the Add button to add the member to the list below.
  10. After selecting the permission, click the Save button to complete adding the member.

Delete namespace member

To delete a namespace member, follow these steps.

  1. Click the Admin 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 Deploy Target > K8S Cluster menu. You will be taken to the K8S Cluster page.
  3. On the K8S Cluster page, click the K8S cluster from the list. You will be taken to the K8S Cluster Details page of the selected K8S cluster.
  4. Click the Namespace tab. The namespace list appears.
  5. On the Namespace tab screen, clicking the namespace takes you to the Namespace Details page.
  6. Namespace Details page, when you click the Members tab, the namespace member list appears.
  7. Select the checkbox of the user you want to delete from the list.
  8. Click the Delete button to remove the selected user from the members.

Manage namespace permission requests

To approve or reject a namespace permission request, follow these steps.

  1. Click the Admin 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 Deploy Target > K8S Cluster menu. You will be taken to the K8S Cluster page.
  3. From the list on the K8S Cluster page, click the Namespace Permission Request item for the cluster whose permission request you want to approve. The displayed number indicates the number of permission requests.
  4. Namespace Permission Request Approval A popup window opens.
  5. Select the checkbox for the application you want to approve or reject.
  6. After entering your comment, click the Approve or Reject button.
Reference
Providing a comment is required to reject a permission request.

View namespace permission request approval history

To view the namespace permission request approval history, follow these steps.

  1. Click the Admin 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 Deploy Target > K8S Cluster menu. You will be taken to the K8S Cluster page.
  3. In the list on the K8S Cluster page, click the K8S cluster. You will be taken to the K8S Cluster Details page of the selected K8S cluster.
  4. Namespace tab, click it. The namespace list appears.
  5. On the Namespace tab screen, clicking a namespace takes you to the Namespace Details page.
  6. Namespace Details page, when you click the Approval History tab, the approval history list appears.

Managing Ingress Domains

information
  • This is reference information that is managed only in the DevOps Console.
  • The registered information is displayed so that users can refer to it when creating a project or performing a Helm install using the cluster.

Add Ingress Domain

To add an ingress domain, follow these steps.

  1. Click the Admin 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 Deploy Target > K8S Cluster menu. You will be taken to the K8S Cluster page.
  3. On the K8S cluster page, click the K8S cluster from the list. You will be taken to the K8S cluster details page of the selected K8S cluster.
  4. Click the Ingress Domain tab. The Ingress Domain list appears.
  5. Ingress Domain tab screen, when you click the Add button, the Add Ingress Domain Information popup opens.
  6. Add Ingress Domain Information Enter the information in the popup window and click the Save button to complete adding the ingress domain.
    ItemExplanation
    Node selectorEnter the node selector.
    It is composed of a key that includes a prefix separated by the first slash (/) of the input value, and its corresponding value.
    The prefix is optional.
    e.g., kubernetes.io/nodetype: app
    Proxy IPEnter the Proxy Server IP or Proxy Server LoadBalancer IP.
    Ingress domainEnter the domain that the application will use by default.
    Ingress classEnter the Ingress controller class.
    Table. Ingress Domain Additional Input Items

Modify Ingress Domain

To modify the Ingress domain, follow these steps.

  1. Click the Admin 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 Deploy Target > K8S Cluster menu. You will be taken to the K8S Cluster page.
  3. From the list on the K8S Cluster page, click the K8S cluster. You will be taken to the K8S Cluster Details page of the selected K8S cluster.
  4. Click the Ingress Domain tab. The Ingress Domain list appears.
  5. On the Ingress Domain tab screen, when you click the Ingress Domain you want to edit, the Edit Ingress Domain Information popup opens.
  6. Edit Ingress Domain Information In the popup window, modify the information and click the Save button to complete the Ingress domain edit.

Delete Ingress Domain

To modify the Ingress domain, follow these steps.

  1. Click the Admin 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 Deploy Target > K8S Cluster menu. You will be taken to the K8S Cluster page.
  3. From the list on the K8S Cluster page, click the K8S cluster. You will be taken to the K8S Cluster Details page of the selected K8S cluster.
  4. Ingress Domain Click the tab. Ingress Domain list appears.
  5. On the Ingress Domain tab, select the checkbox of the Ingress Domain you want to delete.
  6. On the Ingress Domain tab screen, click the Delete button to delete the selected ingress domain.
Register User-installed Jenkins Tool
Verify Cluster Admin Token