GKE를 Google SecOps와 통합

이 문서에서는 Google Kubernetes Engine (GKE)을 Google Security Operations와 구성하고 통합하는 방법을 설명합니다.

사용 사례

GKE 통합은 Google SecOps 기능을 사용하여 다음 사용 사례를 지원합니다.

  • 클러스터 인벤토리: 지정된 위치 내의 모든 GKE 클러스터 목록을 자동으로 가져옵니다. 이를 통해 보안팀은 Kubernetes 인프라의 최신 인벤토리를 유지할 수 있습니다.

  • 동적 자동 확장: 보안 이벤트 또는 운영 알림에 따라 노드 풀의 크기를 자동으로 조정하여 최적의 성능을 보장합니다.

  • 라벨 기반 격리: 보안 정책 또는 사고 대응 절차에 따라 GKE 클러스터에 라벨을 자동으로 적용합니다.

  • 부가기능 구성 조정: 보안 권장사항에 따라 GKE 부가기능을 자동으로 사용 설정하거나 사용 중지합니다. 보안이 취약한 부가기능을 사용 중지하면 공격 표면을 줄일 수 있습니다.

  • 작업 상태 모니터링: 보안 플레이북 또는 사고 대응 워크플로에 의해 트리거되는 GKE 작업의 상태를 자동으로 모니터링합니다. 이를 통해 보안 분석가는 수정 진행 상황을 모니터링하고 진행 중인 작업의 상태를 확인할 수 있습니다.

시작하기 전에

Google SecOps에서 GKE 통합을 구성하기 전에 다음 필수 단계들을 완료하세요.

  1. 커스텀 Identity and Access Management 역할 생성 및 구성

  2. 서비스 계정을 만듭니다.

  3. 다음 인증 방법 중 하나를 선택하고 구성합니다.

IAM 역할 만들기 및 구성

통합에 필요한 권한을 제공하려면 프로젝트에서 커스텀 역할을 만드세요.

  1. Google Cloud 콘솔에서 역할로 이동합니다.

    역할로 이동

  2. 역할 만들기를 클릭합니다.

  3. 제목 (예: SecOps GKE Analyst), 설명, 고유 ID를 제공합니다.

  4. 역할 출시 단계를 정식 버전으로 설정합니다.

  5. 역할에 다음 권한을 추가합니다.

    • container.clusters.list
    • container.clusters.update
    • container.clusters.get
    • container.operations.list
    • container.operations.get

  6. 만들기를 클릭합니다.

서비스 계정 만들기

  1. Google Cloud 콘솔에서 IAM 및 관리자 > 서비스 계정으로 이동합니다.

    서비스 계정으로 이동

  2. 추가 서비스 계정 만들기를 클릭합니다.

  3. 이름과 설명을 입력하고 만들고 계속하기를 클릭합니다.

  4. 이 서비스 계정에 프로젝트에 대한 액세스 권한 부여 단계에서 만든 맞춤 IAM 역할을 할당합니다.

  5. 완료를 클릭합니다. 서비스 계정의 이메일 주소를 기록해 둡니다.

워크로드 아이덴티티 사용자 인증 정보 구성

워크로드 아이덴티티는 서비스 계정 가장을 사용하여 단기 액세스 토큰을 사용하므로 권장되는 접근 방식입니다.

고유 인스턴스 ID 식별

연결을 설정하려면 Google SecOps 인스턴스에 서비스 계정을 가장할 권한을 부여해야 합니다.

  1. Google SecOps에서 콘텐츠 허브 > 응답 통합으로 이동합니다.

  2. GKE 통합을 선택하고 Workload Identity Email 필드에 서비스 계정 이메일을 입력합니다.

  3. 저장 > 테스트를 클릭합니다. 테스트가 실패할 것으로 예상됩니다.

  4. 테스트 옆에 있는 close_small 버튼을 클릭하고 gke-init-python@... 또는 soar-python@...로 시작하는 ID 이메일을 찾습니다.

  5. 이 고유 이메일 주소를 복사합니다.

Google Cloud에서 인스턴스 ID 승인

  1. Google Cloud 콘솔에서 IAM 및 관리자 > 서비스 계정으로 이동합니다.

    서비스 계정으로 이동

  2. 타겟 서비스 계정을 선택하고 권한 > 액세스 권한 부여로 이동합니다.

  3. 고유 이메일 주소를 새 주 구성원 필드에 붙여넣고 서비스 계정 토큰 생성자 역할(roles/iam.serviceAccountTokenCreator)을 할당합니다.

할당량 프로젝트 액세스 권한 부여

