Fleet 팀 설정

gcloud

팀 범위 만들기

Fleet에서 새 팀 범위를 만들려면 다음 명령어를 실행합니다. 여기서 SCOPE_NAME은 새 범위에 대해 선택한 고유 식별 이름입니다.

gcloud container fleet scopes create SCOPE_NAME

팀 범위에 클러스터 추가

기존 Fleet 구성원만 팀 범위에 추가될 수 있습니다. 이 안내에서는 범위에 추가하려는 클러스터가 이미 Fleet 멤버라고 가정합니다. Fleet에 클러스터를 추가해야 하는 경우 Fleet 만들기에서 클러스터 유형에 해당하는 안내에 따라 클러스터를 등록합니다. 앞에서 설명한 대로 새로 등록된 클러스터가 액세스 제어용 Google 그룹스를 사용하도록 구성되었는지 확인합니다.

Fleet 구성원 클러스터는 Fleet 호스트 프로젝트의 여러 팀 범위에 제한 없이 추가될 수 있습니다.

클러스터를 팀 범위에 추가하려면 다음 명령어를 실행합니다.

gcloud container fleet memberships bindings create BINDING_NAME \
  --membership MEMBERSHIP_NAME \
  --scope  SCOPE_NAME \
  --location MEMBERSHIP_LOCATION

다음을 바꿉니다.

• BINDING_NAME: 클러스터와 팀 범위 사이의 관계를 나타내는 이름입니다. MEMBERSHIP_NAME-SCOPE_NAME을 사용하는 것이 좋습니다.
• MEMBERSHIP_NAME: Fleet 내의 클러스터 고유 식별자(일반적으로 클러스터 이름)입니다.
• (선택사항) MEMBERSHIP_LOCATION: 클러스터의 멤버십 위치입니다. 생략할 경우 값은 클러스터 등록 시 기본값인 global입니다.

Fleet 네임스페이스 만들기

팀 범위에 네임스페이스를 만들려면 다음 명령어를 실행합니다.

gcloud container fleet scopes namespaces create NAMESPACE_NAME --scope=SCOPE_NAME

다음을 바꿉니다.

• NAMESPACE_NAME: Fleet 내에서 네임스페이스에 대해 선택한 고유한 이름입니다. NAMESPACE_NAME이 Fleet 네임스페이스 이름 지정 제한사항과 충돌하지 않도록 해야 합니다.
• SCOPE_NAME: 네임스페이스를 사용할 팀 범위입니다.

이 명령어는 팀 범위의 각 클러스터에 NAMESPACE_NAME이라는 Kubernetes 네임스페이스를 만듭니다. 개발자가 팀 구성원에게 범위에 대한 액세스 권한을 부여한 후에 팀 구성원은 다른 Kubernetes 네임스페이스와 같이 NAMESPACE_NAME을 사용할 수 있습니다. 이미 팀 범위에 NAMESPACE_NAME이라는 기존 Kubernetes 네임스페이스가 있으면 새 Fleet 네임스페이스의 일부로 간주됩니다. 경우에 따라 이를 네임스페이스 온보딩이라고 부릅니다.

팀 구성원에게 팀 범위에 대한 액세스 권한 부여

그런 후 관련 Google 그룹스에 새 범위에서 작동하도록 적절한 IAM 및 RBAC 권한이 있는지 확인합니다.

gcloud alpha container fleet scopes add-app-operator-binding SCOPE_ID
        --role=ROLE --group=TEAM_EMAIL --project PROJECT_ID

• PROJECT_ID는 Fleet 호스트 프로젝트의 ID입니다.
• TEAM_EMAIL은 팀의 Google 그룹 이메일 주소입니다.
• SCOPE_ID는 생성된 범위의 ID입니다.
• ROLE은 그룹이 팀 범위에 속하는 권한 캐릭터입니다. 이 매개변수의 값은 admin(범위 관리자), edit(범위 편집자) 또는 view(범위 뷰어)일 수 있습니다.

범위에 개별 사용자 액세스 권한을 부여해야 하는 경우 다음 명령어를 대신 실행합니다. 여기서 USER_EMAIL은 사용자의 Google ID 이메일 주소입니다.

