에이전트 풀 관리

에이전트 풀은 소스 및 대상에 대한 균일한 액세스 및 가시성을 가지며 동일한 구성을 사용하는 에이전트 모음입니다. 또한 에이전트 풀은 전송 대역폭 한도를 제어합니다.

모든 에이전트는 에이전트 풀에 속해야 합니다.

이 가이드에서는 에이전트 풀을 사용하는 방법을 설명합니다.

시작하기 전에

에이전트 풀을 사용하려면 프로젝트에 대한 올바른 권한이 있어야 합니다. 자세한 내용은 IAM으로 액세스 제어를 참조하세요.

현재 권한을 확인할 수 있습니다.

gcloud 명령어를 사용하려면 gcloud 명령줄 도구를 설치합니다.

에이전트 풀 만들기

에이전트 풀 이름에 개인 식별 정보(PII) 또는 보안 데이터와 같은 민감한 정보를 포함하지 마세요. 리소스 이름은 다른 Google Cloud 리소스의 이름으로 전파될 수 있으며 프로젝트 외부의 Google 내부 시스템에 노출될 수 있습니다.

에이전트 풀을 만들려면 다음 안내를 따르세요.

Google Cloud 콘솔

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

    에이전트 풀로 이동

    에이전트 풀 페이지가 표시되고 기존 에이전트 풀이 나열됩니다.

  2. 다른 풀 만들기를 클릭합니다.

  3. 풀 이름을 지정하고 필요한 경우 설명합니다.

  4. 풀에 전체 대역폭 단위로 적용할 대역폭 한도를 설정할 수 있습니다. 지정된 대역폭(MB/s)이 풀에 있는 모든 에이전트로 분할됩니다. 자세한 내용은 네트워크 대역폭 관리를 참조하세요.

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

REST API

projects.agentPools.create를 사용합니다.

POST https://storagetransfer.googleapis.com/v1/projects/PROJECT_ID/agentPools?agent_pool_id=AGENT_POOL_ID

각 항목의 의미는 다음과 같습니다.

  • PROJECT_ID: 에이전트 풀을 만들려는 프로젝트 ID입니다.
  • AGENT_POOL_ID: 만들려는 에이전트 풀 ID입니다.

에이전트 풀이 Creating 상태에서 30분이 넘게 정체되는 경우 에이전트 풀을 삭제하고 다시 만드는 것이 좋습니다.

에이전트 풀이 Creating 상태일 때 프로젝트에서 필수 Storage Transfer Service 권한을 취소하면 잘못된 서비스 동작이 발생합니다.

gcloud CLI

gcloud 명령줄 도구를 사용하여 에이전트 풀을 만들려면 gcloud transfer agent-pools create를 실행합니다.

gcloud transfer agent-pools create NAME \
  [--no-async] \
  [--bandwidth-limit=BANDWIDTH_LIMIT] \
  [--display-name=DISPLAY_NAME]

사용 가능한 옵션은 다음과 같습니다.

  • NAME은 이 풀의 고유한 영구 식별자입니다.

  • --no-async는 풀이 생성될 때까지 터미널에서 다른 태스크를 차단합니다. 이를 포함하지 않으면 풀 생성이 비동기적으로 실행됩니다.

  • --bandwidth-limit는 이 풀의 에이전트에 제공할 수 있는 대역폭 양을 MB/초 단위로 정의합니다. 대역폭 한도는 풀의 모든 에이전트에 적용되며 풀의 전송 워크로드가 대역폭을 공유하는 다른 작업을 중단시키는 것을 방지할 수 있습니다. 예를 들어 대역폭 한도를 50MB/s로 설정하려면 '50'을 입력합니다. 이 플래그를 지정하지 않으면 이 풀의 에이전트는 사용 가능한 모든 대역폭을 사용합니다.

  • --display-name은 이 풀을 식별하는 데 도움이 되는 수정 가능한 이름입니다. 풀의 고유한 전체 리소스 이름에 맞지 않을 수 있는 세부정보를 포함할 수 있습니다.

풀에 에이전트 할당

새 에이전트 풀이 비어 있으며 여기에 에이전트가 할당되어 있어야 합니다. 에이전트는 에이전트를 만들 때만 에이전트 풀에 할당할 수 있습니다.

에이전트 풀을 지정하지 않으면 에이전트가 transfer_service_default 풀에 할당됩니다.

에이전트를 만들고 풀에 할당하려면 다음 안내를 따르세요.

Google Cloud 콘솔

  1. 에이전트 풀 페이지에서 에이전트를 할당할 풀을 선택합니다.

  2. 에이전트 설치를 클릭합니다. 에이전트 설치 가이드가 표시됩니다.

  3. 안내에 따라 이 에이전트 풀에서 에이전트를 만듭니다.

gcloud CLI

gcloud 명령줄 도구를 사용하여 에이전트를 만들고 해당 에이전트를 풀에 할당하려면 gcloud transfer agents install를 실행합니다. 에이전트가 파일 시스템에 대한 루트 액세스 권한이 있는 머신에 설치되어야 합니다.