워크로드 아이덴티티로 인증하려면 API 사용량과 청구를 추적하는 Quota Project ID가 필요합니다.

  1. Google Cloud 콘솔에서 할당량 프로젝트로 사용되는 프로젝트의 IAM으로 이동합니다.

    IAM으로 이동

  2. 서비스 계정을 찾아 주 구성원 수정(수정)을 클릭합니다.

  3. 다른 역할 추가를 클릭하고 서비스 사용량 소비자(roles/serviceusage.serviceUsageConsumer)를 선택합니다.

  4. 저장을 클릭합니다.

JSON 키 구성

정적이고 수명이 긴 보안 비밀 키 파일은 수동으로 순환해야 합니다. 워크로드 아이덴티티 인증을 사용할 수 없는 경우에만 이 메서드를 사용하세요.

  1. Google Cloud 콘솔에서 IAM 및 관리자 > 서비스 계정으로 이동하여 서비스 계정을 선택합니다.

    서비스 계정으로 이동

  2. 키 탭으로 이동하여 키 추가 > 새 키 만들기를 클릭합니다.

  3. JSON을 선택하고 만들기를 클릭합니다. 브라우저가 JSON 파일을 컴퓨터에 다운로드합니다.

수동 개별 매개변수 구성

사용자 인증 정보를 수동으로 입력하려면 다운로드한 JSON 키 파일을 텍스트 편집기에서 열어 통합 설정에 필요한 개별 값을 복사하세요.

통합 매개변수

Google SecOps와 GKE 간의 연결을 설정하려면 다음 매개변수를 구성해야 합니다. 통합은 세 가지 고유한 인증 경로를 지원합니다. 다음 방법 중 하나를 선택하여 사용자 인증 정보를 제공합니다.

  • 워크로드 아이덴티티: Workload Identity Email 및 Quota Project ID 사용

  • 서비스 계정 JSON 파일: Service Account Json File Content를 사용하여 전체 키 파일을 제공합니다.

  • 수동 개별 매개변수: JSON 키에서 수동으로 복사한 별도의 필드를 사용합니다.

매개변수 설명
API Root

필수 항목입니다.

GKE 인스턴스의 API 루트입니다.

기본값은 https://container.googleapis.com입니다.
Workload Identity Email

선택사항입니다.

서비스 계정의 클라이언트 이메일 주소입니다.

워크로드 아이덴티티를 사용하여 인증하는 경우에만 이 매개변수를 구성하세요. 구성된 경우 Quota Project ID도 제공해야 하며 Service Account JSON File Content는 무시됩니다.
Service Account Json File Content

선택사항입니다.

서비스 계정 키 JSON 파일의 전체 콘텐츠입니다. JSON 키를 사용하여 인증하는 경우에만 이 매개변수를 구성하세요.
Project ID

선택사항입니다.

GKE에서 타겟팅할 프로젝트 ID입니다.

값을 제공하지 않으면 통합에서 서비스 계정 사용자 인증 정보에서 ID를 가져옵니다.
Quota Project ID

선택사항입니다.

API 사용 및 결제에 사용되는 프로젝트 ID입니다.

워크로드 아이덴티티 인증을 사용하는 경우 이 매개변수가 필요합니다.

값을 제공하지 않으면 통합에서 서비스 계정 사용자 인증 정보에서 ID를 가져옵니다.
Location ID

선택사항입니다.

클러스터 작업의 범위를 지정하는 데 사용되는 위치 ID입니다.

기본값은 europe-central2-a입니다.
Verify SSL

필수 항목입니다.

선택하면 통합에서 Google Cloud 서버에 연결할 때 SSL 인증서를 검증합니다.

기본적으로 사용 설정됩니다.

개별 사용자 인증 정보 매개변수

전체 JSON 파일 콘텐츠 또는 워크로드 아이덴티티를 사용하는 대신 사용자 인증 정보를 수동으로 입력하는 경우에만 다음 매개변수를 구성하세요.

매개변수 설명
Account Type

선택사항입니다.

JSON 키의 type 필드에서 찾은 값 (일반적으로 service_account)입니다.
Private Key ID

선택사항입니다.

JSON 키의 private_key_id 필드에서 찾은 값입니다.
Private Key

선택사항입니다.

JSON 키의 private_key 필드에서 찾은 값입니다.
Client Email

선택사항입니다.

JSON 키의 client_email 필드에서 찾은 값입니다.
Client ID

선택사항입니다.

JSON 키의 client_id 필드에서 찾은 값입니다.
Auth URI

선택사항입니다.

JSON 키의 auth_uri 필드에서 찾은 값입니다.

기본값은 https://accounts.google.com/o/oauth2/auth입니다.
Token URI

선택사항입니다.

JSON 키의 token_uri 필드에서 찾은 값입니다.

기본값은 https://oauth2.googleapis.com/token입니다.
Auth Provider X509 URL

선택사항입니다.

JSON 키의 auth_provider_x509_cert_url 필드에서 찾은 값입니다.
Client X509 URL

선택사항입니다.

JSON 키의 client_x509_cert_url 필드에서 찾은 값입니다.

Google SecOps에서 통합을 구성하는 방법에 대한 안내는 통합 구성을 참고하세요.

필요한 경우 이후 단계에서 변경할 수 있습니다. 통합 인스턴스를 구성한 후 플레이북에서 사용할 수 있습니다. 여러 인스턴스를 구성하고 지원하는 방법에 관한 자세한 내용은 여러 인스턴스 지원을 참고하세요.

작업

작업에 대한 자세한 내용은 Workdesk에서 대기 중인 작업에 응답 및 직접 조치 실행을 참고하세요.

작업 상태 가져오기

작업 상태 가져오기 작업을 사용하여 GKE 작업 상태를 가져옵니다.

이 작업은 비동기식입니다. 필요에 따라 작업에 맞게 Google SecOps 통합 개발 환경 (IDE)을 조정합니다.

이 작업은 Google SecOps 항목에서 실행되지 않습니다.

작업 입력

작업 상태 가져오기 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Location

필수 항목입니다.

작업 상태를 가져올 위치입니다(예: europe-central2-a).
Operation Name

필수 항목입니다.

가져올 작업입니다.
Wait for the operation to finish

선택사항입니다.

선택하면 작업이 작업 결과를 기다립니다.

기본적으로 선택되지 않습니다.

작업 출력

작업 상태 가져오기 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
JSON 결과

다음 예는 작업 상태 가져오기 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "name": "operation-OPERATION_ID",
    "zone": "europe-central2-a",
    "operationType": "SET_NODE_POOL_SIZE",
    "status": "RUNNING",
    "selfLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/operations/operation-OPERATION_ID",
    "targetLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/clusters/cluster-test/nodePools/default-pool",
    "startTime": "2021-08-15T11:53:55.904254615Z"
}
출력 메시지

작업 상태 가져오기 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully fetched operation details.

Failed to execute the action because API returned error, please see action logs LOG_SNIPPET.

Operation OPERATION_NAME is still in progress, current status: STATUS.

Operation OPERATION_NAME successfully finished.

Operation OPERATION_NAME failed to complete with the following status: STATUS.

 작업이 완료되었습니다.

Provided cluster location CLUSTER_LOCATION does not exist.

Provided operation name OPERATION_NAME was not found.

Error executing action "Set Node Count". Reason: ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인합니다.
스크립트 결과

다음 표에는 작업 상태 가져오기 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
is_success True 또는 False

클러스터 나열

클러스터 나열 작업을 사용하여 지정된 검색 기준에 따라 GKE 클러스터를 나열합니다.

이 작업은 Google SecOps 항목에서 실행되지 않습니다.

작업 입력

클러스터 나열 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Cluster Location

필수 항목입니다.

클러스터를 검색할 위치입니다(예: europe-central2-a).
Filter Logic

선택사항입니다.

적용할 필터 논리입니다.

필터링 로직은 cluster name 필드와 함께 작동합니다.

가능한 값은 다음과 같습니다.

  • Not Specified
  • Equal
  • Contains

기본값은 Not Specified입니다.
Filter Value

선택사항입니다.

필터에 사용할 값입니다.

필터링 로직은 cluster name 필드와 함께 작동합니다.

Filter Logic 매개변수를 Equal로 설정하면 작업에서 결과 중 Filter Value 정확한 일치를 검색합니다. Filter Logic 매개변수를 Contains로 설정하면 이 매개변수에 지정한 하위 문자열이 포함된 결과를 작업에서 검색합니다. 값을 설정하지 않으면 작업에서 필터를 무시합니다.
Max Records To Return

선택사항입니다.

반환할 레코드 수입니다.

기본값은 50입니다.

작업 출력

클러스터 나열 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 가능
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
케이스 월 테이블

클러스터 나열 작업은 다음 표를 반환할 수 있습니다.

표 이름: 발견된 클러스터

표 열:

  • ID
  • 이름
  • 설명
  • 클러스터 네트워크
  • 클러스터 IPv4 CIDR
  • 라벨
  • 클러스터 엔드포인트
  • 상태
  • 위치
  • 영역
  • 초기 클러스터 버전
  • 현재 마스터 버전
  • 현재 노드 버전
  • 생성 시간
JSON 결과

