에이전트 풀은 소스 및 대상에 대한 균일한 액세스 및 가시성을 가지며 동일한 구성을 사용하는 에이전트 모음입니다. 또한 에이전트 풀은 전송 대역폭 한도를 제어합니다.
모든 에이전트는 에이전트 풀에 속해야 합니다.
이 가이드에서는 에이전트 풀을 사용하는 방법을 설명합니다.
시작하기 전에
에이전트 풀을 사용하려면 프로젝트에 대한 올바른 권한이 있어야 합니다. 자세한 내용은 IAM으로 액세스 제어를 참조하세요.
현재 권한을 확인할 수 있습니다.
gcloud
명령어를 사용하려면 gcloud 명령줄 도구를 설치합니다.
에이전트 풀 만들기
에이전트 풀을 만들려면 다음 안내를 따르세요.
Google Cloud 콘솔
Google Cloud 콘솔에서 에이전트 풀 페이지로 이동합니다.
에이전트 풀 페이지가 표시되고 기존 에이전트 풀이 나열됩니다.
다른 풀 만들기를 클릭합니다.
풀 이름을 지정하고 필요한 경우 설명합니다.
풀에 전체 대역폭 단위로 적용할 대역폭 한도를 설정할 수 있습니다. 지정된 대역폭(MB/s)이 풀에 있는 모든 에이전트로 분할됩니다. 자세한 내용은 네트워크 대역폭 관리를 참조하세요.
만들기를 클릭합니다.
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 AGENT_POOL
사용 가능한 옵션은 다음과 같습니다.
AGENT_POOL은 이 풀의 고유한 영구 식별자입니다.
--no-async
는 풀이 생성될 때까지 터미널에서 다른 태스크를 차단합니다. 이를 포함하지 않으면 풀 생성이 비동기적으로 실행됩니다.--bandwidth-limit
는 이 풀의 에이전트에 제공할 수 있는 대역폭 양을 MB/초 단위로 정의합니다. 대역폭 한도는 풀의 모든 에이전트에 적용되며 풀의 전송 워크로드가 대역폭을 공유하는 다른 작업을 중단시키는 것을 방지할 수 있습니다. 예를 들어 대역폭 한도를 50MB/s로 설정하려면 '50'을 입력합니다. 이 플래그를 지정하지 않으면 이 풀의 에이전트는 사용 가능한 모든 대역폭을 사용합니다.--display-name
은 이 풀을 식별하는 데 도움이 되는 수정 가능한 이름입니다. 풀의 고유한 전체 리소스 이름에 맞지 않을 수 있는 세부정보를 포함할 수 있습니다.
풀에 에이전트 할당
새 에이전트 풀이 비어 있으며 여기에 에이전트가 할당되어 있어야 합니다. 에이전트는 에이전트를 만들 때만 에이전트 풀에 할당할 수 있습니다.
에이전트 풀을 지정하지 않으면 에이전트가 transfer_service_default
풀에 할당됩니다.
에이전트를 만들고 풀에 할당하려면 다음 안내를 따르세요.
Google Cloud 콘솔
에이전트 풀 페이지에서 에이전트를 할당할 풀을 선택합니다.
에이전트 설치를 클릭합니다. 에이전트 설치 가이드가 표시됩니다.
안내에 따라 이 에이전트 풀에서 에이전트를 만듭니다.
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=AGENT_POOL
자세한 내용은 전송 에이전트 관리를 참조하세요.
추가 옵션은 고급 에이전트 옵션을 참조하세요.
에이전트를 관리하려면 전송 에이전트 관리를 참조하세요.
작업에 에이전트 풀 할당
에이전트 풀이 생성되면 작업 생성 또는 업데이트 중에 작업에 할당될 수 있습니다.
에이전트 풀 업데이트
에이전트 풀의 표시 이름과 대역폭 한도를 업데이트할 수 있습니다.
에이전트 풀을 업데이트하려면 다음 안내를 따르세요.
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:"displayName,NEW_DISPLAY_NAME"
각 항목의 의미는 다음과 같습니다.
PROJECT_ID
: 에이전트 풀을 업데이트하려는 프로젝트 ID입니다.AGENT_POOL
: 업데이트 중인 에이전트 풀의 이름입니다.NEW_DISPLAY_NAME
: 이 에이전트 풀의 새 표시 이름입니다.
다음은 대역폭 한도를 업데이트하는 패치 요청의 예시입니다.
PATCH https://storagetransfer.googleapis.com/v1/projects/PROJECT_ID/agentPools/AGENT_POOL:"bandwidthLimit,NEW_LIMIT"
각 항목의 의미는 다음과 같습니다.
PROJECT_ID
: 에이전트 풀을 업데이트하려는 프로젝트 ID입니다.AGENT_POOL
: 업데이트하려는 에이전트 풀 ID입니다.NEW_LIMIT
: 이 에이전트 풀의 새 대역폭 한도입니다.
gcloud CLI
gcloud
명령줄 도구를 사용하여 에이전트 풀을 업데이트하려면 gcloud transfer agent-pools update
를 실행합니다.
gcloud transfer agent-pools update AGENT_POOL \
[--bandwidth-limit=NEW_BANDWIDTH_LIMIT] [--clear-bandwidth-limit] \
[--clear-display-name] [--display-name=NEW_DISPLAY_NAME]
다음 인수가 필요합니다.
- AGENT_POOL은 이 풀의 고유한 영구 식별자입니다.
AGENT_POOL
은 업데이트할 에이전트 풀을 식별하며 자체적으로 업데이트할 수 없습니다.
이 명령어로 다음 플래그를 지정할 수 있습니다.
--bandwidth-limit
은 업데이트할 수 있으며, 대신--clear-bandwidth-limit
을 지정하여 삭제할 수 있습니다. 대역폭 한도에 대한 자세한 내용은 에이전트 풀 만들기를 참조하세요.--display-name
은 업데이트할 수 있으며, 대신--clear-display-name
플래그를 사용하여 삭제할 수 있습니다.
에이전트 풀 삭제
활성 에이전트가 없고 활성 작업이 실행되지 않은 에이전트 풀을 삭제할 수 있습니다.
에이전트 풀을 삭제하려면 다음 안내를 따르세요.
Google Cloud 콘솔
Google Cloud 콘솔에서 에이전트 풀 페이지로 이동합니다.
삭제를 클릭합니다. 팝업을 읽은 후 삭제를 클릭하여 확인합니다.
삭제 버튼이 활성 상태가 아니면 이 풀과 연결된 모든 에이전트 및 작업을 중지해야 합니다.
REST API
projects.agentPools.delete를 사용합니다.
DELETE https://storagetransfer.googleapis.com/v1/projects/PROJECT_ID/agentPools/AGENT_POOL
각 항목의 의미는 다음과 같습니다.
PROJECT_ID
: 에이전트 풀을 삭제할 프로젝트 ID입니다.AGENT_POOL
: 에이전트 풀 이름입니다.
gcloud CLI
gcloud
명령줄 도구를 사용하여 에이전트 풀을 삭제하려면 gcloud transfer agent-pools delete
를 실행합니다.
gcloud transfer agent-pools delete AGENT_POOL
다음 인수가 필요합니다.
- AGENT_POOL은 이 풀의 고유한 영구 식별자입니다.
풀을 삭제하려면 풀의 모든 에이전트를 중지하고 풀의 작업을 사용 중지해야 하며 이 풀에 진행 중인 전송 작업이 없어야 합니다.
풀과 관련된 모든 작업을 보려면 Google Cloud Console에서 풀을 선택하고 전송 작업 탭을 클릭합니다.
에이전트 풀 가져오기
에이전트 풀을 가져오려면 다음 안내를 따르세요.
Google Cloud 콘솔
Google Cloud 콘솔에서 에이전트 풀 페이지로 이동합니다.
이 페이지에는 프로젝트와 관련된 모든 에이전트 풀의 목록과 각 에이전트 풀에 대한 다음 정보가 표시됩니다.
- 에이전트 풀 이름
- 연결 상태
- 연결된 에이전트 수
- 대역폭 한도 (설정된 경우)
- 연결된 전송 작업 수
- 에이전트 풀의 표시 이름
특정 에이전트 풀을 보려면 에이전트 풀의 이름을 클릭합니다.
다음 작업은 에이전트 풀의 정보 페이지에서 수행할 수 있습니다.
- 에이전트 설치: 전송 에이전트 설치에 대한 안내를 표시합니다.
- 에이전트 중지: 테이블에서 에이전트를 선택한 다음 에이전트 중지를 클릭합니다.
- 전송 작업 나열: 전송 작업을 클릭하여 이 풀의 에이전트가 연결된 전송 작업을 표시합니다.
REST API
projects.agentPools.get을 사용합니다.
GET https://storagetransfer.googleapis.com/v1/projects/PROJECT_ID/agentPools/AGENT_POOL
각 항목의 의미는 다음과 같습니다.
PROJECT_ID
: 에이전트 풀을 가져올 프로젝트 ID입니다.AGENT_POOL
: 검색할 에이전트 풀입니다.
gcloud CLI
gcloud
명령줄 도구를 사용하여 에이전트 풀을 검색하려면 gcloud transfer agent-pools describe
을 실행합니다.
gcloud transfer agent-pools describe AGENT_POOL
다음 인수가 필요합니다.
- AGENT_POOL은 이 풀의 고유한 영구 식별자입니다.
에이전트 풀 나열하기
에이전트 풀을 나열하려면 다음 안내를 따르세요.
Google Cloud 콘솔
Google Cloud 콘솔에서 에이전트 풀 페이지로 이동합니다.
모든 에이전트 풀이 표시됩니다.
REST API
projects.agentPools.list를 사용합니다.
GET https://storagetransfer.googleapis.com/v1/projects/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