InfoGrab DocsInfoGrab Docs

Civo Kubernetes 클러스터 생성

요약

모든 새 Civo 계정은 GitLab과 Civo Kubernetes 통합을 시작할 수 있도록 $250 크레딧을 받습니다. Infrastructure as Code(IaC)를 통해 Civo Kubernetes에 새 클러스터를 만드는 방법을 설명합니다.

모든 새 Civo 계정은 GitLab과 Civo Kubernetes 통합을 시작할 수 있도록 $250 크레딧을 받습니다. 마켓플레이스 앱을 사용하여 Civo Kubernetes 클러스터에 GitLab을 설치할 수도 있습니다.

Infrastructure as Code(IaC)를 통해 Civo Kubernetes에 새 클러스터를 만드는 방법을 설명합니다. 이 프로세스는 Civo와 Kubernetes Terraform 공급자를 사용하여 Civo Kubernetes 클러스터를 생성합니다. GitLab용 Kubernetes 에이전트를 사용하여 클러스터를 GitLab에 연결합니다.

시작하기 전에:

  • Civo 계정.
  • GitLab CI/CD 파이프라인을 실행하는 데 사용할 수 있는 러너.

단계:

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

예시 프로젝트 가져오기#

GitLab에서 Infrastructure as Code를 사용하여 클러스터를 생성하려면 클러스터를 관리할 프로젝트를 만들어야 합니다. 이 튜토리얼에서는 샘플 프로젝트로 시작하여 필요에 맞게 수정합니다.

먼저 URL로 예시 프로젝트를 가져옵니다.

프로젝트를 가져오려면 다음을 수행합니다.

  1. GitLab의 상단 표시줄에서 검색 또는 이동을 선택합니다.
  2. 내 모든 프로젝트 보기를 선택합니다.
  3. 페이지 오른쪽에서 새 프로젝트를 선택합니다.
  4. 프로젝트 가져오기를 선택합니다.
  5. URL로 리포지터리 가져오기를 선택합니다.
  6. Git 리포지터리 URL에 https://gitlab.com/civocloud/gitlab-terraform-civo.git을 입력합니다.
  7. 필드를 입력하고 프로젝트 만들기를 선택합니다.

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

에이전트 등록#

GitLab용 Kubernetes 에이전트를 만들려면 다음을 수행합니다.

  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를 이전 작업의 에이전트 서버 주소로 설정합니다.

필수 구성

선택 구성:

variables.tf 파일에는 필요에 따라 재정의할 수 있는 다른 변수가 있습니다.

  • TF_VAR_civo_region: 클러스터의 리전을 설정합니다.
  • TF_VAR_cluster_name: 클러스터의 이름을 설정합니다.
  • TF_VAR_cluster_description: 클러스터에 대한 설명을 설정합니다. Civo 클러스터 세부 정보 페이지에서 GitLab 프로젝트 참조를 만들려면 이 값을 $CI_PROJECT_URL로 설정합니다. 이 값은 Civo 대시보드에 보이는 클러스터를 어느 프로젝트가 프로비저닝했는지 파악하는 데 도움이 됩니다.
  • TF_VAR_target_nodes_size: 클러스터에 사용할 노드의 크기를 설정합니다.
  • TF_VAR_num_target_nodes: Kubernetes 노드 수를 설정합니다.
  • TF_VAR_agent_version: GitLab용 Kubernetes 에이전트 버전을 설정합니다.
  • TF_VAR_agent_namespace: GitLab용 Kubernetes 에이전트의 Kubernetes 네임스페이스를 설정합니다.

추가 리소스 옵션은 Civo Terraform 공급자와 Kubernetes Terraform 공급자 문서를 참고합니다.

클러스터 프로비저닝#

프로젝트를 구성한 후 클러스터 프로비저닝을 수동으로 트리거합니다. GitLab에서 다음을 수행합니다.

  1. 왼쪽 사이드바에서 빌드 > 파이프라인을 선택합니다.
  2. 새 파이프라인을 선택합니다.
  3. 파이프라인 실행을 선택한 다음 목록에서 새로 만든 파이프라인을 선택합니다.
  4. deploy job 옆에서 수동 작업([status_manual])을 선택합니다.

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

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

TF_VAR_civo_region 변수를 설정하지 않으면 클러스터는 'lon1' 리전에 생성됩니다.

클러스터 사용#

클러스터를 프로비저닝하면 GitLab에 연결되어 배포할 준비가 됩니다. 연결을 확인하려면 다음을 수행합니다.

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

연결 기능에 대한 자세한 내용은 GitLab용 Kubernetes 에이전트 문서를 참고합니다.

클러스터 제거#

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

생성된 모든 리소스를 제거하려면 다음을 수행합니다.

  1. 왼쪽 사이드바에서 빌드 > 파이프라인을 선택하고 가장 최근 파이프라인을 선택합니다.
  2. destroy-environment job 옆에서 수동 작업([status_manual])을 선택합니다.

Civo 지원#

이 Civo 통합은 Civo에서 지원합니다. 지원 요청은 Civo 지원으로 보냅니다.