다음 예는 클러스터 나열 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
           "name": "cluster-test",
           "description": "Requested by user",
           "nodeConfig": {
               "machineType": "e2-micro",
               "diskSizeGb": 15,
               "oauthScopes": [
                   "https://www.googleapis.com/auth/devstorage.read_only",
                   "https://www.googleapis.com/auth/logging.write",
                   "https://www.googleapis.com/auth/monitoring",
                   "https://www.googleapis.com/auth/servicecontrol",
                   "https://www.googleapis.com/auth/service.management.readonly",
                   "https://www.googleapis.com/auth/trace.append"
               ],
               "metadata": {
                   "disable-legacy-endpoints": "true"
               },
               "imageType": "COS",
               "tags": [
                   "pod-net-tag"
               ],
               "serviceAccount": "default",
               "diskType": "pd-standard",
               "shieldedInstanceConfig": {
                   "enableIntegrityMonitoring": true
               }
           },
           "masterAuth": {
               "clusterCaCertificate": "CERTIFICATE"
           }
}
출력 메시지

클러스터 나열 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully found clusters for the provided criteria in GKE.

No clusters were found for the provided criteria in GKE.

 작업이 완료되었습니다.

Provided cluster location CLUSTER_LOCATION does not exist.

Invalid value was provided for "Max Records to Return": MAX_RECORDS_TO_RETURN. Positive number should be provided.

Error executing action "List Clusters". Reason: ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인합니다.
스크립트 결과

다음 표에는 클러스터 나열 작업을 사용할 때 스크립트 결과 출력의 값이 나와 있습니다.

스크립트 결과 이름 값
is_success True 또는 False

노드 풀 나열

노드 풀 나열 작업을 사용하여 지정된 검색 기준에 따라 GKE 클러스터의 노드 풀을 나열합니다.

필터링 로직은 node pool name 필드와 함께 작동합니다.

이 작업은 Google SecOps 항목에서 실행되지 않습니다.

작업 입력

노드 풀 나열 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Cluster Location

필수 항목입니다.

클러스터를 검색할 위치입니다(예: europe-central2-a).
Cluster Name

필수 항목입니다.

검색할 클러스터의 이름입니다.
Filter Logic

선택사항입니다.

적용할 필터 논리입니다.

필터링 로직은 node pool name 필드와 함께 작동합니다.

가능한 값은 다음과 같습니다.

  • Not Specified
  • Equal
  • Contains

기본값은 Not Specified입니다.
Filter Value

선택사항입니다.

필터에 사용할 값입니다.

필터링 로직은 node pool name 필드와 함께 작동합니다.

Filter Logic 매개변수를 Equal로 설정하면 작업에서 결과 중 Filter Value 정확한 일치를 검색합니다. Filter Logic 매개변수를 Contains로 설정하면 이 매개변수에 지정한 하위 문자열이 포함된 결과를 작업에서 검색합니다. 값을 설정하지 않으면 작업에서 필터를 무시합니다.
Max Records To Return

선택사항입니다.

반환할 레코드 수입니다.

기본값은 50입니다.

작업 출력

노드 풀 나열 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 가능
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
케이스 월 테이블

노드 풀 나열 작업은 다음 표를 반환할 수 있습니다.

표 이름: 발견된 노드 풀

  • 이름
  • 상태
  • 버전
  • 머신 유형
  • 태그
  • 서비스 계정
  • 초기 노드 수
  • 자동 확장
  • 최대 포드 제약 조건
  • 위치
JSON 결과

다음 예는 노드 풀 목록 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "nodePools": [
        {
            "name": "example-pool",
            "config": {
                "machineType": "e2-micro",
                "diskSizeGb": 15,
                "oauthScopes": [
                    "https://www.googleapis.com/auth/devstorage.read_only",
                    "https://www.googleapis.com/auth/logging.write",
                    "https://www.googleapis.com/auth/monitoring",
                    "https://www.googleapis.com/auth/servicecontrol",
                    "https://www.googleapis.com/auth/service.management.readonly",
                    "https://www.googleapis.com/auth/trace.append"
                ],
                "metadata": {
                    "disable-legacy-endpoints": "true"
                },
                "imageType": "COS",
                "tags": [
                    "pod-net-tag"
                ],
                "serviceAccount": "default",
                "diskType": "pd-standard",
                "shieldedInstanceConfig": {
                    "enableIntegrityMonitoring": true
                }
            },
            "initialNodeCount": 3,
            "autoscaling": {},
            "management": {
                "autoUpgrade": true,
                "autoRepair": true
            },
            "maxPodsConstraint": {
                "maxPodsPerNode": "8"
            },
            "podIpv4CidrSize": 28,
            "locations": [
                "europe-central2-a"
            ],
            "networkConfig": {
                "podRange": "gke-cluster-example-pods-ID",
                "podIpv4CidrBlock": "192.0.2.0/24"
            },
            "selfLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/clusters/cluster-example/nodePools/example-pool",
            "version": "1.18.20-gke.900",
            "instanceGroupUrls": [
                "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/europe-central2-a/instanceGroupManagers/gke-cluster-example-example-pool-ID-grp"
            ],
            "status": "RUNNING",
            "upgradeSettings": {
                "maxSurge": 1
            }
        }
    ]
}
출력 메시지

