GitLab Runner Operator 설치

Red Hat OpenShift에 설치

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed

GitLab Runner Operator를 사용하여 Red Hat OpenShift v4 이상에 GitLab Runner를 설치할 수 있습니다. 이 Operator는 OpenShift의 웹 콘솔에 포함된 OperatorHub의 stable 채널에서 사용할 수 있습니다. 설치 후에 새로 설치된 GitLab Runner 인스턴스를 사용하여 GitLab CI/CD 작업을 실행할 수 있습니다. 각 CI/CD 작업은 별도의 pod에서 실행됩니다.

Prerequisites

  • 관리자 권한이 있는 OpenShift 4.x 클러스터
  • GitLab Runner 등록 토큰

OpenShift Operator 설치

먼저 OpenShift Operator를 설치해야 합니다.

  1. OpenShift UI에 로그인하고 관리자 권한이 있는 사용자로 로그인합니다.
  2. 왼쪽 패널에서 Operators를 클릭한 후 OperatorHub를 클릭합니다.

  3. 메인 패널에서 All Items 아래에서 GitLab Runner 키워드로 검색합니다.

    GitLab Operator

  4. 설치하려면 GitLab Runner Operator를 클릭합니다.
  5. GitLab Runner Operator 요약 페이지에서 Install을 클릭합니다.
  6. 설치 Operator 페이지에서:
    1. Update Channel에서 stable를 선택합니다.
    2. Installed Namespace에서 원하는 네임스페이스를 선택하고 Install을 클릭합니다.

    GitLab Operator Install Page

설치된 Operator 페이지에서 GitLab Operator의 상태가 Succeeded로 변경되면 준비가 완료된 것입니다.

GitLab Operator Install Status

Kubernetes에 설치

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed

GitLab Runner Operator를 사용하여 Kubernetes v1.21 이상에 GitLab Runner를 설치할 수 있습니다. 이 Operator는 OperatorHub.io의 stable 채널에서 사용할 수 있습니다. 설치 후에 새로 설치된 GitLab Runner 인스턴스를 사용하여 GitLab CI/CD 작업을 실행할 수 있습니다. 각 CI/CD 작업은 별도의 pod에서 실행됩니다.

Prerequisites

  • Kubernetes v1.21 이상
  • Cert manager v1.7.1

Kubernetes Operator 설치

OperatorHub.io에서 안내에 따라 작업을 수행합니다.

  1. 선행 작업을 설치합니다.
  2. 오른쪽 상단에서 Install을 선택하고 OLM과 Operator를 설치하는 지침을 따릅니다.

GitLab Runner 설치

  1. Runner 인증 토큰을 획득합니다. 다음 중 하나를 선택할 수 있습니다:
    • 공유, 그룹, 또는 프로젝트 러너를 생성합니다.
    • config.toml 파일에서 Runner 인증 토큰을 찾습니다. Runner 인증 토큰은 glrt- 접두사를 가집니다.

  2. GitLab Runner 토큰을 포함한 시크릿 파일을 생성합니다: 

    cat > gitlab-runner-secret.yml << EOF
apiVersion: v1
kind: Secret
metadata:
  name: gitlab-runner-secret
type: Opaque
stringData:
  runner-token: REPLACE_ME # 여러분의 프로젝트 runner 토큰
EOF

  3. 다음 구성을 포함한 Custom Resource Definition (CRD) 파일을 생성합니다. 

    cat > gitlab-runner.yml << EOF
apiVersion: apps.gitlab.com/v1beta2
kind: Runner
metadata:
  name: gitlab-runner
spec:
  gitlabUrl: https://gitlab.example.com
  buildImage: alpine
  token: gitlab-runner-secret
EOF

  4. 이제 다음 명령을 실행하여 CRD 파일을 적용합니다: 

    kubectl apply -f gitlab-runner.yml

  5. 다음 명령으로 GitLab Runner가 설치되었는지 확인합니다: 

    kubectl get runner
NAME             AGE
gitlab-runner    5m

  6. 러너 pod도 표시됩니다: 

    kubectl get pods
NAME                             READY   STATUS    RESTARTS   AGE
gitlab-runner-bf9894bdb-wplxn    1/1     Running   0          5m

OpenShift를 위한 다른 버전의 GitLab Runner Operator 설치

Red Hat OperatorHub에서 사용 가능한 GitLab Runner Operator 버전을 사용하고 싶지 않은 경우 다른 버전을 설치할 수 있습니다.

공식적으로 현재 사용 가능한 Operator 버전을 확인하려면 gitlab-runner-operator 리포지토리의 tags를 확인합니다. Operator가 실행 중인 GitLab Runner 버전을 확인하려면 관심 있는 커밋이나 태그의 APP_VERSION 파일의 내용을 확인합니다. 예를 들어, https://gitlab.com/gitlab-org/gl-openshift/gitlab-runner-operator/-/blob/1-17-stable/APP_VERSION을 확인할 수 있습니다.