Civo Kubernetes 클러스터 생성

GitLab v19.5
원문 보기

요약

모든 새 Civo 계정은 GitLab과 Civo Kubernetes 통합을 시작할 수 있도록 $250 크레딧을 받습니다. Infrastructure as Code(IaC)를 통해 Civo Kubernetes에 새 클러스터를 만드는 방법을 설명합니다.

모든 새 Civo 계정은 GitLab과 Civo Kubernetes 통합을 시작할 수 있도록 $250 크레딧을 받습니다. 마켓플레이스 앱을 사용하여 Civo Kubernetes 클러스터에 GitLab을 설치할 수도 있습니다.

Infrastructure as Code(IaC)를 통해 Civo Kubernetes에 새 클러스터를 만드는 방법을 설명합니다. 이 프로세스는 Civo와 Kubernetes Terraform 공급자를 사용하여 Civo Kubernetes 클러스터를 생성합니다. GitLab용 Kubernetes 에이전트를 사용하여 클러스터를 GitLab에 연결합니다.

시작하기 전에:

  • Civo 계정.
  • GitLab CI/CD 파이프라인을 실행하는 데 사용할 수 있는 러너.

단계:

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

예시 프로젝트 가져오기#

GitLab에서 Infrastructure as Code를 사용하여 클러스터를 생성하려면 클러스터를 관리할 프로젝트를 만들어야 합니다. 이 튜토리얼에서는 샘플 프로젝트로 시작하여 필요에 맞게 수정합니다.

먼저 URL로 예시 프로젝트를 가져옵니다.

프로젝트를 가져오려면 다음을 수행합니다.

  1. GitLab의 상단 표시줄에서 검색 또는 이동을 선택합니다.
  2. 내 모든 프로젝트 보기를 선택합니다.
  3. 페이지 오른쪽에서 새 프로젝트를 선택합니다.
  4. 프로젝트 가져오기를 선택합니다.
  5. URL로 리포지터리 가져오기를 선택합니다.
  6. Git 리포지터리 URL에 https://gitlab.com/civocloud/gitlab-terraform-civo.git을 입력합니다.
  7. 필드를 입력하고 프로젝트 만들기를 선택합니다.

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

에이전트 등록#

GitLab용 Kubernetes 에이전트를 만들려면 다음을 수행합니다.

  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를 이전 작업의 에이전트 서버 주소로 설정합니다.

필수 구성

선택 구성:

variables.tf 파일에는 필요에 따라 재정의할 수 있는 다른 변수가 있습니다.

  • TF_VAR_civo_region: 클러스터의 리전을 설정합니다.
  • TF_VAR_cluster_name: 클러스터의 이름을 설정합니다.
  • TF_VAR_cluster_description: 클러스터에 대한 설명을 설정합니다. Civo 클러스터 세부 정보 페이지에서 GitLab 프로젝트 참조를 만들려면 이 값을 $CI_PROJECT_URL로 설정합니다. 이 값은 Civo 대시보드에 보이는 클러스터를 어느 프로젝트가 프로비저닝했는지 파악하는 데 도움이 됩니다.
  • TF_VAR_target_nodes_size: 클러스터에 사용할 노드의 크기를 설정합니다.
  • TF_VAR_num_target_nodes: Kubernetes 노드 수를 설정합니다.
  • TF_VAR_agent_version: GitLab용 Kubernetes 에이전트 버전을 설정합니다.
  • TF_VAR_agent_namespace: GitLab용 Kubernetes 에이전트의 Kubernetes 네임스페이스를 설정합니다.

추가 리소스 옵션은 Civo Terraform 공급자와 Kubernetes Terraform 공급자 문서를 참고합니다.

클러스터 프로비저닝#

프로젝트를 구성한 후 클러스터 프로비저닝을 수동으로 트리거합니다. GitLab에서 다음을 수행합니다.

  1. 왼쪽 사이드바에서 빌드 > 파이프라인을 선택합니다.
  2. 새 파이프라인을 선택합니다.
  3. 파이프라인 실행을 선택한 다음 목록에서 새로 만든 파이프라인을 선택합니다.
  4. deploy job 옆에서 수동 작업([status_manual])을 선택합니다.

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

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

TF_VAR_civo_region 변수를 설정하지 않으면 클러스터는 'lon1' 리전에 생성됩니다.

클러스터 사용#

클러스터를 프로비저닝하면 GitLab에 연결되어 배포할 준비가 됩니다. 연결을 확인하려면 다음을 수행합니다.

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

연결 기능에 대한 자세한 내용은 GitLab용 Kubernetes 에이전트 문서를 참고합니다.

클러스터 제거#

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

생성된 모든 리소스를 제거하려면 다음을 수행합니다.

  1. 왼쪽 사이드바에서 빌드 > 파이프라인을 선택하고 가장 최근 파이프라인을 선택합니다.
  2. destroy-environment job 옆에서 수동 작업([status_manual])을 선택합니다.

Civo 지원#

이 Civo 통합은 Civo에서 지원합니다. 지원 요청은 Civo 지원으로 보냅니다.