Faça deploy do seu site Astro
Pronto para fazer a build e deploy do seu site Astro? Siga um dos nossos guias para diferentes serviços de deploy ou role para abaixo para um guia geral sobre como fazer deploy de um site Astro.
Guias de Deploy
Seção intitulada Guias de DeployOpções de Deploy Rápido
Seção intitulada Opções de Deploy RápidoVocê pode fazer build e deploy de um site Astro para diversos hosts rapidamente utilizando ou a UI do painel dessa plataforma ou por uma interface de linha de comando.
UI do Website
Seção intitulada UI do WebsiteUma forma rápida de fazer deploy do seu website é conectando o repositório Git online (e.x. GitHub, GitLab, Bitbucket) de seu projeto Astro a uma provedor de hospedagem e se aproveitando de continuous deployment utilizando o Git.
Estas plataformas de host automaticamente detectam pushes no repositório fonte do seu projeto Astro, fazem a build do seu site e então fazem o deploy dele para a web em uma URL customizada ou em seu domínio pessoal. Geralmente, para configurar o deployment nessas plataformas você vai acabar seguindo passos como os seguintes:
-
Adicione seu repositório para um provedor Git online (por exemplo, GitHub, GitLab, Bitbucket)
-
Escolha uma host que suporta continuous deployment (por exemplo, Netlify ou Vercel) e importe seu repositório Git como um novo site/projeto.
Vários hosts comuns vão reconhecer seu projeto como um site Astro e devem escolher as opções de configuração apropriadas para fazer a build e deploy do seu site como indicado abaixo. (Caso contrário, essas configurações podem ser mudadas.)
- Build Command (Comando de Build):
astro build
ounpm run build
- Publish directory (Diretório de Publicação):
dist
- Build Command (Comando de Build):
-
Clique em “Deploy” e seu novo website será criado em uma URL única daquele host (e.x.
novo-site-astro.netlify.app
).
O host será automaticamente configurado para verificar a branch main
do seu provedor Git por mudanças para então refazer a build e publicação do seu site a cada novo commit. Essas configurações tipicamente podem ser configuradas na UI do painel do seu host.
Deploy por Interface de Linha de Comando
Seção intitulada Deploy por Interface de Linha de ComandoAlguns hosts vão ter suas próprias interfaces de linha de comando (CLI) que você pode instalar globalmente em sua máquina utilizando npm. Geralmente, utilizar uma CLI para fazer deploy se parece com isso:
-
Instale a CLI do seu host globalmente, por exemplo:
-
Execute a CLI e siga as instruções para autorização, configuração, etc.
-
Faça build e então deploy do seu site para seu host
Vários hosts comuns irão fazer build e deploy do seu site por você. Eles irão geralmente reconhecer o seu projeto como um site Astro, e então escolher as opções de configuração apropriadas para fazer a build e deploy como indicado abaixo. (Caso contrário, essas configurações podem ser mudadas.)
- Build Command (Comando de Build):
astro build
ounpm run build
- Publish directory (Diretório de Publicação):
dist
Outros hosts vão precisar que você faça build do seu site localmente e então faça o deploy utilizando a linha de comando.
- Build Command (Comando de Build):
Fazendo Build do Seu Site Localmente
Seção intitulada Fazendo Build do Seu Site LocalmenteVários hosts como Netlify e Vercel irão fazer a build do seu site por você e então publicar o resultado da build para a web. Porém, alguns sites vão precisar que você faça a build localmente e então execute o comando de deploy ou faça upload do resultado da build.
Você também pode desejar fazer a build localmente para visualizar seu site, ou para encontrar possíveis erros e avisos no seu próprio ambiente.
Execute o comando npm run build
para fazer build do seu site Astro.
Por padrão, o resultado da build será colocado em dist/
. Este local pode ser modificado utilizando a opção outDir
da configuração.
Adicionando um Adaptador para SSR
Seção intitulada Adicionando um Adaptador para SSRAntes de fazer deploy do seu site Astro com SSR (renderização no lado do servidor) (EN) ativado, certifique-se de que você:
- Instalou o adaptador correto (EN) nas dependências do seu projeto (seja manualmente ou utilizando o comando
astro add
do adaptador, e.x.npx astro add netlify
). - Adicionou o adaptador na importação e exportação padrão do seu arquivo
astro.config.mjs
ao instalar manualmente. (O comandoastro add
irá tomar conta dessa etapa por você!)