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