Construa seu site Astro com Docker
Docker é uma ferramenta para construir, implantar e executar aplicações usando contêiners.
Imagens e contêiners Docker podem ser implantados em diversas plataformas, como AWS, Azure e Google Cloud. Esta receita não explica como implantar seu site em uma plataforma específica, mas mostra como configurar o Docker para seu projeto.
Pré-requisitos
Seção intitulada Pré-requisitos- Docker instalado na sua máquina local. Você pode encontrar instruções de instalação para o seu sistema operacional aqui.
- Um Dockerfile no seu projeto. Você pode aprender mais sobre Dockerfiles aqui e usar os exemplos de Dockerfiles na seção a seguir como ponto de partida.
Criando um Dockerfile
Seção intitulada Criando um DockerfileCrie um arquivo chamado Dockerfile
no diretório raiz do seu projeto. Esse arquivo contém as instruções para construir seu site, que podem variar conforme suas necessidades. Este guia não pode explicar todas as opções possíveis, mas fornecerá pontos de partida para modos SSR e estático.
Se você estiver usando outro gerenciador de pacotes além do npm, ajuste os comandos conforme necessário.
Este Dockerfile irá construir seu site e servi-lo usando Node.js na porta 4321
, e, portanto, exige o adaptador Node (EN) instalado em seu projeto Astro.
FROM node:lts AS runtimeWORKDIR /app
COPY . .
RUN npm installRUN npm run build
ENV HOST=0.0.0.0ENV PORT=4321EXPOSE 4321CMD node ./dist/server/entry.mjs
Esses são apenas exemplos de Dockerfiles. Você pode personalizá-los conforme suas necessidades. Por exemplo, você pode usar outra imagem, como node:lts-alpine
:
FROM node:lts as runtimeFROM node:lts-alpine as runtime
Adicionando um .dockerignore
Seção intitulada Adicionando um .dockerignoreAdicionar um arquivo .dockerignore
ao seu projeto é uma boa prática. Este arquivo descreve quais arquivos ou pastas devem ser ignorados nos comandos COPY
ou ADD
do Docker, de forma semelhante ao .gitignore
. Isso acelera o processo de build e reduz o tamanho da imagem final.
.DS_Storenode_modulesdist
Este arquivo deve estar no mesmo diretório que o próprio Dockerfile
. Leia a documentação .dockerignore
para mais informações.
Estático
Seção intitulada EstáticoApache (httpd)
Seção intitulada Apache (httpd)O seguinte Dockerfile irá construir seu site e servir usando Apache httpd na porta 80
com a configuração padrão.
FROM node:lts AS buildWORKDIR /appCOPY . .RUN npm iRUN npm run build
FROM httpd:2.4 AS runtimeCOPY --from=build /app/dist /usr/local/apache2/htdocs/EXPOSE 80
Use esta abordagem para sites simples que não precisam de nenhuma configuração especial. Para sites mais complexos, é recomendado usar uma configuração personalizada, seja no Apache ou no NGINX.
FROM node:lts AS buildWORKDIR /appCOPY package*.json ./RUN npm installCOPY . .RUN npm run build
FROM nginx:alpine AS runtimeCOPY ./nginx/nginx.conf /etc/nginx/nginx.confCOPY --from=build /app/dist /usr/share/nginx/htmlEXPOSE 8080
Para construir o Dockerfile acima, você também precisará criar um arquivo de configuração para o NGINX. Crie uma pasta chamada nginx
no diretório raiz do seu projeto e um arquivo chamado nginx.conf
dentro dela.
worker_processes 1;
events { worker_connections 1024;}
http { server { listen 8080; server_name _;
root /usr/share/nginx/html; index index.html index.htm; include /etc/nginx/mime.types;
gzip on; gzip_min_length 1000; gzip_proxied expired no-cache no-store private auth; gzip_types text/plain text/css application/json application/javascript application/x-javascript text/xml application/xml application/xml+rss text/javascript;
error_page 404 /404.html; location = /404.html { root /usr/share/nginx/html; internal; }
location / { try_files $uri $uri/index.html =404; } }}
Build Multiestágios (usando SSR)
Seção intitulada Build Multiestágios (usando SSR)Aqui está um exemplo de um Dockerfile mais avançado que, graças a build multiestágios do Docker, otimiza o processo de build do seu site ao não reinstalar as dependências npm quando apenas o código-fonte muda. Isso pode reduzir o tempo de build em minutos, dependendo do tamanho das suas dependências.
FROM node:lts AS baseWORKDIR /app
# Ao copiar apenas o package.json e o package-lock.json, garantimos que os seguintes passos `-deps` sejam independentes do código-fonte.# Portanto, os passos `-deps` serão ignorados se apenas o código-fonte mudar.COPY package.json package-lock.json ./
FROM base AS prod-depsRUN npm install --omit=dev
FROM base AS build-depsRUN npm install
FROM build-deps AS buildCOPY . .RUN npm run build
FROM base AS runtimeCOPY --from=prod-deps /app/node_modules ./node_modulesCOPY --from=build /app/dist ./dist
ENV HOST=0.0.0.0ENV PORT=4321EXPOSE 4321CMD node ./dist/server/entry.mjs
Receita
Seção intitulada Receita-
Construa seu contêiner executando o seguinte comando no diretório raiz do seu projeto. Use qualquer nome em
<your-astro-image-name>
:Janela do terminal docker build -t <your-astro-image-name> .Isso gerará uma imagem que você pode rodar localmente ou implantar em uma plataforma de sua escolha.
-
Para rodar sua imagem como um contêiner local, use o seguinte comando.
Substitua
<local-port>
por uma porta aberta em sua máquina. Substitua<container-port>
com a porta exposta pelo seu contêiner Docker (4321
,80
ou8080
nos exemplos acima).Janela do terminal docker run -p <local-port>:<container-port> <your-astro-image-name>Agora você pode acessar seu site em
http://localhost:<local-port>
. -
Agora com seu site construído e empacotado com sucesso em um contêiner, você pode implantá-lo em um provedor de nuvem. Consulte o guia de implantação Google Cloud para um exemplo, e a página Deploy your app na documentação Docker.