에이전트 풀 관리

에이전트는 Transfer Service for On Premises Data에서 데이터를 Cloud Storage로 전송하는 데 사용하는 소프트웨어입니다. 에이전트 풀은 소스 및 대상에 대한 균일한 액세스 및 가시성을 가지며 동일한 구성을 사용하는 에이전트 모음입니다.

이 가이드에서는 Transfer Service for On Premises Data 에이전트 풀을 사용하는 방법을 설명합니다.

시작하기 전에

에이전트 풀에서 작업하려면 프로젝트에 대한 특정 권한이 있어야 합니다. 권한 및 역할에 대한 자세한 내용은 IAM으로 액세스 제어를 참조하세요.

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

에이전트 풀 만들기

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

Cloud Console

  1. Cloud Console에서 Transfer Service for On Premises Data 페이지로 이동합니다.

    Transfer Service for On Premises Data로 이동

  2. 연결 설정을 클릭합니다.

    에이전트 풀 페이지가 표시되고 기존 에이전트 풀이 나열됩니다. 모든 프로젝트에는 transfer_service_default이라는 기본 풀이 포함됩니다.

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

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

  5. 풀에 전체 대역폭 단위로 적용할 대역폭 한도를 설정할 수 있습니다. 지정된 대역폭(MB/s)이 풀에 있는 모든 에이전트로 분할됩니다.

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

REST API

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

POST https://storagetransfer.googleapis.com/v1/projects/{PROJECT_ID}/agentPools/{agent_pool_id=AGENT_POOL_ID}:create

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

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

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

에이전트 풀이 Creating 상태일 때 프로젝트에서 온프레미스 전송 권한을 취소하면 잘못된 서비스 동작이 발생합니다.

gcloud

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

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

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

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

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

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

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

풀에 에이전트 할당

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

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

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

Cloud Console

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

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

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

gcloud

gcloud 명령줄 도구를 사용하여 에이전트를 만들고 해당 에이전트를 풀에 할당하려면 gcloud alpha transfer agents create를 실행합니다.

gcloud alpha transfer agents install --pool=AGENT_POOL

자세한 내용은 온프레미스 에이전트 설치 및 실행을 참조하세요.

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

에이전트를 관리하려면 온프레미스용 전송 에이전트 관리를 참조하세요.

작업에 에이전트 풀 할당

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

에이전트 풀 업데이트

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

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

Cloud Console

Cloud Console에서 에이전트 풀 페이지로 이동합니다.

에이전트 풀로 이동

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

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

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

REST API

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

예를 들어 displayNamemy-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

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

gcloud alpha 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 플래그를 사용하여 삭제할 수 있습니다.

에이전트 풀 삭제

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

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

Cloud Console

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

    에이전트 풀로 이동

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

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

REST API

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

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

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

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

gcloud

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

gcloud alpha transfer agent-pools delete NAME

다음 인수가 필요합니다.

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

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

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

에이전트 풀 가져오기

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

Cloud Console

Cloud Console에서 에이전트 풀 페이지로 이동합니다.

에이전트 풀로 이동

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

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

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

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

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

REST API

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

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

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

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

gcloud

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

gcloud alpha transfer agent-pools describe NAME

다음 인수가 필요합니다.

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

에이전트 풀 나열하기

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

Cloud Console

Cloud Console에서 에이전트 풀 페이지로 이동합니다.

에이전트 풀로 이동

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

REST API

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

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

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

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

gcloud

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

gcloud alpha 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