튜토리얼: 구글 쿠버네티스 엔진(GKE)을 사용하도록 GitLab 러너 구성

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

이 튜토리얼에서는 GitLab 러너를 구성하여 Google 쿠버네티스 엔진(GKE)을 사용하여 작업을 실행하는 방법에 대해 설명합니다.

이 튜토리얼에서는 GitLab 러너를 표준 클러스터 모드로 구성합니다.

GKE를 사용하도록 GitLab 러너를 구성하려면 다음을 수행합니다:

환경 설정을 설정합니다.
클러스터 생성 및 연결을 수행합니다.
쿠버네티스 오퍼레이터 설치 및 구성을 수행합니다.
선택 사항. 구성이 성공적으로 완료되었는지 확인합니다.

시작하기 전에

GKE를 사용하도록 GitLab 러너를 구성하기 전에 다음이 필요합니다:

관리자 또는 소유자 역할이있는 프로젝트가 있어야 합니다. 프로젝트가 없는 경우 만들 수 있습니다.
프로젝트 러너 등록 토큰 획득해야 합니다.
GitLab 러너를 설치해야 합니다.

환경 설정

GKE에서 GitLab 러너를 구성하고 사용하기 위한 도구를 설치합니다.

Google Cloud CLI 설치 및 구성합니다. Google Cloud CLI를 사용하여 클러스터에 연결합니다.
kubectl 설치 및 구성합니다. kubectl을 사용하여 로컬 환경에서 원격 클러스터와 통신합니다.

클러스터 생성 및 연결

이 단계에서는 클러스터를 생성하고 연결하는 방법에 대해 설명합니다. 클러스터에 연결한 후 kubectl을 사용하여 상호 작용합니다.

Google Cloud 플랫폼에서 표준 클러스터를 생성합니다.

kubectl 인증 플러그인을 설치합니다:

 gcloud components install gke-gcloud-auth-plugin

클러스터에 연결합니다:

 gcloud container clusters get-credentials CLUSTER_NAME --zone=CLUSTER_LOCATION

클러스터 구성을 확인합니다:
```
 kubectl config view
```
클러스터에 연결되었는지 확인합니다:
```
 kubectl config current-context
```

쿠버네티스 오퍼레이터 설치 및 구성

이제 클러스터가 준비되었으므로 쿠버네티스 오퍼레이터를 설치하고 구성할 준비가 되었습니다.

cert-manager를 설치합니다. 이미 인증서 관리자를 설치했으면이 단계를 건너 뜁니다:
```
 kubectl apply -f https://github.com/jetstack/cert-manager/releases/download/v1.7.1/cert-manager.yaml
```

클러스터에서 실행되는 Kubernetes Operator를 관리하는 도구 인 Operator Lifecycle Manager (OLM)을 설치합니다:

 curl --silent --location "https://github.com/operator-framework/operator-lifecycle-manager/releases/download/v0.24.0/install.sh" \
 | bash -s v0.24.0

Kubernetes Operator를 설치합니다:

 kubectl create -f https://operatorhub.io/install/gitlab-runner-operator.yaml

Operator Lifecycle Manager v0.25.0 및 그 이상의 버전. 고유한 인증서 관리자를 추가하거나 cert-manager를 사용합니다.

고유 인증서 공급 업체를 추가하려면:

gitlab-runner-operator.yaml에서 env 설정에서 인증서 네임스페이스 및 인증서 이름을 정의합니다:

cat > gitlab-runner-operator.yaml << EOF
apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
name: gitlab-runner-operator
namespace: gitlab-ns
spec:
channel: stable
name: gitlab-runner-operator
source: operatorhubio-catalog
ca: webhook-server-cert
sourceNamespace: olm
config:
env:
   - name: CERTIFICATE_NAMESPACE
   value: cert_namespace_desired_value
   - name: CERTIFICATE_NAME
   value: cert_name_desired_value
EOF

gitlab-runner-operator.yaml을 Kubernetes 클러스터에 적용합니다:
```
kubectl apply -f gitlab-runner-operator.yaml
```

cert-manager를 사용하려면:

default 네임스페이스에 Certificate 및 Issuer를 설치하도록 certificate-issuer-install.yaml을 사용합니다. 또한 연산자 설치도 포함합니다:

cat > certificate-issuer-install.yaml << EOF
apiVersion: v1
kind: Namespace
metadata:
labels:
   app.kubernetes.io/component: controller-manager
   app.kubernetes.io/managed-by: olm
   app.kubernetes.io/name: gitlab-runner-operator
name: gitlab-runner-system
---
apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
name: gitlab-runner-serving-cert
namespace: gitlab-runner-system
spec:
dnsNames:
- gitlab-runner-webhook-service.gitlab-runner-system.svc
- gitlab-runner-webhook-service.gitlab-runner-system.svc.cluster.local
issuerRef:
  kind: Issuer
  name: gitlab-runner-selfsigned-issuer
secretName: webhook-server-cert
---
apiVersion: cert-manager.io/v1
kind: Issuer
metadata:
name: gitlab-runner-selfsigned-issuer
namespace: gitlab-runner-system
spec:
selfSigned: {}
EOF

certificate-issuer-install.yaml을 Kubernetes 클러스터에 적용합니다:
```
kubectl create -f certificate-issuer-install.yaml
```

GitLab 프로젝트에서 runner-registration-token을 포함하는 시크릿을 생성합니다:

 cat > gitlab-runner-secret.yml << EOF
 apiVersion: v1
 kind: Secret
 metadata:
   name: gitlab-runner-secret
 type: Opaque
 stringData:
   runner-token: YOUR_RUNNER_AUTHENTICATION_TOKEN
 EOF

시크릿을 적용합니다:

 kubectl apply -f gitlab-runner-secret.yml

사용자 정의 리소스 정의 파일을 생성하고 다음 정보를 포함합니다:

 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

사용자 정의 리소스 정의 파일을 적용합니다:
```
 kubectl apply -f gitlab-runner.yml
```

이것으로 구글 쿠버네티스 엔진(GKE)을 사용하도록 GitLab 러너를 구성했습니다. 다음 단계에서 구성이 작동하는지 확인할 수 있습니다.

구성 확인

GKE 클러스터에서 러너가 실행 중인지 확인하려면 다음 중 하나를 수행할 수 있습니다:

다음 명령을 사용합니다
```
kubectl get pods
```
다음 출력이 표시되어야 합니다. 이를 통해 러너가 GKE 클러스터에서 실행 중임을 보여줍니다:
```
NAME                             READY   STATUS    RESTARTS   AGE
gitlab-runner-hash-short_hash    1/1     Running   0          5m
```
GitLab에서 작업 로그를 확인합니다:
1. 왼쪽 사이드 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 빌드 > 작업을 선택하고 작업을 찾습니다.
3. 작업 로그를 보려면 작업 상태를 선택합니다.

튜토리얼: 구글 쿠버네티스 엔진(GKE)을 사용하도록 GitLab 러너 구성

시작하기 전에

환경 설정

클러스터 생성 및 연결

쿠버네티스 오퍼레이터 설치 및 구성

구성 확인

도움말

기능 사용 가능성과 제품 평가판

도움받기