Civo Kubernetes 클러스터 생성

모든 새로운 Civo 계정은 여기에서 $250의 크레딧을 받아 Civo Kubernetes와의 GitLab 통합을 시작할 수 있습니다. 또한 Civo Kubernetes 클러스터에 GitLab을 설치하기 위해 마켓플레이스 앱을 사용할 수도 있습니다.

인프라스트럭처의 코드 (IaC)를 통해 Civo Kubernetes에서 새 클러스터를 생성하는 방법을 배워보세요. 이 프로세스는 Civo 및 Kubernetes Terraform 프로바이더를 사용하여 Civo Kubernetes 클러스터를 생성합니다. GitLab 에이전트를 사용하여 클러스터를 GitLab에 연결합니다.

필수 준비 사항:

단계:

  1. 예제 프로젝트 가져오기.
  2. Kubernetes에 대한 에이전트 등록.
  3. 프로젝트 구성.
  4. 클러스터 프로비저닝.

예제 프로젝트 가져오기

GitLab을 사용하여 인프라스트럭처의 코드를 통해 클러스터를 생성하려면 클러스터를 관리할 프로젝트를 생성해야 합니다. 이 튜토리얼에서는 샘플 프로젝트를 시작으로 필요에 따라 수정합니다.

URL로부터 예제 프로젝트를 가져오려면 다음을 수행하세요:

  1. GitLab에서 왼쪽 사이드바에서 검색 또는 이동을 선택합니다.
  2. 모든 내 프로젝트 보기를 선택합니다.
  3. 페이지 오른쪽에서 새 프로젝트를 선택합니다.
  4. 프로젝트 가져오기를 선택합니다.
  5. 저장소 위치별로 가져오기를 선택합니다.
  6. Git 저장소 URL에 https://gitlab.com/civocloud/gitlab-terraform-civo.git을 입력합니다.
  7. 필드를 완성하고 프로젝트 만들기를 선택합니다.

이 프로젝트는 다음을 제공합니다:

에이전트 등록

Kubernetes용 GitLab 에이전트를 생성하려면:

  1. 왼쪽 사이드바에서 운영 > Kubernetes 클러스터를 선택합니다.
  2. 클러스터 연결을 선택합니다.
  3. 에이전트 선택 드롭다운 목록에서 civo-agent를 선택하고 등록을 선택합니다.
  4. GitLab은 에이전트에 대한 액세스 토큰을 생성합니다. 나중에 이 비밀 토큰이 필요하므로 안전하게 보관하세요.
  5. GitLab은 에이전트 서버(KAS)에 대한 주소도 제공합니다. 이 주소도 나중에 필요합니다.

프로젝트 구성

프로젝트를 구성하려면 CI/CD 환경 변수를 사용하세요.

필수 구성:

  1. 왼쪽 사이드바에서 설정 > CI/CD를 선택합니다.
  2. 변수를 확장합니다.
  3. 변수 CIVO_TOKEN을 Civo 계정에서 받은 토큰으로 설정합니다.
  4. 변수 TF_VAR_agent_token을 이전 작업에서 받은 에이전트 토큰으로 설정합니다.
  5. 변수 TF_VAR_kas_address를 이전 작업에서 받은 에이전트 서버 주소로 설정합니다.

img/variables_civo.png

선택 구성:

파일 variables.tf에는 다음과 같이 필요에 따라 재정의할 수 있는 다른 변수가 포함되어 있습니다.

  • TF_VAR_civo_region: 클러스터의 지역을 설정합니다.
  • TF_VAR_cluster_name: 클러스터의 이름을 설정합니다.
  • TF_VAR_cluster_description: 클러스터에 대한 설명을 설정합니다. Civo 대시보드에서 프로젝트에 대한 참조를 만들기 위해 이 값을 $CI_PROJECT_URL로 설정합니다. 이 값은 Civo 대시보드에서 볼 수 있는 클러스터를 프로비저닝한 프로젝트를 확인하는 데 도움이 됩니다.
  • TF_VAR_target_nodes_size: 클러스터에 사용할 노드의 크기를 설정합니다.
  • TF_VAR_num_target_nodes: Kubernetes 노드의 수를 설정합니다.
  • TF_VAR_agent_version: GitLab 에이전트의 버전을 설정합니다.
  • TF_VAR_agent_namespace: Kubernetes 에이전트를위한 네임스페이스를 설정합니다.

추가 리소스 옵션에 대한 자세한 내용은 Civo Terraform 프로바이더와 Kubernetes Terraform 프로바이더 문서를 참조하세요.

클러스터 프로비저닝

프로젝트를 구성한 후, 클러스터 프로비저닝을 수동으로 트리거하세요. GitLab에서:

  1. 왼쪽 사이드바에서 빌드 > 파이프라인을 선택합니다.
  2. 새 파이프라인을 선택합니다.
  3. 파이프라인 실행을 선택하고 목록에서 새로 생성된 파이프라인을 선택합니다.
  4. 배포 작업 옆에서 수동 작업을 선택합니다 ().

파이프라인이 성공적으로 완료되면 새 클러스터를 확인할 수 있습니다:

  • Civo 대시보드: Kubernetes 탭에서 확인할 수 있습니다.
  • GitLab: 프로젝트의 사이드바에서 운영 > Kubernetes 클러스터를 선택합니다.

TF_VAR_civo_region 변수를 설정하지 않은 경우 클러스터는 ‘lon1’ 지역에 생성됩니다.

클러스터 사용

클러스터를 프로비저닝한 후에는 GitLab에 연결되어 배포를 위해 준비된 상태입니다. 연결을 확인하려면:

  1. 왼쪽 사이드바에서 운영 > Kubernetes 클러스터를 선택합니다.
  2. 목록에서 연결 상태 열을 확인합니다.

연결 기능에 대한 자세한 내용은 GitLab Kubernetes에 대한 에이전트 문서를 참조하세요.

클러스터 제거

기본적으로 파이프라인에 정리 작업이 포함되어 있습니다.

생성된 모든 리소스를 제거하려면:

  1. 왼쪽 사이드바에서 빌드 > 파이프라인을 선택한 다음 가장 최근의 파이프라인을 선택합니다.
  2. 환경 제거 작업 옆에서 수동 작업을 선택합니다 ().

Civo 지원

이 Civo 통합은 Civo에서 지원됩니다. 지원 요청은 Civo 지원팀에게 보내 주세요.