노드 풀 나열 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully found node pools for cluster CLUSTER_NAME for the provided criteria in GKE.

No node pools were found for cluster CLUSTER_NAME for the provided criteria in GKE.

 작업이 완료되었습니다.

Provided cluster location CLUSTER_LOCATION does not exist.

Provided cluster name CLUSTER_NAME was not found.

Invalid value was provided for "Max Records to Return": MAX_RECORDS_TO_RETURN. Positive number should be provided.

Error executing action "List Node Pools". Reason: ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인합니다.
스크립트 결과

다음 표에는 노드 풀 나열 작업을 사용할 때 스크립트 결과 출력의 값이 나와 있습니다.

스크립트 결과 이름 값
is_success True 또는 False

작업 나열

작업 목록 작업을 사용하여 지정된 검색 기준에 따라 위치의 GKE 작업을 나열합니다.

필터링 로직은 operation name 필드와 함께 작동합니다.

이 작업은 Google SecOps 항목에서 실행되지 않습니다.

작업 입력

작업 목록 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Cluster Location

필수 항목입니다.

작업을 검색할 위치입니다(예: europe-central2-a).
Filter Logic

선택사항입니다.

적용할 필터 논리입니다.

필터링 로직은 cluster name 필드와 함께 작동합니다.

가능한 값은 다음과 같습니다.

  • Equal
  • Contains

기본값은 Equal입니다.
Filter Value

선택사항입니다.

필터에 사용할 값입니다.

필터링 로직은 cluster name 필드와 함께 작동합니다.

Filter Logic 매개변수를 Equal로 설정하면 작업에서 결과 중 Filter Value 정확한 일치를 검색합니다. Filter Logic 매개변수를 Contains로 설정하면 이 매개변수에 지정한 하위 문자열이 포함된 결과를 작업에서 검색합니다. 값을 설정하지 않으면 작업에서 필터를 무시합니다.
Max Records To Return

선택사항입니다.

반환할 레코드 수입니다.

기본값은 50입니다.

작업 출력

작업 나열 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 가능
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
케이스 월 테이블

작업 나열 작업은 다음 표를 반환할 수 있습니다.

표 이름: Found Operations

표 열:

  • 이름
  • 영역
  • 작업 유형
  • 상태
  • 시작 시간
  • End Time
  • 타겟 링크
  • 자체 링크
JSON 결과

다음 예는 작업 목록 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "operations": [
        {
            "name": "operation-OPERATION_ID",
            "zone": "europe-central2-a",
            "operationType": "UPGRADE_MASTER",
            "status": "DONE",
            "selfLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/operations/operation-OPERATION_ID",
            "targetLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/clusters/cluster-example",
            "startTime": "2021-08-06T12:33:51.614562051Z",
            "endTime": "2021-08-06T12:38:55.038159801Z"
        },
    ]
}
출력 메시지

작업 나열 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully found operations for the provided criteria in GKE.

No operations were found for the provided criteria in GKE.

작업이 완료되었습니다.

Provided cluster location CLUSTER_LOCATION does not exist.

Error executing action "List Operations". Reason: ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인합니다.
스크립트 결과

다음 표에는 작업 목록 작업을 사용할 때 스크립트 결과 출력의 값이 나와 있습니다.

스크립트 결과 이름 값
is_success True 또는 False

핑

Ping 작업을 사용하여 GKE와의 연결을 테스트합니다.

이 작업은 Google SecOps 항목에서 실행되지 않습니다.

작업 입력

없음

작업 출력

Ping 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 불가
출력 메시지 사용 가능
스크립트 결과 사용 가능
출력 메시지

Ping 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명
Successfully connected to the GKE service with the provided connection parameters! 작업이 완료되었습니다.
Failed to connect to the GKE service! Error is ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인합니다.
스크립트 결과

다음 표에는 Ping 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
is_success True 또는 False

클러스터 부가기능 설정

클러스터 부가기능 설정 작업을 사용하여 GKE 클러스터의 부가기능을 설정합니다.

