Azion CLI link
Comando da Azion CLI que configura uma pasta de projeto existente para a Azion com um preset, com cada flag, seu tipo e seu padrão.
O comando link da Azion CLI configura o projeto do diretório atual para que a CLI possa fazer o build, executar e fazer o deploy dele como uma Application. Ele grava o arquivo azion/azion.json e um arquivo azion.config para o preset que você escolhe, e pode adicionar entradas ao .gitignore e um workflow do GitHub Actions. O comando não cria nenhum recurso na Azion: todo ID em azion/azion.json fica 0 até o primeiro deploy. As opções que todo comando aceita, como --format, --out e -y, estão em Opções globais.
Uso
Execute azion link a partir da pasta raiz do projeto:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--auto | — | — | — | Executa o comando inteiro sem parar para nenhuma pergunta. Adiciona as entradas do .gitignore e o workflow do GitHub Actions, e não faz o build nem o deploy do projeto. |
--config-dir | — | string | "azion" | Caminho relativo da pasta que contém os seus arquivos azion.json e args.json. |
--local | — | — | — | Executa o build e o deploy na sua máquina quando você faz o deploy do projeto a partir deste comando. |
--name | — | string | — | Nome da aplicação. Sem ela, o comando sugere um nome aleatório e pede que você o aceite ou digite outro. |
--package-manager | — | string | — | Gerenciador de pacotes a usar, como npm, yarn ou pnpm. |
--preset | — | string | — | Preset com o qual o projeto faz o build, como html ou next. Os nomes são os que o Azion CLI presets lista. Sem ela, o comando abre um seletor com os mesmos nomes. |
--remote | — | string | — | URL de um repositório Git a clonar e vincular a uma aplicação. |
--skip-framework-build | — | — | — | Pula o build do framework que é executado antes do azion build. |
--sync | — | — | — | Sincroniza o arquivo azion.json local com os recursos remotos quando você faz o deploy do projeto a partir deste comando. |
Para um site HTML estático, use o preset html. Um projeto vinculado com html serve os arquivos da sua pasta www, então mova os seus arquivos para www antes de fazer o build ou o deploy. Os arquivos na raiz do projeto não são enviados.
Para executar o comando a partir de um script, passe --name, --preset e --auto. O comando então não faz nenhuma pergunta.
Exemplos
Cada exemplo mostra o comando e a saída que ele imprime.
Vincular um site estático sem perguntas
Este comando vincula um site HTML estático chamado my-site e não faz nenhuma pergunta:
O comando grava os arquivos do projeto e lembra você de fazer o build do projeto:
O comando adiciona .edge/, .vulcan e .open-next ao .gitignore, grava o azion.config.cjs e grava o azion/azion.json sem IDs de recursos:
O workflow em .github/workflows/azion-deploy.yml executa azion build e azion deploy --local quando você o inicia manualmente no GitHub. Ele lê um personal token do secret AZION_PERSONAL_TOKEN do repositório.
Vincular um projeto com perguntas
Este comando vincula o mesmo tipo de site e faz uma pergunta em cada etapa:
O comando pede que você confirme a pasta e depois abre o seletor de presets. Este exemplo responde sim ao .gitignore, não ao workflow, sim ao build e não às dependências, ao servidor de desenvolvimento local e ao deploy:
Sem --name, o comando pergunta o nome depois da pergunta sobre a pasta e sugere um nome aleatório: