Innovation Version

      GitLab Runner Deployment and Testing

      Images and Software

      The following table lists the images required during installation. The version numbers are for reference only.


      If the Internet is unavailable in the environment, download the required images in advance. Download the images from the Docker Hub official website

      Using gitlab-runner.yaml to Start the Runner Container

      In the gitlab-runner.yaml file, change the image name. The following is an example of the .yaml file. Modify the file as required.

      vim gitlab-runner.yaml
      apiVersion: apps/v1
      kind: Deployment
        name: gitlab-runner
        namespace: default
        replicas: 1
            name: gitlab-runner
              name: gitlab-runner
            - args:
              - run
              image: gitlab/gitlab-runner:alpine-v14.4.0
              imagePullPolicy: IfNotPresent
              name: gitlab-runner
              - mountPath: /etc/gitlab-runner
                name: config
                readOnly: false
              - mountPath: /etc/ssl/certs
                name: cacerts
                readOnly: true
            restartPolicy: Always
            - hostPath:
                path: /etc/gitlab-runner
              name: config
            - hostPath:
                path: /etc/ssl/key
              name: cacerts

      Start the container.

      # kubectl apply -f gitlab-runner.yaml
      # kubectl get pod -A -o wide


      Creating a Container Project That Uses User Certificates for Authentication in GitLab

      1. Click New project.

      2. Select Create blank project.

      3. Enter a name for the project.

      4. Choose Settings > CI/CD > Runners > Expand.

      5. Record the address and token for registering the Runner.

      6. Import certificate files.

        Check and generate certificate files admin.crt, admin.key, and ca.crt on the master node.

        • View certificate information.

          # cat /etc/kubernetes/admin.conf


        • Generate the encrypted admin.crt.

          # echo "${client-certificate-data}" | base64 -d > admin.crt
        • Generate the encrypted admin.key.

          # echo "${client-key-data}" | base64 -d > admin.key
        • Obtain the CA certificate on the manager node.

          # cp /etc/kubernetes/pki/ca.crt ./
      7. Import the three certificate files to the GitLab Runner container on the node where the Runner is running.

        Note: To import the certificate files, check the node where the GitLab Runner is running, copy the certificate files to the node, and run the isula cp command to import the certificate files.

        # isula cp admin.crt [Container ID]:Storage path
        # isula cp admin.key [Container ID]:Storage path
        # isula cp ca.crt [Container ID]:Storage path

        Note: The isula cp command can copy only one file at a time.


      Registering the GitLab Runner

      Perform registration in the GitLab Runner container. Currently, interactive registration is used. Obtain the registration information from GitLab. Choose GitLab > Group runners > Settings > CI/CD > Runners.


      Upload the prepared gitlab-runner-helper image to the private image repository in advance, go to the GitLab Runner container, and modify the configuration file.

      # cd /etc/gitlab-runner
      # mkdir kubessl
      # cp /home/admin.crt /etc/gitlab-runner/kubessl
      # cp /home/ca.crt /etc/gitlab-runner/kubessl
      # cp /home/admin.key /etc/gitlab-runner/kubessl
      # vim /etc/gitlab-runner/config.toml

      Adding the DNS Record of the GitLab Container to the Manager Node

      1. View the IP address of the GitLab container.

        # kubectl get pods –Aowide
      2. Add the IP address of the GitLab container to the Kubernetes DNS configuration file.

        # kubectl edit configmaps coredns -n kube-system


      1. Restart the CoreDNS service.

        # kubectl scale deployment coredns -n kube-system --replicas=0
        # kubectl scale deployment coredns -n kube-system --replicas=2

      GitLab Running Testing

      Return to the GitLab web IDE and choose CI/CD > Editor > Create new CI/CD pipeline.

      • Compile the YAML file as follows:


      • Choose Pipelines and view the status.

      Bug Catching

      Buggy Content

      Bug Description

      Submit As Issue

      It's a little complicated....

      I'd like to ask someone.


      Just a small problem.

      I can fix it online!

      Bug Type
      Specifications and Common Mistakes

      ● Misspellings or punctuation mistakes;

      ● Incorrect links, empty cells, or wrong formats;

      ● Chinese characters in English context;

      ● Minor inconsistencies between the UI and descriptions;

      ● Low writing fluency that does not affect understanding;

      ● Incorrect version numbers, including software package names and version numbers on the UI.


      ● Incorrect or missing key steps;

      ● Missing prerequisites or precautions;

      ● Ambiguous figures, tables, or texts;

      ● Unclear logic, such as missing classifications, items, and steps.


      ● Technical principles, function descriptions, or specifications inconsistent with those of the software;

      ● Incorrect schematic or architecture diagrams;

      ● Incorrect commands or command parameters;

      ● Incorrect code;

      ● Commands inconsistent with the functions;

      ● Wrong screenshots.

      Risk Warnings

      ● Lack of risk warnings for operations that may damage the system or important data.

      Content Compliance

      ● Contents that may violate applicable laws and regulations or geo-cultural context-sensitive words and expressions;

      ● Copyright infringement.

      How satisfied are you with this document

      Not satisfied at all
      Very satisfied
      Click to create an issue. An issue template will be automatically generated based on your feedback.
      Bug Catching
      编组 3备份