온프레미스용 전송 에이전트 관리

Storage Transfer Service 에이전트는 Docker 컨테이너 내에서 실행되는 애플리케이션으로, Storage Transfer Service와 조율하여 POSIX 파일 시스템 소스에서 데이터를 읽거나 POSIX 파일 시스템 싱크에 데이터를 씁니다.

전송에 POSIX 파일 시스템이 사용되지 않는 경우 에이전트를 설정할 필요가 없습니다.

이 문서에서는 서버에서 Transfer Service for On Premises Data 에이전트를 관리하는 방법을 설명합니다. 모든 에이전트는 에이전트 풀에 할당됩니다.

온프레미스 에이전트 설치 및 실행

온프레미스 에이전트를 설치하고 실행하려면 다음 안내를 따르세요.

Cloud Console

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

    Transfer Service for On Premises Data로 이동

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

  3. 새 에이전트를 추가할 에이전트 풀을 선택합니다.

  4. 에이전트 설치를 클릭합니다.

  5. 안내를 따라 에이전트를 설치 및 실행합니다.

    에이전트의 명령줄 옵션에 대한 자세한 내용은 에이전트 명령줄 옵션을 참조하세요.

gcloud CLI

gcloud 도구를 사용하여 하나 이상의 에이전트를 설치하려면 다음 단계를 따르세요.

  1. 안내에 따라 gcloud 도구를 구성합니다.

  2. gcloud transfer agents install을 실행합니다.

    gcloud transfer agents install --pool=POOL_NAME --count=1
    

    이 도구는 에이전트를 설치하는 데 필요한 단계를 안내합니다. 이 명령어는 POOL_NAME로 지정된 풀 이름에 매핑된 머신에 1개의 에이전트를 설치하며 gcloud 사용자 인증 정보를 사용하여 에이전트를 인증합니다. 풀 이름은 있어야 하며, 그렇지 않은 경우 오류가 반환됩니다.

서비스 계정 키를 사용하여 에이전트를 만들려면 --creds-file 옵션을 사용합니다.

gcloud transfer agents install --pool=my-agent-pool --count=3 \
 --creds-file=/relative/path/to/service-account-key.json

선택적인 플래그의 전체 목록을 보려면 gcloud transfer agents install --help를 실행합니다.

머신마다 둘 이상의 에이전트를 설치하는 것이 좋습니다. 실행할 에이전트 수 결정에 대한 자세한 내용은 전송 에이전트 성능 극대화를 참조하세요.

에이전트 연결 확인

온프레미스 에이전트를 설치한 후 Transfer Service for On Premises Data 에이전트 풀에 연결되었는지 확인할 수 있습니다.

에이전트가 연결되었는지 확인하려면 다음 단계를 따르세요.

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

    Transfer Service for On Premises Data로 이동

  2. 연결 설정을 클릭합니다. 에이전트 풀이 연결된 에이전트 수와 함께 표시됩니다.

  3. 연결된 에이전트에 대한 세부정보를 보려면 에이전트 풀을 선택하세요.

에이전트 생성 후 10분 내에 새 에이전트가 에이전트 풀 페이지에 표시되지 않으면 에이전트가 연결되지 않음을 참조하세요.

에이전트 활동 모니터링

Cloud Monitoring 알림을 사용하여 에이전트 활동을 모니터링할 수 있습니다.

project, agent_pool, agent_id 측정기준과 함께 Monitoring을 사용할 수 있습니다.

이 모니터링 데이터를 사용하여 전송과 관련된 잠재적인 문제를 알리도록 알림을 설정할 수 있습니다. 이를 위해서는 다음 Google Cloud 측정항목 중 하나에 대한 알림을 만드세요.

측정항목 이름 설명 내용 추천 용도
storagetransfer.googleapis.com/agent/transferred_bytes_count 특정 에이전트가 특정 시점에 서비스를 제공하는 모든 작업 사이에서 데이터가 이동하는 속도를 측정합니다. 성능 하락 알림
storagetransfer.googleapis.com/agent/connected Google Cloud가 최근 하트비트 메시지를 수신한 각 에이전트에 대해 True인 부울입니다.
  • 실패한 에이전트 알림
  • 합리적인 성능에 필요하다고 판단되는 여러 에이전트에 미달
  • 에이전트 머신 문제 알림

에이전트 중지

에이전트를 중지하려면 에이전트의 Docker 컨테이너 ID에서 docker stop을 실행합니다. ID를 찾으려면 다음 안내를 따르세요.

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

    Transfer Service for On Premises Data로 이동

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

  3. 중지할 에이전트가 포함된 에이전트 풀을 선택합니다.

  4. 목록에서 에이전트를 선택합니다. 필터 필드를 사용하여 프리픽스, 에이전트 상태, 에이전트 연령 등을 검색합니다.

  5. 에이전트 중지를 클릭합니다. 특정 컨테이너 ID가 표시된 docker stop 명령어가 표시됩니다.

  6. 에이전트가 실행 중인 머신에서 명령어를 실행합니다. docker stop 명령어가 성공하면 컨테이너 ID가 반환됩니다.

중지되면 에이전트가 에이전트 풀 목록에 연결 해제됨으로 표시됩니다.

에이전트 삭제

특정 에이전트를 삭제하려면 머신에서 실행 중인 에이전트를 나열하세요.

docker container list --all --filter ancestor=gcr.io/cloud-ingest/tsop-agent

그런 다음 에이전트 ID를 transfer agents delete에 전달합니다.

gcloud transfer agents delete --ids=id1,id2,…

머신에서 실행 중인 모든 에이전트를 삭제하려면 --all 플래그 또는 --uninstall 플래그를 사용하세요. 두 플래그는 모두 머신의 모든 에이전트를 삭제합니다. --uninstall 플래그는 에이전트 Docker 이미지를 추가로 제거합니다.

gcloud transfer agents delete --all
gcloud transfer agents delete --uninstall