​
Deploy do site (Docker)

O estado e a configuração do sistema são totalmente definidos no sistema de arquivos. Assim, o estado do site é auto-contido no próprio sistema de arquivos, sem a necessidade de comunicação com sistemas externos por padrão. No entanto, o site pode acessar bancos de dados, serviços SaaS ou outros serviços web, conforme o código implementado pelo desenvolvedor, mas isso não é um requisito obrigatório do runtime da Deco. Para facilitar o processo de deploy, oferecemos uma estratégia simples utilizando um Dockerfile.

​
Dockerfile

Para realizar o deploy em Docker, copie o código abaixo para um arquivo Dockerfile na raiz do seu projeto. É necessário configurar, no mínimo, a variável de ambiente ENV DECO_SITE_NAME para refletir o nome do seu site ou projeto. 
FROM denoland/deno:alpine

# The port that your application listens to.
EXPOSE 8000

WORKDIR /app

RUN mkdir -p /home/deno && chown -R deno:deno /home/deno && mkdir /app/deno && chown -R deno:deno /app && mkdir -p /deno-dir && chown -R deno:deno /deno-dir

# Prefer not to run as root.
USER deno

# These steps will be re-run upon each file change in your working directory:
COPY --chown=deno:deno . deco

WORKDIR /app/deco

RUN echo -e 'import "$fresh/src/build/deps.ts";\nimport "$fresh/src/runtime/entrypoints/main.ts";\nimport "$fresh/src/runtime/entrypoints/deserializer.ts";\nimport "$fresh/src/runtime/entrypoints/signals.ts";' >> _docker_deps.ts

RUN deno cache --allow-import --frozen main.ts dev.ts _docker_deps.ts

ARG GIT_REVISION=1

ENV DECO_SITE_NAME=yoursitename

ENV DENO_DEPLOYMENT_ID=$GIT_REVISION

CMD ["run", "--cached-only", "-A", "--unstable-kv", "main.ts"]

​
Explicação do Dockerfile

Aqui estão alguns detalhes importantes sobre o Dockerfile acima, que podem precisar de personalização conforme o seu caso de uso:
  • FROM denoland/deno:alpine
    • Define a imagem base do Docker. Você pode especificar uma versão exata, como FROM denoland/deno:2.0.1.
  • EXPOSE 8000
    • Expõe a porta onde a aplicação estará disponível.
  • RUN echo -e ... >> _docker_deps.ts
    • Define as dependências que serão cacheadas para evitar a busca por pacotes externos durante a execução.
  • RUN deno cache --allow-import --frozen main.ts dev.ts _docker_deps.ts
    • Realiza o cache das dependências do projeto.
  • ARG GIT_REVISION=1
    • Permite definir um argumento de build para identificar revisões do projeto.
  • ENV DECO_SITE_NAME=yoursitename
    • Define uma variável de ambiente usada para identificar o site no runtime Deco.
  • ENV DENO_DEPLOYMENT_ID=$GIT_REVISION
    • Variável usada para gerenciar o cache dos assets do site, devendo ser alterada a cada novo build.
  • CMD ["run", "--cached-only", "-A", "--unstable-kv", "main.ts"]
    • Comando que executa o servidor com as permissões necessárias.

​
Deploy docker

Para criar a imagem Docker com base no seu projeto, execute o seguinte comando no diretório raiz:
  • docker build -t site_image .
Se necessário, você pode passar o argumento GIT_REVISION para identificar uma revisão específica do build:
  • docker build --build-arg GIT_REVISION=2 -t site_image .
Finalmente, crie e execute o container Docker:
  • docker run -p 8000:8000 --name site_container site_image
Com isso, seu site estará rodando em um container Docker, pronto para uso.