온프레미스 또는 프라이빗 클라우드 파일 시스템(예: POSIX 규격 파일 시스템, NFS, SMB)에서 데이터를 전송하려면 소스 파일에 대한 네트워크 액세스 권한이 있는 머신에 Storage Transfer Service 에이전트를 설치하고 구성해야 합니다.
기본 요건
전송을 구성하기 전에 다음을 설정했는지 확인하세요.
- 사용자 권한: 사용자 계정 또는 사용자 관리형 서비스 계정에 전송 작업 및 에이전트 풀을 구성할 권한이 있는지 확인합니다. 필수 사용자 권한을 참고하세요.
- 에이전트 기반 프로젝트 수준 권한: 서비스 에이전트 및 전송 에이전트 계정에 필요한 프로젝트 수준 역할을 구성했는지 확인합니다. 에이전트 기반 프로젝트 수준 권한을 참조하세요.
- 대상 권한: 전송 대상에 따라 필요한 싱크 권한을 구성합니다.
- Cloud Storage로 전송하는 경우 싱크에 대한 액세스 구성: Cloud Storage를 참조하세요.
- 다른 파일 시스템으로 전송하려면 싱크에 대한 액세스 구성: 파일 시스템을 참조하세요.
로컬 파일 시스템 권한
전송 에이전트는 호스트 머신의 Docker 또는 Podman 컨테이너 내에서 실행됩니다. 에이전트가 파일을 읽을 수 있도록 하려면 다음 단계를 따르세요.
- OS 사용자 권한: 컨테이너를 실행하는 운영체제 사용자에게 전송하려는 모든 파일 및 디렉터리에 대한 읽기(및 디렉터리 실행) 권한이 있는지 확인합니다.
디렉터리 마운트: 에이전트를 설치할 때
--mount-directories플래그(또는 Docker의-v플래그)를 사용하여 컨테이너에 복사할 디렉터리를 마운트합니다.gcloud transfer agents install --pool=AGENT_POOL_NAME \ --mount-directories=/path/to/source/dir
에이전트가 볼 수 있는 호스트 디렉터리를 제한하려면 에이전트 디렉터리 액세스 제한을 참조하세요.
성능 및 최적화
- 대규모 파일 시스템에서 전송할 때 처리량을 극대화하려면 소스 에이전트 풀에 여러 에이전트를 설치하세요(최소 3개 권장). 전송 에이전트 권장사항을 참조하세요.
- 1GB보다 큰 파일의 경우 멀티파트 업로드를 사용 설정하는 것이 좋습니다.
다음 단계
- 전송 에이전트 설치 방법 알아보기
- 에이전트 풀을 만드는 방법 알아보기
- 싱크에 대한 액세스 구성: Cloud Storage 방법 알아보기
- 싱크에 대한 액세스 구성: 파일 시스템 방법 알아보기