Referência CTPU

Vista geral

Importante: a ferramenta ctpu foi descontinuada e a funcionalidade da ferramenta foi substituída pelos comandos gcloud compute tpus correspondentes.

A ferramenta de código aberto ctpu é usada para criar um grupo de recursos de computação, que consiste numa VM do Compute Engine e um ou mais dispositivos Cloud TPU. A ferramenta está pré-instalada no Cloud Shell.

Pode encontrar documentação e código para ctpu no GitHub.

A ferramenta ctpu usa a seguinte sintaxe:

ctpu <subcommand> <flags> <subcommand> <subcommand args> 

Seguem-se os subcomandos para ctpu:

auth

Descrição

Defina ou apresente autorizações para os TPUs na nuvem.

Utilização

ctpu auth <flags> <subcommand> <subcommand args>

Exemplo

ctpu auth list --project="my-project" --zone=us-central1-a
ctpu auth list --project my-project --zone us-central1-a

Subcomandos

O comando ctpu auth suporta os seguintes subcomandos:

• add-bigtable: certifique-se de que o Cloud TPU está autorizado para o Cloud Bigtable
• add-gcs: garante que o Cloud TPU está autorizado para o Cloud Storage
• list: Apresenta as autorizações da conta de serviço do Cloud TPU
• commands: apresenta todos os nomes de comandos
• flags: descreve todas as flags de nível superior conhecidas
• help: descreve os subcomandos e a respetiva sintaxe

Sinalizações opcionais

Seguem-se os comandos opcionais para ctpu auth. name | project | zone

eliminar (rm)

Descrição

Elimine a VM do Compute Engine e o Cloud TPU.

Utilização

ctpu rm <flags>

Exemplo

ctpu rm --zone=us-central1-b

ajuda

Descrição

Liste todos os subcomandos ctpu e flags de nível superior.

Utilização

ctpu help
ctpu help <subcommand>

Exemplo

ctpu help   // list all ctpu subcommands and top level flags

ctpu help auth   // list all flags that can be used with `ctpu auth`
ctpu help up   // list all flags that can be used with `ctpu up`

list (ls)

Descrição

Indique todas as VMs do Compute Engine e o Cloud TPU na zona especificada.

Utilização

ctpu ls <flags>

Exemplo

ctpu ls --zone=us-central1-b

Pausar (zz)

Descrição

Pare a VM do Compute Engine e elimine o Cloud TPU. Pare de cobrar a utilização do Cloud TPU até executar ctpu up.

Para garantir que o Cloud TPU é parado, tem de especificar o nome do Cloud TPU e a zona na linha de comandos.

Importante: continua a ser-lhe cobrado o espaço em disco consumido pela sua VM enquanto estiver em pausa.

Utilização

ctpu pause <name, zone>

Exemplo

ctpu pause --name=my-tpu --zone=us-central1-a  // pause the named TPU
in the specified zone

print-config (cfg)

Descrição

Imprimir no ecrã a configuração atual do nome do Cloud TPU, nome do projeto e zona.

Exemplo

ctpu print-config

quota

Descrição

Apresentar um URL onde pode ver as quotas.

Utilização

ctpu quota

Exemplo

ctpu quota
Output: Quotas cannot currently be displayed within ctpu.
To view your quota, open <url>
Request additional quota from <url>

reiniciar

Descrição

Reinicia uma TPU do Google Cloud que ainda se encontra no estado RUNNING (em execução) (apresentado em ctpu status), mas que parou de ser executada devido a um problema de hardware. Use gcloud compute tpu start ou o botão INICIAR na página Compute Engine > TPUs na Cloud Console se o TPU estiver no estado PARADO.

restart não reinicia uma Cloud TPU antecipada. Tem de executar ctpu delete e ctpu up se o seu Cloud TPU tiver sido anulado.

Utilização

ctpu restart <flags>

Exemplo

ctpu restart --zone=us-central1-a

status (st)

Descrição

Consultar as APIs GCP (apenas zona predefinida) para determinar o estado atual da sua VM do Cloud TPU e Compute Engine.

Importante: se os seus recursos estiverem a ser executados numa região ou zona não predefinida, _tem_ de especificar a flag `--zone`.

Utilização

ctpu st

Exemplo

ctpu st --zone=us-central1-a
Status message:
  Your cluster is running!
    Compute Engine VM:  RUNNING
    Cloud TPU:     RUNNING 

tpu-locations

Descrição

Liste todas as zonas onde os tipos de TPU estão disponíveis.

Utilização

ctpu tpu-locations

Resultado

Cloud TPU Locations:
    asia-east1-c
    europe-west4-a
    us-central1-a
    us-central1-b
    us-central1-c

tpu-sizes

Descrição

Liste todos os tamanhos de TPU disponíveis na zona especificada. Alguns tamanhos estão disponíveis apenas em determinadas zonas. (predefinição = zona predefinida)

Utilização

tpu-sizes <zone>

Exemplo

ctpu tpu-sizes --zone=us-central1-a

cima

Descrição

Apresentar um conjunto de recursos ctpu. A primeira vez que executa o comando ctpu up num projeto, demora mais tempo do que nas execuções futuras, porque está a realizar tarefas como a propagação da chave SSH e a ativação da API.

• Ativa os serviços Compute Engine e Cloud TPU.
• Cria uma VM do Compute Engine com a versão estável mais recente do TensorFlow pré-instalada.
• Atribui uma zona predefinida, como us-central1-b, com base na sua localização.
• Transmite o nome do Cloud TPU à VM do Compute Engine como uma variável de ambiente (TPU_NAME).
• Garante que o Cloud TPU tem acesso aos recursos de que precisa do seu Google Cloud projeto, concedendo funções específicas do IAM à sua conta de serviço do Cloud TPU.
• Realiza uma série de outras verificações.
• Inicia sessão na sua nova VM do Compute Engine. O comando da shell muda de username@project para username@tpuname.

Pode executar o ctpu up com a frequência que quiser. Por exemplo, se perder a ligação SSH à VM do Compute Engine, execute ctpu up para restaurar a ligação. Tem de especificar uma zona se o Compute Engine não estiver na zona predefinida. Por exemplo:

$ ctpu up --zone=us-central1-a

Utilização

ctpu up <flags>

Exemplo

ctpu up --tpu-size=v2-8 --disk-size-gb=320 --preemptible

Bandeiras

--disk-size-gb
Configure o tamanho do volume raiz da sua VM do Compute Engine. O valor tem de ser um número inteiro. (predefinição = 250)

--dry-run
Não fazer alterações; imprimir apenas o que teria acontecido.

--forward-agent
Ative o encaminhamento do agente SSH quando estabelecer uma ligação SSH à VM do Compute Engine. O encaminhamento do agente SSH permite o acesso a repositórios partilhados (como o GitHub) sem ter de colocar chaves privadas na VM do Compute Engine. (predefinição = verdadeiro)

--forward-ports
Encaminhe automaticamente portas úteis da VM do Compute Engine para a sua máquina local. As portas encaminhadas são: 6006 (tensorboard), 8888 (blocos de notas do Jupyter), 8470 (porta da TPU) e 8466 (porta do criador de perfis da TPU). (predefinição = verdadeiro)

--gce-image
Substitua a imagem do Compute Engine escolhida automaticamente. Use esta flag quando estiver a usar as suas próprias imagens personalizadas em vez das fornecidas com o TensorFlow instalado.

--gcp-network
Especifique a rede na qual a TPU na nuvem e a VM associada devem ser criadas. Consulte o artigo Vista geral da rede da nuvem privada virtual (VPC) para obter informações sobre redes. (predefinição = rede predefinida)

--log-http
Imprima o conteúdo completo dos pares de pedido-resposta HTTP. Para ativar a impressão, defina esta flag como true. Use esta flag quando precisar de resultados de registos para apresentar um relatório de erro contra ctpu. Consulte o ctpu README para ver detalhes.

--machine-type
Configure o tamanho da sua VM do Compute Engine. Está disponível uma lista completa dos tipos de máquinas na página Tipos de máquinas do Google Cloud. (predefinição = n1-standard-2)

--name
Substitua o nome a usar para VMs e Cloud TPU. (predefinição = o seu nome de utilizador)

--noconf
Ignorar confirmação.

--preemptible
Crie um nó da TPU do Google Cloud preemptível. Uma Cloud TPU preemptível custa menos por hora do que uma não preemptível. O serviço Cloud TPU pode sair de um dispositivo preemptível em qualquer altura. (predefinição = não preemptível)

--preemptible-vm
Crie uma VM do Compute Engine preemptível. Uma VM preemptiva custa menos por hora do que uma VM não preemptiva. O serviço do Compute Engine pode sair da instância de VM em qualquer altura. (predefinição = não preemptível)

--print-welcome
Imprima sempre a mensagem de boas-vindas.

--project
Substitua o nome do projeto da GCP a usar quando atribuir VMs e TPUs. Especifique um valor da configuração na nuvem ou dos metadados do Compute Engine, normalmente o nome do seu projeto. Se não for possível encontrar um bom valor, tem de fornecer um valor na linha de comandos.

--tf-version
Defina a versão do TensorFlow a usar quando criar a VM do Compute Engine e o Cloud TPU. (predefinição = lançamento estável mais recente)

--tpu-only
Apenas alocar uma Cloud TPU; use esta opção apenas se já tiver uma VM disponível.

--tpu-size
Configure o tamanho e a versão de hardware de um Cloud TPU.

--use-dl-images
Use imagens de VMs de aprendizagem avançada (consulte os documentos: https://cloud.google.com/deep-learning-vm/) em vez de imagens de máquinas de TPUs. (predefinição = imagens de máquinas de TPU)

--vm-only
Atribua apenas uma VM; use esta opção quando não tiver tudo pronto para configurar e pagar uma TPU.

--zone
Substitua a zona do Compute Engine a usar ao atribuir VMs e Cloud TPU. Na linha de comandos, execute ctpu help up para ver a lista.

versão

Descrição

Imprime a versão do ctpu instalado.

Utilização

ctpu version

Resultado

ctpu version
Output: ctpu version: 1.9