타겟 클러스터에서 이미 구성 변경이 진행 중인 경우 현재 구성 변경이 완료될 때까지 새 구성 변경을 수락할 수 없습니다.

이 작업은 비동기식으로 실행됩니다. 필요에 따라 Google SecOps IDE 설정을 조정합니다.

이 작업은 Google SecOps 항목에서 실행되지 않습니다.

작업 입력

클러스터 부가기능 설정 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Cluster Location

필수 항목입니다.

클러스터를 검색할 위치입니다(예: europe-central2-a).
Cluster Name

필수 항목입니다.

검색할 클러스터의 이름입니다.
HTTP Load Balancing

선택사항입니다.

HTTP 부하 분산 부가기능의 값입니다.

가능한 값은 다음과 같습니다.

  • Not Changed
  • Disabled
  • Enabled

기본값은 Not Changed입니다.
Horizontal Pod Autoscaling

선택사항입니다.

수평형 포드 자동 확장 부가기능의 값입니다.

가능한 값은 다음과 같습니다.

  • Not Changed
  • Disabled
  • Enabled

기본값은 Not Changed입니다.
Network Policy Config

선택사항입니다.

네트워크 정책 구성 부가기능의 값입니다.

가능한 값은 다음과 같습니다.

  • Not Changed
  • Disabled
  • Enabled

기본값은 Not Changed입니다.
Cloud Run Config

선택사항입니다.

Cloud Run 구성 부가기능의 값입니다.

가능한 값은 다음과 같습니다.

  • Not Changed
  • Disabled
  • Enabled, Load Balancer Type Unspecified
  • Enabled, Load Balancer Type External
  • Enabled, Load Balancer Type Internal

기본값은 Not Changed입니다.
DNS Cache Config

선택사항입니다.

DNS 캐시 구성 부가기능의 값입니다.

가능한 값은 다음과 같습니다.

  • Not Changed
  • Disabled
  • Enabled

기본값은 Not Changed입니다.
Config Connector Config

선택사항입니다.

구성 커넥터 구성 부가기능의 값입니다.

가능한 값은 다음과 같습니다.

  • Not Changed
  • Disabled
  • Enabled

기본값은 Not Changed입니다.
Persistent Disk Csi Driver Config

선택사항입니다.

Compute Engine 영구 디스크 컨테이너 스토리지 인터페이스 (CSI) 드라이버 구성 부가기능의 값을 지정합니다.

가능한 값은 다음과 같습니다.

  • Not Changed
  • Disabled
  • Enabled

기본값은 Not Changed입니다.
Wait for cluster configuration change operation to finish

선택사항입니다.

선택하면 작업이 클러스터 구성 변경 작업의 결과를 기다립니다.

기본적으로 선택되어 있습니다.

작업 출력

Set Cluster Addons 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
JSON 결과

다음 예시는 클러스터 부가기능 설정 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
   "name": "operation-OPERATION_ID",
   "zone": "europe-central2-a",
   "operationType": "UPDATE_CLUSTER",
   "status": "RUNNING",
   "selfLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/operations/operation-OPERATION_ID",
   "targetLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/clusters/cluster-test",
   "startTime": "2021-08-15T11:34:43.051036236Z"
}
출력 메시지

클러스터 부가기능 설정 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully created cluster configuration change operation.

Failed to execute the action because API returned error, please see action logs LOG_SNIPPET.

Operation OPERATION_NAME is still in progress, current status: STATUS.

Operation OPERATION_NAME successfully finished.

Operation OPERATION_NAME failed to complete with the following status: STATUS.

 작업이 완료되었습니다.

Provided cluster location CLUSTER_LOCATION does not exist.

Provided cluster name CLUSTER_NAME was not found.

Error executing action "Set Cluster Addons". Reason: ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인합니다.
스크립트 결과

다음 표에는 클러스터 부가기능 설정 작업을 사용할 때 스크립트 결과 출력의 값이 나와 있습니다.

스크립트 결과 이름 값
is_success True 또는 False

클러스터 라벨 설정

클러스터 라벨 설정 작업을 사용하여 GKE 클러스터의 라벨을 설정합니다. 이 작업은 기존 클러스터 라벨에 새 라벨을 추가합니다.

타겟 클러스터에서 이미 구성 변경이 진행 중인 경우 현재 구성 변경이 완료될 때까지 새 구성 변경을 수락할 수 없습니다.

이 작업은 비동기식으로 실행됩니다. 필요에 따라 Google SecOps IDE 설정을 조정합니다.

이 작업은 Google SecOps 항목에서 실행되지 않습니다.

작업 입력

클러스터 라벨 설정 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Cluster Location

필수 항목입니다.

