--- name: azion-desenvolva-com-hexo description: >- Faça o deploy de um site Hexo em um domínio da Azion a partir do template Hexo Boilerplate, de um repositório do GitHub ou da Azion CLI. --- # Desenvolva com Hexo Você pode colocar um site Hexo na Azion de três formas: fazer o deploy do template do Hexo pelo Azion Console, importar o seu próprio repositório do GitHub ou executar a [Azion CLI](/pt-br/documentacao/devtools/cli/). Cada rota deixa o site no ar em um domínio da Azion. A Azion serve um site Hexo como uma aplicação estática. O build do Hexo gera o site em `./public`, e o deploy copia essa pasta para um bucket de storage por trás de uma [aplicação](/pt-br/documentacao/plataforma/applications/). Para ver em quais outros frameworks a Azion faz o build, consulte [Compatibilidade com web frameworks](/pt-br/documentacao/devtools/runtime/frameworks/compatibilidade-frameworks/). --- Escolha uma rota primeiro. Os pré-requisitos e as etapas de deploy desta página mudam conforme a rota. ## Pré-requisitos - Uma conta da Azion. Para criar uma, consulte [Criar uma conta](/pt-br/documentacao/fundamentos/criar-uma-conta/). **Console** - Acesso ao Azion Console. Para entrar, consulte [Como acessar o Azion Console](/pt-br/documentacao/guias/plataforma/conta-e-billing/como-acessar-o-azion-console/). - Uma conta do GitHub. O formulário do template a conecta durante o deploy quando pede uma. **GitHub** - Acesso ao Azion Console. Para entrar, consulte [Como acessar o Azion Console](/pt-br/documentacao/guias/plataforma/conta-e-billing/como-acessar-o-azion-console/). - Uma conta do GitHub. - Um repositório do GitHub com um projeto Hexo. **CLI** - A Azion CLI instalada e com login feito. Para configurá-la, consulte [Primeiros passos com a Azion CLI](/pt-br/documentacao/devtools/cli/primeiros-passos/). - Node.js 18 ou superior, com npm. - Um terminal e um editor de código. --- ## Templates do Hexo A rota do Console faz o deploy de um template, um projeto Hexo pronto para o build. Ela parte deste template: | Template | Uso | | -------------------------------------------------------------------------------------------------------- | ------------------------- | | [Hexo Boilerplate](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/frameworks/hexo-boilerplate/) | Aplicação de página única | O Hexo Boilerplate tem um guia próprio, com link na tabela. Para o catálogo de templates, consulte [Azion Marketplace](/pt-br/documentacao/plataforma/marketplace/). Na rota da CLI, o seletor de templates do `azion init` para o preset do Hexo lista o Hexo Boilerplate como única opção. --- ## Fazer o deploy do site Toda rota faz o build do projeto Hexo e cria os recursos da Azion que o servem. Siga o painel da sua rota: **Console** Para fazer o deploy do template do Hexo pelo Azion Console: 1. **Abra os templates** Acesse [Azion Console](https://console.azion.com/) > **Create** > **Templates**. 2. **Encontre o template do Hexo** Em **Search by name, framework, or keyword**, digite `Hexo`. 3. **Selecione Hexo Boilerplate** 4. **Conecte sua conta do GitHub** Se o formulário mostrar **GitHub Connection**, selecione **Connect with GitHub** e instale o [Azion GitHub App](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/automacao/azion-github-app/). 5. **Selecione um Git Scope** Em **Git Scope**, selecione o escopo do template. 6. **Preencha as configurações que o template pede** 7. **Selecione Deploy** Enquanto o projeto passa pelo build, a página de deploy mostra o **Deploy Log**. Um deploy bem-sucedido mostra **Successfully created!**, a URL do domínio e um botão **Manage** que abre a aplicação. **GitHub** Para fazer o deploy de um projeto Hexo a partir do seu repositório do GitHub: 1. **Abra Import from GitHub** Acesse [Azion Console](https://console.azion.com/) > **Create** > **Import from GitHub**. 2. **Selecione o card de importação** Selecione o card na aba **Import from GitHub**. A página **Import from GitHub** abre. 3. **Conecte sua conta do GitHub** Se nenhuma conta do GitHub estiver conectada, em **GitHub Connection**, selecione **Connect with GitHub**. 4. **Selecione o repositório** Selecione um **Git Scope** e, em seguida, o **Repository** com o projeto Hexo. 5. **Dê um nome à aplicação** Em **General**, digite um **Application Name**. O nome do repositório preenche o campo primeiro, e o bucket de storage e a [function](/pt-br/documentacao/plataforma/functions/) recebem o mesmo nome. 6. **Selecione o preset do Hexo** Defina **Preset** como *Hexo*. 7. **Defina o diretório raiz** Em **Root Directory**, mantenha `/` se o projeto Hexo estiver na raiz do repositório. 8. **Digite o comando de instalação** Em **Install Command**, digite `npm install`. 9. **Selecione Deploy** A página de deploy abre. O título dela é `Deploy:` seguido do nome da aplicação, e ela mostra o **Deploy Log** enquanto o projeto passa pelo build. Um deploy bem-sucedido mostra **Successfully created!** e a URL do domínio. Para a seção **Variables** e os outros campos do formulário, consulte [Importe um projeto do GitHub](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/automacao/importar-um-projeto-existente-do-github/). **CLI** Para criar o projeto, execute `azion init` com um nome de projeto. No seletor de presets, selecione *Hexo*; no seletor de templates, selecione *Hexo Boilerplate*: ```bash azion init --name my-site --auto -y ``` Com `-y`, o comando instala as dependências. Com `--auto`, ele não pergunta se deve iniciar um servidor de desenvolvimento local nem se deve fazer o deploy. Para as perguntas que ele faz sem essas opções, consulte [Azion CLI init](/pt-br/documentacao/devtools/cli/init/). O comando exibe: ```text > AI Studio Angular Astro Docusaurus Eleventy Emscripten Gatsby Hexo Hono Hugo Javascript Jekyll Next Nuxt OpenNextJS Preact Qwik React Rustwasm Stencil Svelte Typescript Vitepress Vue Vuepress ? Choose a preset: Hexo ? Choose a template: [Use arrows to move, type to filter] > Hexo Boilerplate ? Choose a template: Hexo Boilerplate Fetching selected template... Template successfully fetched Template successfully configured Installing application dependencies … added 241 packages, and audited 242 packages in 13s 42 packages are looking for funding run `npm fund` for details 7 high severity vulnerabilities To address all issues (including breaking changes), run: npm audit fix --force Run `npm audit` for details. … [Azion] [Build] › ℹ info Using preset: hexo [Azion] [Build] › ✔ success Build completed successfully with only azion.config [Azion] [IaC] › ✔ success Manifest generated successfully at /my-site/.edge/manifest.json If you want to start a local development server later, run 'azion dev' Make sure to change to the new working directory before running building or deploying your project If you want to deploy your application later, run 'azion deploy' Make sure to change to the new working directory before running building or deploying your project Your application my-site was initialized successfully ``` O projeto fica na pasta `my-site`. O `azion.config.cjs` dele define o preset `hexo` e envia `./public` para um bucket de storage com acesso somente de leitura para os workloads. Para as configurações desse arquivo, consulte [azion.config.js](/pt-br/documentacao/devtools/cli/azion-config-js/). Para fazer o build do site, vá para a pasta do projeto e execute `azion build`: ```bash cd my-site azion build ``` O Azion Bundler faz o build do projeto com o preset `hexo`, e o Hexo grava os arquivos gerados em `public`. O script `build` do template é `hexo generate`: ```text Building your Application. This process may take a few minutes Running build step command: $ npx --yes @aziontech/bundler@1.1.4 build --preset hexo … [Azion] [Build] › ℹ info Using preset: hexo [Azion] [Pre-Build] › ℹ info Starting pre-build... … [Hexo] › ℹ info INFO [Hexo] › ℹ info Validating config [Hexo] › ℹ info INFO [Hexo] › ℹ info Start processing [Hexo] › ℹ info INFO Files loaded in 154 ms [Hexo] › ℹ info INFO Generated: archives/index.html INFO Generated: archives/2026/index.html INFO Generated: archives/2026/10/index.html [Hexo] › ℹ info INFO Generated: index.html [Hexo] › ℹ info INFO Generated: js/jquery-3.6.4.min.js [Hexo] › ℹ info INFO Generated: fancybox/jquery.fancybox.min.css INFO Generated: css/images/azion.svg INFO Generated: fancybox/jquery.fancybox.min.js INFO Generated: js/script.js INFO Generated: css/style.css INFO Generated: css/images/discord.svg INFO Generated: css/images/medium.svg [Hexo] › ℹ info INFO Generated: css/images/x-twitter.svg INFO Generated: css/images/vector-bg.svg INFO Generated: 2026/10/03/Hexo-Boilerplate/index.html INFO Generated: css/images/banner.jpg [Hexo] › ℹ info INFO [Hexo] › ℹ info Generated: 2026/10/03/hello-world/index.html INFO 17 files generated in 111 ms [Azion] [Pre-Build] › ℹ info Pre-build completed successfully [Azion] [Build] › ℹ info Using built-in handler from "hexo" preset. [Azion] [Build] › ℹ info Starting build... [Azion] [Build] › ✔ success Build completed successfully [Azion] [Post-Build] › ℹ info Starting post-build... [Azion] [Post-Build] › ✔ success Post-build completed successfully [Azion] [Storage] › ℹ info Using provided prefix for storage '$BUCKET_NAME': $BUCKET_PREFIX [Azion] [IaC] › ✔ success Manifest generated successfully at /my-site/.edge/manifest.json Your Application was built successfully ``` Para fazer o deploy do site, execute `azion deploy` na pasta do projeto: ```bash azion deploy ``` O deploy envia o projeto e abre a página do Azion Console que o acompanha. Se o navegador não abrir, use a URL dessa página que aparece na saída. Ao final, o comando exibe a URL do domínio do site. Para a saída completa e as flags de deploy, consulte [Azion CLI deploy](/pt-br/documentacao/devtools/cli/deploy/). Para visualizar o site localmente antes de um deploy, consulte [Azion CLI dev](/pt-br/documentacao/devtools/cli/dev-comando/). Para um projeto Hexo que você já tem, execute `azion link` na pasta dele e selecione o preset do Hexo, como descrito em [Azion CLI link](/pt-br/documentacao/devtools/cli/link-comando/). --- ## Verificar o site Cada rota fornece a URL do domínio da Azion do site, no formato `https://xxxxxxxxxx.map.azionedge.net`. No Azion Console, a página de deploy mostra a URL; na rota da CLI, `azion deploy` a exibe ao final. Abra essa URL em um navegador para carregar o site Hexo. O primeiro deploy pode levar vários minutos para responder em todas as localidades; os deploys seguintes levam cerca de dois minutos. Uma localidade que ainda não tem o site responde com uma página `404` que diz `There's nothing here yet`. Se você receber essa página, aguarde e carregue a URL novamente. --- ## Próximos passos - [Compatibilidade com frameworks](/pt-br/documentacao/devtools/runtime/frameworks/compatibilidade-frameworks.md): Veja os frameworks e os presets em que a Azion faz o build. - [Azion CLI deploy](/pt-br/documentacao/devtools/cli/deploy.md): Leia a saída do deploy e as flags que mudam um deploy. - [Importe um projeto do GitHub](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/automacao/importar-um-projeto-existente-do-github.md): Defina cada campo da importação do GitHub, incluindo as variáveis. - [azion.config.js](/pt-br/documentacao/devtools/cli/azion-config-js.md): Altere o bucket, o cache e as regras que o preset do Hexo gera.