gcloud alpha container fleet scopes add-app-operator-binding SCOPE_ID
        --role=ROLE --user=USER_EMAIL --project PROJECT_ID

콘솔

팀 범위 만들기

1. Fleet 호스트 프로젝트가 선택된 상태에서 Google Cloud 콘솔의 팀 섹션으로 이동합니다.

   팀으로 이동

2. 페이지 상단에서 팀 범위 만들기를 클릭합니다.

3. 팀 기본사항 페이지에서 이름에 팀 범위에 대한 고유 이름을 입력합니다. 팀 범위를 만든 후에는 이 이름을 변경할 수 없습니다.

4. 범위에 팀 멤버를 추가하려면 팀 멤버 추가를 클릭합니다.

   • 유형으로 사용자를 선택해서 개별 팀 멤버를 추가하거나 그룹을 선택해서 Google 그룹을 추가합니다(권장됨).
   • 사용자 또는 그룹에 대해 팀 멤버 또는 그룹의 이메일 주소를 입력합니다.
   • 역할에서 범위 관리자, 범위 편집자, 범위 뷰어를 선택합니다. 이는 팀 액세스 권한 선택에 설명된 대로 범위와 Fleet에서 여러 IAM 및 RBAC 바인딩을 구성합니다.

5. 이 단계에서 클러스터 및 네임스페이스를 추가하지 않고 팀 범위를 만들려면 팀 범위 만들기를 클릭합니다. 그렇지 않으면 다음 섹션을 계속해서 범위에 클러스터를 추가합니다.

팀 범위에 클러스터 추가

팀 범위에 클러스터를 연결하려면 클러스터가 기존 Fleet 멤버여야 합니다. Fleet에 클러스터를 추가해야 하는 경우 Fleet 만들기에서 클러스터 유형에 해당하는 안내에 따라 클러스터를 등록합니다. 앞에서 설명한 대로 새로 등록된 클러스터가 액세스 제어용 Google 그룹스를 사용하도록 구성되었는지 확인합니다.

Fleet 구성원 클러스터를 Fleet 호스트 프로젝트의 여러 팀 범위에 추가할 수 있으므로 여러 팀이 같은 클러스터에서 워크로드를 실행할 수 있습니다.

1. 팀 기본사항 페이지에서 범위에 팀 멤버를 추가한 후 계속을 클릭합니다.
2. 클러스터 페이지에서 이 팀 범위와 연결할 Fleet 클러스터를 선택할 수 있습니다. 클러스터 드롭다운에서 추가하려는 클러스터를 선택하고 확인을 클릭합니다.

Fleet 네임스페이스 만들기

팀 멤버가 다른 Kubernetes 네임스페이스와 같은 Fleet 네임스페이스를 사용할 수 있습니다. Fleet 네임스페이스를 만들면 아직 Kubernetes 네임스페이스가 없는 경우 팀 범위에 생성됩니다.

1. 클러스터 페이지에서 클러스터를 팀 범위에 추가한 후 계속을 클릭합니다.
2. 네임스페이스 페이지에서 네임스페이스 추가를 클릭합니다.
   • 이름에 Fleet 내의 네임스페이스에 대한 고유 이름 또는 온보딩하려는 기존 네임스페이스의 이름을 입력합니다. 이름이 Fleet 네임스페이스 이름 지정 제한사항과 충돌하지 않도록 해야 합니다.
3. 범위에 Fleet 네임스페이스를 더 추가하려면 이전 단계를 반복합니다.
4. 팀 범위를 만들려면 팀 범위 만들기를 클릭합니다. 팀 범위가 생성되면 필요한 경우 팀 섹션에서 팀 범위 이름을 클릭하여 팀 범위를 보고 수정할 수 있습니다.

Terraform

이 섹션에서는 Terraform을 사용해서 새 팀을 설정하는 방법을 보여줍니다. 자세한 내용과 기타 예시는 다음 리소스에 대한 참조 문서를 확인하세요.

