패키지 관리

이 페이지에서는 Google Cloud 콘솔에서 구성 동기화를 사용하여 패키지를 관리하는 방법을 설명합니다.

패키지는 정보 소스에서 관리되고 구성 동기화를 통해 클러스터에 동기화되는 Kubernetes 리소스 객체 매니페스트의 집합입니다. 각 패키지 정의는 클러스터의 RootSync 또는 RepoSync 객체에 포함됩니다. RootSync 및 RepoSync 객체에 대한 자세한 내용은 구성 동기화 아키텍처를 참조하세요.

시작하기 전에

패키지 배포

클러스터를 Fleet에 등록하고 구성 동기화를 설치한 후 구성 동기화를 구성하여 정보 소스에서 클러스터에 패키지를 배포할 수 있습니다. 동일한 패키지를 여러 클러스터에 배포하거나 서로 다른 패키지를 여러 클러스터에 배포할 수 있습니다. 패키지 이름 및 동기화 유형과 같은 일부 설정을 제외하고는 패키지를 배포한 후 편집할 수 있습니다. 자세한 내용은 패키지 관리를 참조하세요.

패키지를 배포하려면 다음 단계를 완료하세요.

  1. Google Cloud 콘솔에서 구성 동기화 대시보드로 이동합니다.

    구성 동기화 대시보드로 이동

  2. 패키지 배포를 클릭합니다.

  3. 패키지 배포를 위한 클러스터 선택 테이블에서 패키지를 배포할 클러스터를 선택한 후 계속을 클릭합니다.

  4. Git에서 호스팅되는 패키지 또는 OCI에서 호스팅된 패키지를 소스 유형으로 선택하고 계속을 클릭합니다.

  5. 패키지 세부정보 섹션에 RootSync 또는 RepoSync 객체를 식별하는 패키지 이름을 입력합니다.

  6. 동기화 유형 필드에서 클러스터 범위 동기화 또는 네임스페이스 범위 동기화를 동기화 유형으로 선택합니다.

    클러스터 범위 동기화는 RootSync 객체를 만들고 네임스페이스 범위 동기화는 RepoSync 객체를 만듭니다. 이러한 객체에 대한 자세한 내용은 구성 동기화 아키텍처를 참조하세요.

  7. 소스 섹션에서 다음을 완료합니다.

    • Git 저장소에서 호스팅되는 소스의 경우 다음 필드를 입력하세요.

      1. 저장소 URL로 정보 소스로 사용하는 Git 저장소의 URL을 입력합니다.
      2. (선택사항): 기본 HEAD를 사용하지 않는지 확인하려면 버전 필드를 업데이트합니다.
      3. (선택사항): 루트 저장소에서 동기화하지 않으려면 경로 필드를 업데이트합니다.
      4. (선택사항): 기본 main 브랜치를 사용하지 않는 경우 브랜치 필드를 업데이트합니다.

    • OCI 이미지에서 호스팅되는 소스의 경우 다음 필드를 입력합니다.

      1. 정보 소스로 사용하는 OCI 이미지의 URL을 이미지로 입력합니다.
      2. 루트 디렉터리를 기준으로 동기화할 디렉터리의 경로를 디렉터리로 입력합니다.

  8. (선택사항): 고급 설정 섹션을 펼친 후 다음을 완료합니다.

    1. 인증 유형을 선택합니다. 구성 동기화는 소스의 구성 파일을 읽고 이를 클러스터에 적용할 수 있도록 정보 소스에 대한 읽기 전용 액세스 권한이 필요합니다. 공개 저장소와 같이 소스에 인증이 필요하지 않은 경우를 제외하고 구성 동기화에 Git 저장소, OCI 이미지 또는 Helm 차트(gcloud CLI만 해당)에 대한 읽기 전용 액세스 권한을 부여해야 합니다. 구성 동기화를 설치할 때 구성한 것과 동일한 인증 유형을 선택합니다.

      • None: 인증을 사용하지 않습니다.
      • SSH: SSH 키 쌍을 사용하여 인증합니다.
      • Cookiefile: cookiefile을 사용하여 인증합니다.
      • 토큰: 액세스 토큰 또는 비밀번호를 사용하여 인증합니다.
      • Google Cloud Repository: Google 서비스 계정을 사용하여 Cloud Source Repositories 저장소에 액세스합니다. GKE용 워크로드 아이덴티티 제휴가 클러스터에 사용 설정되지 않은 경우에만 이 옵션을 선택합니다.
      • 워크로드 아이덴티티: Google 서비스 계정을 사용하여 Cloud Source Repositories 저장소에 액세스합니다.

    2. 동기화 대기 시간을 설정하려면 숫자(초)를 입력하세요. 여기서는 구성 동기화가 정보 소스에서 가져오기를 시도할 때 대기하는 시간을 결정합니다.

    3. 정보 소스와 통신할 때 사용될 HTTPS 프록시의 Git 프록시 URL을 입력합니다.

    4. 계층 구조를 선택하여 소스 형식을 변경합니다.

      기본값인 구조화되지 않음은 원하는 방식으로 소스를 구성할 수 있으므로 대부분의 경우에 권장됩니다.

  9. 패키지 배포를 클릭합니다.

    구성 동기화 패키지 페이지로 리디렉션됩니다. 몇 분 후에 구성한 클러스터의 동기화 상태 열에 Synced(동기화됨)가 표시됩니다.

패키지 수정

이미 배포한 패키지를 수정하려면 다음 단계를 완료합니다.

  1. Google Cloud 콘솔에서 구성 동기화 패키지 탭으로 이동합니다.

    패키지로 이동

  2. (선택사항): 빠른 필터 메뉴를 펼친 후 필터를 선택하면 수정할 패키지를 찾는데 도움이 됩니다.

  3. 수정할 패키지 이름을 펼친 후 클러스터 이름이 포함된 행에서 컨텍스트 메뉴를 클릭합니다. 그런 다음 패키지 수정을 클릭하세요.

  4. 변경하려는 패키지 설정을 검토하고 업데이트합니다.

  5. 저장을 클릭합니다.

패키지 제거

Google Cloud 콘솔에서 패키지를 제거하려면 다음 단계를 완료합니다.

  1. Google Cloud 콘솔에서 구성 동기화 패키지 탭으로 이동합니다.

    패키지로 이동

  2. (선택사항): 빠른 필터 메뉴를 펼친 후 필터를 선택하면 제거하려는 패키지를 찾는 데 도움이 됩니다.

  3. 제거할 패키지 이름을 펼친 후 클러스터 이름이 포함된 행에서 컨텍스트 메뉴를 클릭합니다. 그런 다음 패키지 제거를 클릭하세요.

  4. 확인 대화상자에서 RootSync 또는 RepoSync 객체만 제거할지 아니면 RootSync 또는 RepoSync 및 RootSync 또는 RepoSync에서 관리하는 모든 리소스를 제거할지 여부를 선택합니다.

  5. 확인 메시지를 입력한 후 제거를 클릭합니다.

다음 단계