클러스터를 검색할 위치입니다(예: europe-central2-a).
Cluster Name

필수 항목입니다.

검색할 클러스터의 이름입니다.
Cluster Labels

필수 항목입니다.

클러스터에 추가할 라벨이 포함된 JSON 객체입니다. 이 작업은 기존 클러스터 라벨에 새 라벨을 추가합니다.

기본값은 다음과 같습니다.

{
      "key1":"value1",
      "key2":"value2"
      }
Wait for cluster configuration change operation to finish

선택사항입니다.

선택하면 작업이 클러스터 구성 변경 작업의 결과를 기다립니다.

기본적으로 선택되지 않습니다.

작업 출력

클러스터 라벨 설정 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
JSON 결과

다음 예는 클러스터 라벨 설정 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "name": "operation-OPERATION_ID",
    "zone": "europe-central2-a",
    "operationType": "UPDATE_CLUSTER",
    "status": "RUNNING",
    "selfLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/operations/operation-OPERATION_ID",
    "targetLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/clusters/cluster-test",
    "startTime": "2021-08-15T11:53:55.904254615Z"
}
출력 메시지

클러스터 라벨 설정 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully created cluster configuration change operation.

Operation OPERATION_NAME is still in progress, current status: STATUS.

Operation OPERATION_NAME successfully finished.

Operation OPERATION_NAME failed to complete with the following status: STATUS.

Operation OPERATION_NAME failed to complete with the following status: STATUS.

작업이 완료되었습니다.

Provided cluster location CLUSTER_LOCATION does not exist.

Invalid value was provided for the cluster labels: CLUSTER_LABELS.

Error executing action "Set Cluster Labels". Reason: ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인합니다.
스크립트 결과

다음 표에는 클러스터 라벨 설정 작업을 사용할 때 스크립트 결과 출력의 값이 나와 있습니다.

스크립트 결과 이름 값
is_success True 또는 False

노드 자동 확장 설정

노드 자동 확장 설정 작업을 사용하여 GKE 클러스터의 노드 풀 자동 확장 구성을 설정합니다. 작업은 비동기식입니다.

타겟 클러스터에서 이미 구성 변경이 진행 중인 경우 현재 구성 변경이 완료될 때까지 새 구성 변경을 수락할 수 없습니다.

이 작업은 비동기식으로 실행됩니다. 필요에 따라 Google SecOps IDE 설정을 조정합니다.

이 작업은 Google SecOps 항목에서 실행되지 않습니다.

작업 입력

노드 자동 확장 설정 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Cluster Location

필수 항목입니다.

클러스터를 검색할 위치입니다(예: europe-central2-a).
Cluster Name

필수 항목입니다.

검색할 클러스터의 이름입니다.
Node Pool Name

필수 항목입니다.

클러스터의 노드 풀 이름입니다.
Autoscaling Mode

선택사항입니다.

노드 풀의 자동 확장 모드 상태입니다.

가능한 값은 다음과 같습니다.

  • Not Changed
  • Enabled
  • Disabled

기본값은 Not Changed입니다.
Minimum Node Count

선택사항입니다.

노드 풀 구성의 최소 노드 수입니다.
Maximum Node Count

선택사항입니다.

노드 풀 구성의 최대 노드 수입니다.
Wait for cluster configuration change operation to finish

선택사항입니다.

선택하면 작업이 클러스터 구성 변경 작업의 결과를 기다립니다.

기본적으로 선택되지 않습니다.

작업 출력

노드 자동 확장 설정 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
JSON 결과

다음 예는 노드 자동 확장 설정 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "name": "operation-OPERATION_ID",
    "zone": "europe-central2-a",
    "operationType": "UPDATE_CLUSTER",
    "status": "RUNNING",
    "selfLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/operations/operation-OPERATION_ID",
    "targetLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/clusters/cluster-test",
    "startTime": "2021-08-15T11:53:55.904254615Z"
}
출력 메시지

노드 자동 확장 설정 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully created cluster node pool configuration change operation.

Failed to execute the action because API returned error, please see action logs LOG_SNIPPET.

Operation OPERATION_NAME is still in progress, current status: STATUS.

Operation OPERATION_NAME successfully finished.

Operation OPERATION_NAME failed to complete with the following status: STATUS.

 작업이 완료되었습니다.

Provided cluster location CLUSTER_LOCATION does not exist.

Provided cluster name CLUSTER_NAME was not found.

Error executing action "Set Node Autoscaling". Reason: ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인합니다.
스크립트 결과

다음 표에는 노드 자동 확장 설정 작업을 사용할 때 스크립트 결과 출력의 값이 나와 있습니다.

