visão geral das ações

A ferramenta de interface de linha de comando (CLI) dos gactions ajuda a criar a estrutura e os arquivos necessários do projeto e a implantá-los como um projeto do Actions no Console do Actions. Para informações sobre como usar a ferramenta de linha de comando em cenários comuns após a instalação e configuração, consulte o guia do usuário.

Depois de instalada, é possível ver um resumo da funcionalidade da ferramenta no seu terminal:

gactions --help

A seguinte saída é exibida:

Command Line Interface for Google Actions SDK

Usage:
  gactions [command]

Available Commands:
  decrypt             Decrypt client secret.
  deploy              Deploy an Action to the specified channel.
  encrypt             Encrypt client secret.
  help                Help about any command
  init                Initialize a directory for a new project.
  login               Authenticate gactions CLI to your Google account via web browser.
  logout              Log gactions CLI out of your Google Account.
  pull                This command pulls files from Actions Console into the local file system.
  push                This command pushes changes in the local files to Actions Console.
  third-party-notices Prints license files of third-party software used.
  version             Prints current version of the CLI.

Flags:
  -h, --help      help for gactions
  -v, --verbose   Display additional error information

Use "gactions [command] --help" for more information about a command.

Instalar a ferramenta de linha de comando gactions

Para instalar a ferramenta de interface de linha de comando (CLI) dos gactions, faça o download de um pacote de instalação, descompacte-o e configure o caminho de execução.

Para instalar e configurar as ações, siga estas etapas:

  1. Faça o download do pacote adequado para seu sistema operacional:

    Plataforma Pacote Soma de verificação
    Windows Fazer o download SHA256
    Linux Fazer o download SHA256
    Mac OS Fazer o download SHA256

  2. Extraia o pacote para um local de sua escolha e adicione o binário à variável PATH do ambiente. Como alternativa, extraia o pacote para um local que já esteja na variável PATH (por exemplo, /usr/local/bin).

  3. No Linux e no Mac, ative as permissões de execução, se necessário:

    chmod +x PATH_TO/gactions

  4. Execute o comando a seguir para autenticar a CLI. Esse comando inicia um fluxo de autenticação e requer um navegador da Web:

    gactions login

    Quando o fluxo é concluído, a CLI é autenticada automaticamente.

Criar e configurar um projeto

Antes de usar a ferramenta de linha de comando dos gactions, você precisa criar um projeto no Console do Actions e conceder acesso a ele. Para criar e configurar um projeto, faça o seguinte:

  1. Acesse o Console do Actions.
  2. Clique em Novo projeto, insira um nome e clique em Criar projeto.
  3. Selecione uma categoria e clique em Próxima.
  4. Selecione Projeto em branco e clique em Começar a criar.
  5. Ative a API Actions no console do Google Cloud seguindo as instruções em Ativar e desativar APIs. Isso permite que as gactions interajam com seu projeto.

Inicializar um exemplo

Crie um diretório vazio e execute gactions init SAMPLE_NAME nesse diretório para importar um projeto de exemplo do Actions. É possível usar o projeto de exemplo como modelo para criar seu próprio projeto e entender a estrutura de um projeto do Actions.

Por exemplo, o comando a seguir faz com que o conteúdo da amostra hello-world seja adicionado ao seu diretório:

gactions init hello-world