• google_gke_hub_scope
• google_gke_hub_membership_binding
• google_gke_hub_namespace
• google_gke_hub_scope_rbac_role_binding

팀 범위 만들기

팀 범위를 만들려면 Terraform 구성에서 다음 블록을 사용할 수 있습니다.

  resource "google_gke_hub_scope" "TF_SCOPE_RESOURCE_NAME" {
    scope_id = "SCOPE_NAME"
  }

다음을 바꿉니다.

• TF_SCOPE_RESOURCE_NAME: 이 블록에서 생성된 Terraform google_gke_hub_scope 리소스를 고유하게 식별하기 위해 선택하는 이름입니다.
• SCOPE_NAME: 팀 범위의 고유한 식별 이름입니다.

범위에 클러스터 추가

기존 Fleet 구성원만 팀 범위에 추가될 수 있습니다. Fleet에 클러스터를 추가해야 하는 경우 Fleet 만들기에서 클러스터 유형에 해당하는 안내에 따라 클러스터를 등록합니다. 앞에서 설명한 대로 새로 등록된 클러스터가 액세스 제어용 Google 그룹스를 사용하도록 구성되었는지 확인합니다.

클러스터를 팀 범위에 추가하려면 구성에서 다음 블록을 사용합니다.

  resource "google_gke_hub_membership_binding" "TF_MEMBERSHIP_BINDING_RESOURCE_NAME" {
    membership_binding_id = "BINDING_NAME"
    scope = SCOPE_NAME
    membership_id = MEMBERSHIP_NAME
    location = "MEMBERSHIP_LOCATION"
  }

다음을 바꿉니다.

• TF_MEMBERSHIP_BINDING_RESOURCE_NAME: 이 블록으로 생성된 google_gke_hub_membership_binding 리소스를 식별하는 이름입니다.
• BINDING_NAME: 클러스터와 범위 사이의 관계를 나타내는 이름입니다. MEMBERSHIP_NAME-SCOPE_NAME을 사용하는 것이 좋습니다.
• SCOPE_NAME: 팀 범위의 이름입니다.
• MEMBERSHIP_NAME: Fleet 내의 클러스터 고유 식별자(일반적으로 클러스터 이름)입니다.
• MEMBERSHIP_LOCATION: 클러스터의 멤버십 위치입니다.

Fleet 네임스페이스 만들기

팀 멤버가 다른 Kubernetes 네임스페이스와 같은 Fleet 네임스페이스를 사용할 수 있습니다. 새 네임스페이스를 만들거나 기존 네임스페이스를 온보딩할 수 있습니다. Fleet 네임스페이스를 만들면 아직 Kubernetes 네임스페이스가 없는 경우 팀 범위에 생성됩니다.

Fleet 네임스페이스를 만들려면 구성에서 다음 블록을 사용합니다.

  resource "google_gke_hub_namespace" "TF_NAMESPACE_RESOURCE_NAME" {
    scope_namespace_id = "NAMESPACE_NAME"
    scope_id = SCOPE_NAME
    scope = SCOPE_NAME
  }

다음을 바꿉니다.

• TF_NAMESPACE_RESOURCE_NAME: 이 블록으로 생성된 google_gke_hub_namespace 리소스를 식별하는 이름입니다.
• NAMESPACE_NAME: Fleet 네임스페이스에 선택한 고유한 이름입니다. 이 이름이 Fleet 네임스페이스 이름 지정 제한사항과 충돌하지 않도록 해야 합니다.
• SCOPE_NAME: Fleet 네임스페이스가 생성되는 팀 범위의 이름입니다.

범위 액세스 권한 부여

이전 섹션에서 설명한 것처럼 IAM 및 RBAC 권한을 모두 포함하는 권한 캐릭터를 사용하여 팀 구성원에게 범위에 대한 액세스 권한을 부여할 수 있습니다. 예를 들어 개별 사용자에게 팀 범위에 대한 액세스 권한을 부여하기 위한 구성은 다음과 같습니다.

  module "TF_SCOPE_RESOURCE_NAME_USER_EMAIL" {
    source           = "terraform-google-modules/kubernetes-engine/google//modules/fleet-app-operator-binding"

    scope_id = "SCOPE_NAME"
    user = "USER_EMAIL"
    role = "ROLE"
  }

