A ferramenta de interface de linha de comando (CLI) 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 depois de instalar e configurar, consulte o guia do usuário.
Depois de instalado, você pode ver um resumo da funcionalidade da ferramenta no 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
Instale a ferramenta de linha de comando (CLI) gactions fazendo o download de um pacote de instalação, descompactando-o e configurando o caminho de execução.
Para instalar e configurar gactions, siga estas etapas:
Faça o download do pacote apropriado para seu sistema operacional:
Plataforma Pacote Soma de verificação Windows Fazer download SHA256 (link em inglês) Linux Fazer download SHA256 (link em inglês) Mac OS Fazer download SHA256 (link em inglês) 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ávelPATH
(por exemplo,/usr/local/bin
).No Linux e no Mac, ative as permissões de execução, se necessário:
chmod +x PATH_TO/gactions
Execute o comando a seguir para autenticar a CLI. Este 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 gactions, crie um projeto no console do Actions e conceda acesso gactions ao projeto. Para criar e configurar um projeto, faça o seguinte:
- Acesse o Console do Actions.
- Clique em Novo projeto, insira um nome e clique em Criar projeto.
- Selecione uma categoria e clique em Próxima.
- Selecione Projeto em branco e clique em Começar a criar.
- Ative a API Actions no Console do Google Cloud seguindo as instruções em Ativar e desativar APIs. Isso permite que os gactions interajam com seu projeto.
Inicializar uma amostra
Crie um diretório vazio e execute gactions init SAMPLE_NAME
nesse diretório para importar um projeto de amostra do Actions. É possível usar o projeto de amostra como modelo para criar seu próprio projeto e entender a estrutura de um projeto do Actions.
Por exemplo, o comando a seguir resulta na adição do conteúdo do exemplo hello-world
ao diretório:
gactions init hello-world