스크립트 결과 이름 값
is_success True 또는 False

노드 풀 관리 설정

노드 풀 관리 설정 작업을 사용하여 GKE 클러스터의 노드 풀 관리 구성을 설정합니다.

이 작업은 비동기식으로 실행됩니다. 필요에 따라 Google SecOps IDE 설정을 조정합니다.

이 작업은 Google SecOps 항목에서 실행되지 않습니다.

작업 입력

노드 풀 관리 설정 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Cluster Location

필수 항목입니다.

클러스터를 검색할 위치입니다(예: europe-central2-a).
Cluster Name

필수 항목입니다.

검색할 클러스터의 이름입니다.
Node Pool Name

필수 항목입니다.

GKE 클러스터의 노드 풀 이름입니다.
Auto Upgrade

선택사항입니다.

자동 업그레이드 관리 기능의 상태입니다.
Auto Repair

선택사항입니다.

자동 복구 관리 기능의 상태입니다.
Wait for cluster configuration change operation to finish

선택사항입니다.

선택하면 작업이 클러스터 구성 변경 작업의 결과를 기다립니다.

기본적으로 선택되지 않습니다.

작업 출력

노드 풀 관리 설정 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
JSON 결과

다음 예는 노드 풀 관리 설정 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "name": "operation-OPERATION_ID",
    "zone": "europe-central2-a",
    "operationType": "SET_NODE_POOL_MANAGEMENT",
    "status": "RUNNING",
    "selfLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/operations/operation-OPERATION_ID",
    "targetLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/clusters/cluster-test/nodePools/default-pool",
    "startTime": "2021-08-15T11:53:55.904254615Z"
}
출력 메시지

노드 풀 관리 설정 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully created cluster node pool configuration change operation.

Failed to execute the action because API returned error, please see action logs LOG_SNIPPET.

Operation OPERATION_NAME is still in progress, current status: STATUS.

Operation OPERATION_NAME successfully finished.

Operation OPERATION_NAME failed to complete with the following status: STATUS.

 작업이 완료되었습니다.

Provided cluster location CLUSTER_LOCATION does not exist.

Provided cluster name CLUSTER_NAME was not found.

Provided node pool name NODE_POOL_NAME was not found.

Error executing action "Set Node Pool Management". Reason: ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인합니다.
스크립트 결과

다음 표에는 노드 풀 관리 설정 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
is_success True 또는 False

노드 수 설정

노드 수 설정 작업을 사용하여 GKE 클러스터 노드 풀의 노드 수를 설정합니다.

이 작업은 비동기식으로 실행됩니다. 필요에 따라 Google SecOps IDE 설정을 조정합니다.

이 작업은 Google SecOps 항목에서 실행되지 않습니다.

작업 입력

노드 수 설정 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Cluster Location

필수 항목입니다.

클러스터를 검색할 위치입니다(예: europe-central2-a).
Cluster Name

필수 항목입니다.

검색할 클러스터의 이름입니다.
Node Pool Name

필수 항목입니다.

GKE 클러스터의 노드 풀 이름입니다.
Node Count

필수 항목입니다.

GKE 클러스터 노드 풀의 노드 수입니다.
Wait for cluster configuration change operation to finish

선택사항입니다.

선택하면 작업이 클러스터 구성 변경 작업의 결과를 기다립니다.

기본적으로 선택되지 않습니다.

작업 출력

노드 수 설정 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
JSON 결과

다음 예는 노드 수 설정 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "name": "operation-OPERATION_ID",
    "zone": "europe-central2-a",
    "operationType": "SET_NODE_POOL_SIZE",
    "status": "RUNNING",
    "selfLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/operations/operation-OPERATION_ID",
    "targetLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/clusters/cluster-test/nodePools/default-pool",
    "startTime": "2021-08-15T11:53:55.904254615Z"
}
출력 메시지

노드 수 설정 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully created cluster node pool configuration change operation.

Failed to execute the action because API returned error, please see action logs LOG_SNIPPET.

Operation OPERATION_NAME is still in progress, current status: STATUS.

Operation OPERATION_NAME successfully finished.

Operation OPERATION_NAME failed to complete with the following status: STATUS.

 작업이 완료되었습니다.

Provided cluster location CLUSTER_LOCATION does not exist.

Provided cluster name CLUSTER_NAME was not found.

Provided node pool name NODE_POOL_NAME was not found.

Invalid value was provided for the node count: NODE_COUNT. The value should be a positive number.

Error executing action "Set Node Count". Reason: ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인합니다.
스크립트 결과

다음 표에는 노드 수 설정 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
is_success True 또는 False

도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가에게 문의하여 답변을 받으세요.