다음을 바꿉니다.

• TF_SCOPE_RESOURCE_NAME: 범위의 이름입니다.
• BINDING_NAME: 이 바인딩을 나타내는 이름입니다.
• SCOPE_NAME: 팀 범위의 이름입니다.
• USER_EMAIL: 사용자의 이메일 주소입니다.
• ROLE: 사용자에게 부여할 캐릭터입니다. ADMIN, EDIT, VIEW 중에서 선택할 수 있습니다.

Google 그룹에 팀 범위에 대한 액세스 권한을 부여하려면 앞의 구성에서 user 대신 group을 사용하고 팀의 Google 그룹에 대한 이메일 주소를 사용합니다.

gcloud

팀 범위 나열

Fleet의 모든 범위를 나열하려면 다음 명령어를 실행합니다.

gcloud container fleet scopes list

클러스터와 연결된 모든 범위를 나열하려면 다음 명령어를 실행합니다.

gcloud container fleet memberships bindings list --membership MEMBERSHIP_NAME

팀 범위에서 클러스터 삭제

범위에서 클러스터를 삭제하려면 다음 명령어를 실행합니다.

gcloud container fleet memberships bindings delete BINDING_NAME --membership MEMBERSHIP_NAME

팀 범위 삭제

Fleet에서 범위를 삭제하려면 다음 명령어를 실행합니다.

gcloud container fleet scopes delete SCOPE_NAME

Console

팀 범위 나열

Fleet의 모든 범위를 보려면 Fleet 호스트 프로젝트가 선택된 상태로 Google Cloud 콘솔에서 팀 섹션으로 이동합니다.

팀으로 이동

팀 페이지에 Fleet에 대해 생성된 모든 팀 범위 목록이 표시됩니다. 각 범위에 대해 지정된 기간 동안의 리소스 사용률 요약 정보를 보고, 예상 월간 비용, 오류 수, 컨테이너 다시 시작 수를 확인할 수 있습니다.

비용 최적화를 클릭하여 보다 자세한 비용 관련 사용률 측정항목을 확인할 수 있습니다.

팀 범위 세부정보 보기

각 팀 범위에 대해 해당 범위, 팀 멤버, 팀 범위 로그와 관련된 라벨을 포함하여 세부정보를 볼 수 있습니다.

1. 팀 페이지에서 세부정보를 보려는 팀 범위를 클릭합니다.
2. 팀 탭에서 범위 라벨을 보고 팀 멤버를 볼 수 있습니다.
3. 모니터링 탭을 클릭하여 팀의 리소스 사용률 측정항목을 확인합니다.
4. 클러스터 탭을 클릭하여 팀 범위의 클러스터를 확인합니다.
5. 네임스페이스 탭을 클릭하여 이 팀 범위의 Fleet 네임스페이스를 확인합니다.
6. 로그 탭을 클릭하여 팀 범위 로그를 확인합니다.

팀 범위에서 클러스터 추가 또는 삭제

기존 팀 범위에서 클러스터를 추가하거나 삭제하려면 다음 안내를 따르세요.

1. Google Cloud 콘솔에서 팀 페이지로 이동합니다.

   팀으로 이동

2. 클러스터를 추가하거나 삭제하려는 팀 범위를 선택합니다. 클러스터 탭에 현재 해당 범위에 바인딩된 클러스터 목록이 표시됩니다.

클러스터를 팀 범위에 추가하려면 다음 안내를 따르세요.

1. 페이지 위에서 제품 추가를 클릭합니다.
2. 클러스터 드롭다운에서 범위에 추가하려는 클러스터를 선택하고 확인을 클릭합니다.
3. 팀 범위 업데이트를 클릭합니다.

팀 범위에서 클러스터를 삭제하려면 다음 안내를 따르세요.

1. 범위에 현재 바인딩된 클러스터 목록을 표시하는 클러스터 탭을 선택합니다.
2. 삭제하려는 클러스터 옆의 휴지통 아이콘을 클릭하고 삭제를 클릭하여 삭제를 확인합니다.

