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 ser acessado 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 desvinculado (em inglês)

--rm

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

Para mais informações, consulte Limpeza (--rm) (em inglês)

-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)

--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.

--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.

--log-dir=logs-directory

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

--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.