gcloud transfer agents install --pool=AGENT_POOL

S3 호환 소스에 사용할 에이전트를 설치하려면 AWS_ACCESS_KEY_ID 및 AWS_SECRET_ACCESS_KEY의 값과 같은 환경 변수로 액세스 사용자 인증 정보를 제공하거나 시스템 구성 파일에 저장된 기본 사용자 인증 정보를 제공합니다.

export AWS_ACCESS_KEY_ID=ID
export AWS_SECRET_ACCESS_KEY=SECRET
gcloud transfer agents install --pool=POOL_NAME

자세한 내용은 전송 에이전트 관리를 참조하세요.

추가 옵션은 고급 에이전트 옵션을 참조하세요.

에이전트를 관리하려면 전송 에이전트 관리를 참조하세요.

작업에 에이전트 풀 할당

에이전트 풀이 생성되면 작업 생성 또는 업데이트 중에 작업에 할당될 수 있습니다.

에이전트 풀 업데이트

에이전트 풀의 표시 이름과 대역폭 한도를 업데이트할 수 있습니다.

에이전트 풀을 업데이트하려면 다음 안내를 따르세요.

Google Cloud 콘솔

Google Cloud 콘솔에서 에이전트 풀 페이지로 이동합니다.

에이전트 풀로 이동

다음 항목을 수정할 수 있습니다.

  • 에이전트 풀의 표시 이름: 현재 에이전트 풀 이름 옆에 있는 수정을 클릭합니다.

  • 에이전트 풀의 대역폭 한도: 대역폭 한도 설정을 클릭하고 대역폭 한도 설정 대화상자에 새 대역폭 한도를 입력합니다. 한도 설정을 클릭하여 새 대역폭 한도를 적용합니다. 대역폭은 풀의 모든 에이전트에서 공유됩니다.

REST API

에이전트 풀을 업데이트하려면 projects.agentPools.patch를 업데이트할 필드의 필드 마스크와 함께 사용합니다. 다음 에이전트 풀 필드를 업데이트할 수 있습니다.

예를 들어 displayName를 my-transfer로 업데이트하려면 필드 마스크 "displayName,my-transfer"를 제공합니다.

다음은 표시 이름을 업데이트하기 위한 패치 요청 예시입니다.

PATCH https://storagetransfer.googleapis.com/v1/projects/{PROJECT_ID}/agentPools/{AGENT_POOL_ID}:"displayName,NEW_NAME"

각 항목의 의미는 다음과 같습니다.

  • PROJECT_ID: 에이전트 풀을 업데이트하려는 프로젝트 ID입니다.
  • AGENT_POOL_ID: 업데이트하려는 에이전트 풀 ID입니다.
  • NEW_NAME: 이 에이전트 풀의 새 표시 이름입니다.

다음은 대역폭 한도를 업데이트하는 패치 요청의 예시입니다.

PATCH https://storagetransfer.googleapis.com/v1/projects/{PROJECT_ID}/agentPools/{AGENT_POOL_ID}:"bandwidthLimit,NEW_LIMIT"

각 항목의 의미는 다음과 같습니다.

  • PROJECT_ID: 에이전트 풀을 업데이트하려는 프로젝트 ID입니다.
  • AGENT_POOL_ID: 업데이트하려는 에이전트 풀 ID입니다.
  • NEW_LIMIT: 이 에이전트 풀의 새 대역폭 한도입니다.

gcloud CLI

gcloud 명령줄 도구를 사용하여 에이전트 풀을 업데이트하려면 gcloud transfer agent-pools update를 실행합니다.

gcloud transfer agent-pools update NAME \
  [--bandwidth-limit=NEW_BANDWIDTH_LIMIT] [--clear-bandwidth-limit] \
  [--clear-display-name] [--display-name=NEW_DISPLAY_NAME]

다음 인수가 필요합니다.

  • NAME은 이 풀의 고유한 영구 식별자입니다. NAME은 업데이트할 에이전트 풀을 식별하며 자체적으로 업데이트할 수 없습니다.

이 명령어로 다음 플래그를 지정할 수 있습니다.

  • --bandwidth-limit은 업데이트할 수 있으며, 대신 --clear-bandwidth-limit을 지정하여 삭제할 수 있습니다. 대역폭 한도에 대한 자세한 내용은 에이전트 풀 만들기를 참조하세요.

  • --display-name은 업데이트할 수 있으며, 대신 --clear-display-name 플래그를 사용하여 삭제할 수 있습니다.

에이전트 풀 삭제

활성 에이전트가 없고 활성 작업이 실행되지 않은 에이전트 풀을 삭제할 수 있습니다.

에이전트 풀을 삭제하려면 다음 안내를 따르세요.