특정 버전을 설치하려면 다음과 같이 catalogsource.yaml 파일을 생성하고 <VERSION>을 태그나 특정 커밋으로 대체합니다:

note
특정 커밋을 위한 이미지를 사용하는 경우 태그 형식은 v0.0.1-<COMMIT>입니다. 예: registry.gitlab.com/gitlab-org/gl-openshift/gitlab-runner-operator/gitlab-runner-operator-catalog-source:v0.0.1-f5a798af.
apiVersion: operators.coreos.com/v1alpha1
kind: CatalogSource
metadata:
  name: gitlab-runner-catalog
  namespace: openshift-marketplace
spec:
  sourceType: grpc
  image: registry.gitlab.com/gitlab-org/gl-openshift/gitlab-runner-operator/gitlab-runner-operator-catalog-source:<VERSION>
  displayName: GitLab Runner Operators
  publisher: GitLab Community

다음 명령을 사용하여 CatalogSource를 생성합니다: 

oc apply -f catalogsource.yaml

잠시 후 새 Runner가 OpenShift 클러스터의 OperatorHub 섹션에 표시됩니다.

Kubernetes 클러스터에서 오프라인 환경에서 GitLab Runner Operator 설치하기

필수 조건:

  • 설치 프로세스에서 필요한 이미지에 접근할 수 있어야 합니다.

설치 중에 컨테이너 이미지를 가져오려면 GitLab Runner Operator가 외부 네트워크의 공개 인터넷에 연결해야 합니다. 오프라인 환경에 Kubernetes 클러스터를 설치한 경우, 로컬 이미지 레지스트리나 로컬 패키지 저장소를 사용하여 이미지나 패키지를 설치 중에 가져올 수 있습니다.

로컬 저장소는 다음 이미지를 제공해야 합니다:

이미지 기본 값
GitLab Runner Operator 이미지 registry.gitlab.com/gitlab-org/gl-openshift/gitlab-runner-operator/gitlab-runner-operator:vGITLAB_RUNNER_OPERATOR_VERSION
GitLab Runner 및 GitLab Runner Helper 이미지 이러한 이미지는 GitLab Runner UBI 이미지 레지스트리에서 다운로드되며 Runner Custom Resources를 설치할 때 사용됩니다. 사용하는 버전은 요구 사항에 따라 달라집니다.
RBAC Proxy 이미지 registry.gitlab.com/gitlab-org/gl-openshift/gitlab-runner-operator/openshift4/ose-kube-rbac-proxy:v4.13.0

  1. 연결 끊긴 네트워크 환경에서 다운로드한 소프트웨어 패키지와 컨테이너 이미지를 호스팅하기 위해 로컬 레지스트리나 저장소를 설정합니다. 다음을 사용할 수 있습니다:

    • 컨테이너 이미지를 위한 Docker 레지스트리.
    • Kubernetes 이진 파일과 종속성을 위한 로컬 패키지 레지스트리.

  2. GitLab Runner Operator v1.23.2 이상을 위해, 최신 버전의 operator.k8s.yaml 파일을 다운로드합니다: 

    curl -O "https://gitlab.com/gitlab-org/gl-openshift/gitlab-runner- 
operator/-/releases/vGITLAB_RUNNER_OPERATOR_VERSION/downloads/operator.k8s.yaml"

  3. operator.k8s.yaml 파일에서 다음 URL을 업데이트합니다:

    • GitLab Runner Operator 이미지
    • RBAC Proxy 이미지

  4. 업데이트된 operator.k8s.yaml 파일을 설치합니다: 

    kubectl apply -f PATH_TO_UPDATED_OPERATOR_K8S_YAML
GITLAB_RUNNER_OPERATOR_VERSION = 1.23.2+

오퍼레이터 제거

Red Hat OpenShift에서 제거

  1. Runner CRD를 삭제합니다: 

    kubectl delete -f gitlab-runner.yml

  2. secret를 삭제합니다: 

    kubectl delete -f gitlab-runner-secret.yml

  3. 클러스터에서 웹 콘솔을 사용하여 클러스터에서 오퍼레이터 삭제하는 Red Hat 문서의 지침을 따릅니다.

Kubernetes에서 제거

  1. Runner CRD를 삭제합니다: 

    kubectl delete -f gitlab-runner.yml

  2. secret를 삭제합니다: 

    kubectl delete -f gitlab-runner-secret.yml

  3. 오퍼레이터 구독을 삭제합니다: 

    kubectl delete subscription my-gitlab-runner-operator -n operators

  4. 설치된 CSV의 버전을 확인합니다: 

    kubectl get clusterserviceversion -n operators
NAME                            DISPLAY         VERSION   REPLACES   PHASE
gitlab-runner-operator.v1.7.0   GitLab Runner   1.7.0                Succeeded

  5. CSV를 삭제합니다: 

    kubectl delete clusterserviceversion gitlab-runner-operator.v1.7.0 -n operators

구성

OpenShift에서 GitLab Runner를 구성하려면 OpenShift에서 GitLab Runner 구성 페이지를 참조하세요.