전송 에이전트 명령줄 옵션

전송 에이전트는 데이터를 파일 시스템에서 Google Cloud로 전송합니다. 이 페이지에 설명된 플래그와 옵션을 통해 에이전트를 실행할 때 에이전트 옵션을 제어할 수 있습니다.

명령어 요약

sudo docker run [--ulimit memlock=64000000 -d --rm -v host-directory:container-directory]
--env environment-variable=variable-value
gcr.io/cloud-ingest/tsop-agent:latest
{--help | --version | --project-id=project-id}
[--agent-id-prefix=id-prefix --creds-file=credential-file
--enable_mount_directory --hostname=hostname
--log-dir=logs-directory
--max-physical-mem=maximum-memory]

Docker 옵션

--ulimit memlock=64000000

Docker의 공유 풀에 대한 공유 메모리를 잠가 여러 세션에서 액세스할 수 있도록 메모리에 저장합니다.

-d

Docker 컨테이너를 분리 모드 또는 백그라운드에서 시작합니다. 이렇게 하면 Linux 터미널에서 명령어를 계속 실행할 수 있습니다.

자세한 내용은 분리됨 -d를 참조하세요.

--rm

Docker가 종료되면 컨테이너와 컨테이너의 파일 시스템을 삭제합니다.

자세한 내용은 정리(--rm)를 참조하세요.

-v host-directory:container-directory

호스트에서 컨테이너로 매핑할 볼륨을 한 개 이상 지정합니다. -v를 사용할 경우 host-directory와 container-directory가 동일해야 합니다. 그렇지 않으면 Storage Transfer Service에서 전송할 파일을 찾지 못합니다.

자세한 내용은 볼륨(공유 파일 시스템)을 참조하세요.

--env environment-variable=variable-value

Docker 컨테이너의 환경 변수를 지정합니다. 이 플래그를 사용하여 에이전트가 전달 프록시를 사용하도록 구성합니다. 자세한 내용은 전달 프록시 사용을 참조하세요.

에이전트 옵션

--agent-id-prefix=id-prefix

Google Cloud Console에서 에이전트 또는 머신을 식별하는 데 유용하도록 에이전트 ID 앞에 추가되는 선택적 프리픽스입니다. 프리픽스가 사용되면 에이전트 ID 형식은 prefix + hostname + Docker container ID로 지정됩니다.

--creds-file=credential-file

JSON 형식의 서비스 계정 사용자 인증 정보 파일(선택 사항)입니다. 서비스 계정 사용자 인증 정보 파일을 생성하는 방법에 대한 자세한 내용은 서비스 계정 키 생성 및 관리를 참조하세요.

참고: --enable_mount_directory를 사용하지 않으면 이 경로에 /transfer_root 프리픽스를 추가해야 합니다(예: /transfer_root/path/to/cred_file.json).

--enable_mount_directory

원하는 경우 개별 Docker -v 볼륨 마운트를 지정하지 않고 Docker 컨테이너의 /transfer_root 디렉터리에 전체 파일 시스템을 마운트합니다. 이 플래그를 사용하면 /transfer_root 프리픽스를 로그 디렉터리 또는 서비스 계정 사용자 인증 정보 파일 경로에 추가할 필요가 없으며 전송 로그 또는 GUI 오류 샘플에 /transfer_root가 표시되지 않습니다.

--help

간단한 사용 도움말을 표시합니다.

--hostname=hostname

에이전트가 실행되는 호스트 이름을 설정합니다. 특정 에이전트가 실행 중인 머신의 호스트 이름을 보고하는 데 사용됩니다.

참고: 이 플래그를 사용할 경우 --hostname=$(hostname)을 전달하는 것이 좋습니다.

--log-dir=logs-directory

에이전트가 로그를 쓰는 선택적 디렉터리입니다. 기본 디렉터리는 /tmp/입니다.

참고: --enable_mount_directory를 사용하지 않으면 이 경로에 /transfer_root 프리픽스를 추가해야 합니다(예: /transfer/root/path/to/log_file).

--max-physical-mem=maximum-memory

에이전트는 기본적으로 최대 8GiB 시스템 메모리를 사용합니다. 기본값이 사용자 환경에 맞지 않으면 다음 형식으로 관련 최대 메모리 사용량을 지정할 수 있습니다.

max-physical-mem 값	최대 메모리 설정
6g	6GB
6gb	6GB
6GiB	6GB

--project-id=project-id

생성되고 청구되는 전송 리소스를 호스팅하는 프로젝트 ID의 필수 문자열입니다.

--version

에이전트의 현재 버전을 표시합니다.