범위 삭제

1. Google Cloud 콘솔에서 팀 페이지로 이동합니다.

   팀으로 이동

2. 삭제할 팀 범위를 선택합니다.

3. 범위를 삭제하려면 페이지 상단에서 삭제를 클릭합니다.

4. 범위 이름을 입력하여 삭제를 확인하고 삭제를 다시 클릭합니다.

gcloud

다음 명령어를 사용해서 팀 범위 내에서 네임스페이스를 관리합니다.

Fleet 네임스페이스 나열

범위에서 fleet scopes namespaces create를 사용하여 만든 네임스페이스를 모두 나열하려면 다음 명령어를 실행합니다.

gcloud container fleet scopes namespaces list --scope=SCOPE_NAME

Fleet 네임스페이스 삭제

Fleet 네임스페이스를 삭제하려면 다음 명령어를 실행합니다.

gcloud container fleet scopes namespaces delete NAMESPACE_NAME --scope=SCOPE_NAME

Fleet 네임스페이스를 삭제할 때 발생하는 결과는 네임스페이스를 추가한 방법에 따라 달라집니다.

• 새 Fleet 네임스페이스를 만든 경우: 이 명령어가 Fleet 네임스페이스를 삭제합니다. 또한 해당 워크로드와 함께 Fleet 네임스페이스 만들기의 결과로 생성된 모든 Kubernetes 네임스페이스를 삭제합니다.
• 기존 Kubernetes 네임스페이스를 온보딩한 경우: 이 명령어에서 Fleet 네임스페이스를 삭제합니다. 온보딩한 원래 네임스페이스는 삭제되지 않습니다.

Console

팀 범위에서 Fleet 네임스페이스를 관리하려면 다음 안내를 따르세요.

1. Google Cloud 콘솔에서 팀 페이지로 이동합니다.

   팀으로 이동

2. Fleet 네임스페이스를 관리하려는 팀 범위를 선택합니다.

Fleet 네임스페이스 나열

팀 범위에서 이 범위에 생성된 네임스페이스 목록을 표시하는 네임스페이스 탭을 선택합니다.

네임스페이스 세부정보 보기

각 Fleet 네임스페이스에 대해 해당 네임스페이스와 연결된 라벨, 워크로드, 네임스페이스로 필터링된 로그를 볼 수 있습니다.

1. 팀 범위에서 생성된 Fleet 네임스페이스 목록을 표시하는 네임스페이스 탭을 선택합니다.
2. 세부정보를 보려는 Fleet 네임스페이스를 클릭합니다.
3. 세부정보 탭에서 Fleet 네임스페이스와 범위 라벨을 볼 수 있습니다.
   • 이 네임스페이스의 워크로드를 보려면 워크로드 보기를 클릭합니다.
   • 워크로드 페이지에서 이미 네임스페이스로 필터링된 워크로드와 해당 네임스페이스의 팀 범위와 연결된 클러스터를 볼 수 있습니다.
4. 로그 탭에서 네임스페이스별 Fleet 범위 로그를 볼 수 있습니다.

팀 범위에 Fleet 네임스페이스 추가

1. 새 Fleet 네임스페이스를 추가하려면 페이지 상단에서 네임스페이스 추가를 클릭합니다.
2. 새 Fleet 네임스페이스의 이름을 입력하고 이름이 Fleet 네임스페이스 이름 지정 제한사항과 충돌하지 않는지 확인합니다. 네임스페이스를 더 추가하려면 네임스페이스 추가를 클릭합니다.
3. 팀 범위 업데이트를 클릭합니다.

Fleet 네임스페이스 삭제

1. 팀 범위에서 생성된 Fleet 네임스페이스 목록을 표시하는 네임스페이스 탭을 선택합니다.
2. 삭제하려는 네임스페이스 옆에 있는 휴지통 아이콘을 클릭합니다.
3. 네임스페이스 이름을 입력하여 삭제를 확인하고 삭제를 다시 클릭합니다.

