Opções de linha de comando do agente de transferência

Os agentes transferem dados do sistema de arquivos para o Google Cloud. Quando você executar um agente, é possível controlar as opções dele por meio das sinalizações e opções descritas nesta página.

Resumo do comando

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]

Opções do Docker

--ulimit memlock=64000000

Bloqueia a memória compartilhada de um pool compartilhado do Docker, para que ele esteja sempre na memória para acesso por várias sessões.

-d

Inicia o contêiner do Docker no modo desvinculado ou em segundo plano. Isso permite que você continue emitindo comandos do terminal Linux.

Para mais informações, consulte -d desconectado.

--rm

Exclui o contêiner e o sistema de arquivos dele quando o Docker é encerrado.

Para mais informações, consulte Limpeza (--rm)

-v host-directory:container-directory

Especifica um ou mais volumes (em inglês) a serem mapeados do host para o contêiner. Ao usar -v, é necessário que host-directory e container-directory sejam iguais. Caso contrário, o Serviço de transferência do Cloud Storage não localizará os arquivos para transferência.

Para mais informações, consulte VOLUME (sistemas de arquivos compartilhados) (em inglês)

--env environment-variable=variable-value

Especifica uma variável de ambiente para o contêiner do Docker. Use esta sinalização para configurar seus agentes e usar um proxy de encaminhamento. Para mais informações, consulte Como usar um proxy de encaminhamento.

Opções do agente

--agent-id-prefix=id-prefix

Um prefixo opcional que é anexado ao ID do agente para ajudar a identificar o agente ou a máquina no Console do Google Cloud. Quando um prefixo é usado, o ID do agente é formatado como prefix + hostname + Docker container ID.

--creds-file=credential-file

Um arquivo de credencial de conta de serviço no formato JSON opcional. Para mais informações sobre como gerar um arquivo de credencial da conta de serviço, consulte Como criar e gerenciar chaves da conta de serviço.

Observação: a menos que você esteja usando --enable_mount_directory, será necessário prefixar esse caminho com /transfer_root, por exemplo, /transfer_root/path/to/cred_file.json.

--enable_mount_directory

Como alternativa, ative todo o sistema de arquivos no diretório /transfer_root do contêiner do Docker, em vez de especificar ativações de volume -v do Docker (em inglês) individuais. Ao usar essa sinalização, não é necessário adicionar o prefixo /transfer_root ao diretório de registros ou ao caminho do arquivo de credenciais da conta de serviço. Além disso, /transfer_root não é visível em registros de transferência ou amostras de erro de GUI.

--help

Exibe uma breve ajuda de uso.

--hostname=hostname

Define o nome do host em que o agente está sendo executado. Usado para informar o nome do host da máquina em que um determinado agente está sendo executado.

Observação: recomendamos transmitir --hostname=$(hostname) ao usar essa flag.

--log-dir=logs-directory

Um diretório opcional em que o agente grava registros. O diretório padrão é /tmp/.

Observação: a menos que você esteja usando --enable_mount_directory, será necessário prefixar esse caminho com /transfer_root, por exemplo, /transfer/root/path/to/log_file.

--max-physical-mem=maximum-memory

Por padrão, os agentes usam no máximo 8 GiB de memória do sistema. Se isso não se encaixar no seu ambiente, será possível especificar um uso máximo de memória relevante nos seguintes formatos:

Valor de max-physical-mem	Configuração máxima de memória
6g	6 gigabytes
6gb	6 gigabytes
6GiB	6 gibibytes

--project-id=project-id

String obrigatória do ID do projeto que hospeda os recursos de transferência criados e faturados.

--version

Exibe a versão atual do agente.