Google Cloud 콘솔

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

    에이전트 풀로 이동

  2. 삭제를 클릭합니다. 팝업을 읽은 후 삭제를 클릭하여 확인합니다.

    삭제 버튼이 활성 상태가 아니면 이 풀과 연결된 모든 에이전트 및 작업을 중지해야 합니다.

REST API

projects.agentPools.delete를 사용합니다.

DELETE https://storagetransfer.googleapis.com/v1/{name=PROJECT_ID/*/agentPools/}

각 항목의 의미는 다음과 같습니다.

  • PROJECT_ID: 에이전트 풀을 삭제할 프로젝트 ID입니다.

gcloud CLI

gcloud 명령줄 도구를 사용하여 에이전트 풀을 삭제하려면 gcloud transfer agent-pools delete를 실행합니다.

gcloud transfer agent-pools delete NAME

다음 인수가 필요합니다.

  • NAME은 이 풀의 고유한 영구 식별자입니다.

풀을 삭제하려면 풀의 모든 에이전트를 중지하고 풀의 작업을 사용 중지해야 하며 이 풀에 진행 중인 전송 작업이 없어야 합니다.

풀과 관련된 모든 작업을 보려면 Google Cloud Console에서 풀을 선택하고 전송 작업 탭을 클릭합니다.

에이전트 풀 가져오기

에이전트 풀을 가져오려면 다음 안내를 따르세요.

Google Cloud 콘솔

Google Cloud 콘솔에서 에이전트 풀 페이지로 이동합니다.

에이전트 풀로 이동

이 페이지에는 프로젝트와 관련된 모든 에이전트 풀의 목록과 각 에이전트 풀에 대한 다음 정보가 표시됩니다.

  • 에이전트 풀 이름
  • 연결 상태
  • 연결된 에이전트 수
  • 대역폭 한도 (설정된 경우)
  • 연결된 전송 작업 수
  • 에이전트 풀의 표시 이름

특정 에이전트 풀을 보려면 에이전트 풀의 이름을 클릭합니다.

다음 작업은 에이전트 풀의 정보 페이지에서 수행할 수 있습니다.

  • 에이전트 설치: 전송 에이전트 설치에 대한 안내를 표시합니다.
  • 에이전트 중지: 테이블에서 에이전트를 선택한 다음 에이전트 중지를 클릭합니다.
  • 전송 작업 나열: 전송 작업을 클릭하여 이 풀의 에이전트가 연결된 전송 작업을 표시합니다.

REST API

projects.agentPools.get을 사용합니다.

GET https://storagetransfer.googleapis.com/v1/{name=PROJECT_ID/*/agentPools/}

각 항목의 의미는 다음과 같습니다.

  • PROJECT_ID: 에이전트 풀을 가져올 프로젝트 ID입니다.

gcloud CLI

gcloud 명령줄 도구를 사용하여 에이전트 풀을 검색하려면 gcloud transfer agent-pools describe을 실행합니다.

gcloud transfer agent-pools describe NAME

다음 인수가 필요합니다.

  • NAME은 이 풀의 고유한 영구 식별자입니다.

에이전트 풀 나열하기

에이전트 풀을 나열하려면 다음 안내를 따르세요.

Google Cloud 콘솔

Google Cloud 콘솔에서 에이전트 풀 페이지로 이동합니다.

에이전트 풀로 이동

모든 에이전트 풀이 표시됩니다.

REST API

projects.agentPools.list를 사용합니다.

GET https://storagetransfer.googleapis.com/v1/projects/{project_id=PROJECT_ID}/agentPools

각 항목의 의미는 다음과 같습니다.

  • PROJECT_ID: 에이전트 풀을 가져올 프로젝트 ID입니다.

gcloud CLI

gcloud 명령줄 도구를 사용하여 에이전트 풀을 나열하려면 gcloud transfer agent-pools list를 실행합니다.

gcloud transfer agent-pools list \
  [--limit=LIMIT] \
  [--names=[NAMES,...]] \
  [--page-size=PAGE_SIZE]

이 명령어로 다음 플래그를 지정할 수 있습니다.

  • --limit는 반환할 최대 에이전트 풀 수를 정의합니다.

  • --names는 나열할 에이전트 풀의 이름을 지정합니다. 여러 이름을 쉼표로 구분합니다(예: --names=foo,bar). 지정하지 않으면 현재 프로젝트의 모든 에이전트 풀이 나열됩니다.

  • --page-size는 이 명령어의 일괄 처리 동작을 정의합니다. 기본적으로 list 명령어는 응답을 256개 항목으로 일괄 처리하여 모든 항목이 나열되거나 limit에 도달할 때까지 다음 배치를 자동으로 가져옵니다.

이 명령어는 일치하는 에이전트 풀 및 구성 세부정보의 목록을 반환합니다. 다음 예시는 샘플 응답을 보여줍니다.

name: projects/my-project-123/agentPools/my-first-pool
state: CREATED
---
bandwidthLimit:
  limitMbps: '120'
displayName: Source A to destination Z.
name: projects/my-project-123/agentPools/a2z-pool
state: CREATED