이 작업을 수행할 때 발생하는 결과는 네임스페이스를 추가한 방법에 따라 달라집니다.

• 새 Fleet 네임스페이스를 만든 경우: Fleet 네임스페이스가 삭제됩니다. 해당 워크로드와 함께 Fleet 네임스페이스 만들기의 결과로 생성된 모든 Kubernetes 네임스페이스도 삭제됩니다.
• 기존 Kubernetes 네임스페이스를 온보딩한 경우: Fleet 네임스페이스가 삭제됩니다. 하지만 온보딩한 원래 네임스페이스는 삭제되지 않습니다.

Fleet 네임스페이스 이름 업데이트

Fleet 네임스페이스를 만든 후에는 이를 수정할 수 없습니다. Fleet 네임스페이스 이름을 업데이트하려면 네임스페이스를 삭제하고 팀 범위에서 새 네임스페이스를 만들어야 합니다.

gcloud

팀 구성원 나열

add-app-operator-binding 명령어를 사용하여 팀 범위에 대한 액세스 권한이 부여된 모든 팀 구성원을 권한 캐릭터와 함께 나열하려면 다음 명령어를 사용합니다.

gcloud alpha container hub scopes list-app-operator-bindings SCOPE_NAME

다음을 바꿉니다.

• SCOPE_NAME: 팀 범위의 고유 식별자입니다.

팀 구성원 삭제

add-app-operator-binding으로 부여되는 팀 구성원의 범위 액세스 권한을 삭제하려면 다음 명령어를 사용합니다.

gcloud alpha container hub scopes remove-app-operator-binding SCOPE_NAME \
   --group=TEAM_EMAIL

또는

gcloud alpha container hub scopes remove-app-operator-binding SCOPE_NAME \
   --user=USER_EMAIL

다음을 바꿉니다.

• SCOPE_NAME: 팀 범위의 고유 식별자입니다.
• TEAM_EMAIL 또는 USER_EMAIL: 팀에서 삭제할 그룹 또는 사용자의 이메일 주소입니다.

rbacrolebindings create 명령어로 액세스 권한이 팀 구성원에게 부여된 경우 대신 rbacrolebindings delete 명령어를 사용하여 팀 구성원을 삭제할 수 있습니다.

팀 범위 액세스 업데이트

팀 범위 액세스 권한을 업데이트(예: 팀 구성원에 다른 역할 부여 또는 그룹 이메일 주소 업데이트)하려면 이전 섹션에서 설명한 대로 범위에서 팀 구성원을 삭제한 다음 새로운 세부정보로 액세스 권한을 다시 부여합니다.

rbacrolebindings create 명령어로 팀 구성원에게 액세스 권한이 부여된 경우 대신 rbacrolebindings update 명령어를 사용하여 구성원의 액세스 권한을 업데이트할 수 있습니다.

콘솔

팀 구성원 추가 또는 삭제

팀 범위에서 팀 구성원을 관리하려면 다음 안내를 따르세요.

1. Google Cloud 콘솔에서 팀 페이지로 이동합니다.

   팀으로 이동

2. 멤버를 관리하려는 팀 범위를 선택합니다.

범위에 새 팀 멤버를 추가하려면 다음 안내를 따르세요.

1. 페이지 상단에서 팀 멤버 추가를 클릭합니다. 팀 범위 만들기 섹션에 설명된 안내를 따릅니다.
2. 팀 범위 업데이트를 클릭합니다.

범위에서 팀 멤버를 삭제하려면 다음 안내를 따르세요.

1. 팀 탭에서 팀 범위로부터 삭제할 팀 멤버 옆의 휴지통 아이콘을 클릭합니다.
2. 삭제를 클릭하여 삭제를 확인합니다.

Google Cloud 콘솔에서는 팀 멤버의 세부정보를 수정할 수 없습니다. Google Cloud 콘솔에서 범위 액세스를 업데이트하려면(예: 팀 멤버에 다른 역할 부여 또는 그룹 이메일 주소 업데이트) 범위에서 팀 멤버를 삭제하고 새로운 세부정보를 사용해서 다시 추가합니다.