Static Website in Docker with OpenTofu
Um único tofu apply serve o seu site estático pelo nginx no Docker, com parâmetros validados, uma verificação de integridade, sete testes e um tofu destroy limpo.
- OpenTofu
- Docker provider (kreuzwerker/docker)
- HTTP provider (hashicorp/http)
- nginx (alpine image)
- Docker Desktop
Capturas de tela
Pagamento único
- ₹ 299+ GST, ₹ 352,82 no total
- US$ 5
- Baixe na sua biblioteca assim que o pagamento for confirmado.
- Todas as versões futuras deste projeto estão incluídas, sem custo adicional.
- Versão mais recente
- 1.0.0 · 18 de nov. de 2026
- Licença
- Source Code Licence
Visão geral
O código-fonte completo de uma configuração do OpenTofu que serve uma pasta de arquivos estáticos pelo nginx no Docker, no seu próprio computador. Cada parâmetro é verificado antes de qualquer coisa ser criada, o apply só termina quando o nginx responde, uma verificação confirma que o site retorna 200 e sete testes rodam sem Docker. Testado no macOS com o Docker Desktop.
Colocar um site estático em um contêiner uma vez é fácil. Fazer isso de um jeito que um parâmetro errado seja pego antes de qualquer coisa iniciar, que o comando espere até o site responder de verdade e que um único comando remova tudo de novo exige mais cuidado. O Static Website in Docker with OpenTofu® é essa configuração, testada em execuções reais no macOS com o Docker Desktop.
O que ela faz
- Serve o seu site pelo nginx no Docker. Aponte para qualquer pasta com um
index.html, e todos os arquivos dela, incluindo as subpastas, são copiados para um contêiner do nginx. - Um comando sobe, outro remove. O
tofu applybaixa a imagem oficialnginx:1.31-alpinee inicia o contêiner. Otofu destroyremove o contêiner e a imagem. - Privado por padrão. O site escuta em
127.0.0.1:8080, então só o seu computador consegue abri-lo. Um único parâmetro o abre para a sua rede. - Atualiza quando os seus arquivos mudam. Altere um arquivo e rode o
tofu applyde novo: o contêiner é substituído por um que tem os arquivos novos.
Feita para que os erros apareçam cedo
- Cada parâmetro é verificado primeiro. O nome do contêiner, a pasta do site, a porta (de 1024 a 65535), o endereço e a imagem são validados antes de qualquer coisa ser criada, cada um com uma mensagem clara.
- O apply espera o site ficar saudável. Uma verificação de integridade dentro do contêiner pede a página inicial ao nginx, e o
tofu applysó termina quando ele responde. - Uma verificação após cada apply. Um bloco
checkfaz uma requisição ao site e avisa se ele não responder com 200. - Sete testes. O
tofu testcobre os valores padrão, a opção de rede e todas as validações de entrada. Os provedores são simulados, então os testes não precisam de Docker e não criam nada.
Código para você construir em cima
- Pequeno e legível. Seis arquivos
.tfcurtos, cada um com uma única função: as versões, o provedor, os parâmetros, os recursos, a verificação e as saídas. - Versões fixadas e resultados reproduzíveis. Restrições de versão para o OpenTofu e os dois provedores, e um arquivo de bloqueio com somas de verificação para macOS (Apple silicon e Intel), Linux (x86-64 e Arm) e Windows.
- Pronto para o Git. Um
.gitignoreque deixa de fora o estado e os planos, e um.gitattributespara finais de linha consistentes. - Todos os parâmetros em um arquivo de exemplo. Copie o
terraform.tfvars.examplee altere o que precisar.
O que não está incluído
- Sem hospedagem. Ela roda o site no seu próprio computador. Colocá-lo em um servidor ou na nuvem fica a seu critério.
- Sem HTTPS. O nginx serve apenas HTTP na porta que você escolher.
- Sem gerador de sites. Ela serve os arquivos que você fornecer. O exemplo é uma loja de uma página só.
Rode em quatro etapas
- Instale o OpenTofu 1.13 ou mais recente e inicie o Docker. No Mac, ative o socket padrão do Docker Desktop ou defina
docker_host. - Descompacte o download e abra um terminal na pasta dele.
- Rode
tofu init, depoistofu apply, e digiteyes. - Abra
http://127.0.0.1:8080/no seu navegador.
Cada etapa, com capturas de tela: How to Set Up and Run the Static Website in Docker with OpenTofu (abre em uma nova aba) (em inglês).
Aprenda as ideias por trás do código no tutorial gratuito OpenTofu Tutorial for Beginners (abre em uma nova aba) (em inglês).
OpenTofu® é uma marca registrada da LF Projects, LLC. Docker é uma marca comercial da Docker, Inc. Os demais nomes são marcas comerciais de seus respectivos proprietários.
Série de tutoriais gratuita
OpenTofu Tutorial for Beginners
Prefere aprender construindo? Este guia gratuito e passo a passo no nosso blog mostra como o projeto é feito.
O que você leva
Tudo o que está no arquivo, em um relance.
- A versão 1.0.0 do código-fonte completo: seis arquivos do OpenTofu, um site de exemplo e um arquivo de testes
- Parâmetros validados para o nome do contêiner, a pasta do site, a porta, o endereço e a imagem do nginx
- Um contêiner do nginx com verificação de integridade, e um apply que espera até o site responder
- Um bloco check que confirma que o site responde com 200 após cada apply
- Sete testes com provedores simulados que rodam sem Docker
- Um arquivo de bloqueio com as somas de verificação dos provedores para macOS, Linux e Windows
- Um arquivo de parâmetros de exemplo, um .gitignore e um arquivo .gitattributes
- Um README com os requisitos, todos os parâmetros, as saídas, a solução de problemas e a limpeza
Feito com
As versões e os ambientes exatos com que foi criado e testado.
- OpenTofu1.13.9
- Docker provider (kreuzwerker/docker)4.7.0
- HTTP provider (hashicorp/http)3.6.3
- nginx (alpine image)1.31
- Docker Desktop4.99.0
O que há no arquivo
A árvore de pastas que você recebe ao descompactar.
static-website-docker-opentofu/
- site/
- tests/
- .gitattributes
- .gitignore
- .terraform.lock.hcl
- README.md
- checks.tf
- main.tf
- outputs.tf
- providers.tf
- terraform.tfvars.example
- variables.tf
- versions.tf
O que ele precisa de você
As contas e os serviços que ele espera encontrar, para nada surpreender.
- OpenTofu 1.13 ou mais recente, abaixo da 2.0
- Docker: Docker Desktop no macOS ou no Windows, ou Docker Engine no Linux
- No Mac, o socket padrão do Docker Desktop ativado, ou o endereço do Docker definido em docker_host
- Uma porta livre no seu computador, 8080 por padrão
- Os arquivos do seu site, com um index.html na raiz (um site de exemplo está incluído)
Versões
Todas as versões até agora, da mais recente para a mais antiga.
1.0.0Mais recente
Primeira versão do código-fonte completo.
- Serve qualquer pasta de arquivos estáticos pelo nginx 1.31 no Docker, em 127.0.0.1:8080 por padrão.
- Verifica cada parâmetro antes de qualquer coisa ser criada e espera até o site responder.
- Inclui sete testes, um site de exemplo e um arquivo de bloqueio para macOS, Linux e Windows.
Source Code Licence
O que você pode fazer com ele
What you may and may not do with the source code you buy.
Ler a licença completa
- What this licence covers
This licence governs every file included in a product you buy from Dewiride Store: source code, configuration, database scripts, sample data, documentation and any other file in the download. It takes effect when your payment is confirmed and applies to every release of that product that reaches your library. Files that reach your library through an annual updates membership are governed in exactly the same way.
It forms part of the Terms of Sale and Use. Where a product page states different or additional licence terms for that product, those terms prevail for that product. The membership page may likewise state different or additional licence terms for the files a membership carries, and those terms then prevail for those files.
- The licence we grant you
We grant you a perpetual, worldwide, non-exclusive, non-transferable licence to use, reproduce, adapt, translate and modify the files, and to include the result in your own work, on the conditions set out below.
Perpetual means it does not expire. Worldwide means it is not limited to any country. Non-exclusive means we license the same product to other customers. Non-transferable means you cannot pass it on to someone else.
The licence is granted to you — either you personally, or the organisation you identified when buying. Everyone working within that organisation may use the files for that organisation’s projects. Nobody outside it may.
- What you may do
- Use and change the files in your own projects, commercial or otherwise, with no limit on the number of projects.
- Build a product or a service on them and charge your own customers for it.
- Deploy the result for a client, as part of work you are doing for that client.
- Distribute the result in compiled, deployed or otherwise non-source form.
- Keep as many back-up copies as you reasonably need.
- Study, observe and test how the code works, and obtain the information you need to make it work with your own software.
The last two are yours by law under sections 52(1)(aa) to (ac) of the Indian Copyright Act, 1957, and nothing in this licence is intended to take them away.
- What you may not do
- Resell, sublicense, redistribute or publish the files themselves, in whole or in substantial part, in source form.
- Include them in a template, starter kit, course, tutorial repository or component library that you sell or give away, where the code is the thing being supplied.
- Share your account, your download links or your invoices with anyone outside your organisation.
- Publish the files in a public repository, or in any other place where they can be obtained without buying them.
- Remove or obscure the copyright and attribution notices in the source files.
- Use the files to build something whose main purpose is to compete with Dewiride Store as a supplier of the same code.
The distinction that matters is simple: you may sell what you build with the code; you may not sell the code.
- Third-party components
Our products depend on open-source libraries, frameworks and services that we did not write. Those remain under their own licences, which we do not and cannot change. Where a product includes or requires such a component, its licence is named in the product’s documentation, and complying with it is your responsibility.
- Releases
Every release of a product you own is covered by this same licence and appears in your library at no extra cost. A release you have already downloaded remains licensed to you even if we later stop publishing the product. A release that reached your library through an annual updates membership is licensed to you on these same terms, and stays licensed after the period that carried it has ended.
- Ownership
We keep ownership of the files and of the copyright in them. You own whatever you create with them: your changes, your additions and the product you build are yours.
- If this licence ends
This licence ends if you materially breach it and do not put the breach right within thirty days of us asking you to in writing. It also ends if your payment is reversed or refunded, because the purchase it depends on no longer stands. Where a membership period is refunded or reversed, the licence ends for the releases that period carried and for nothing else: anything you bought separately, or that another period carried, is unaffected.
If it ends, you must stop using the files and delete the copies you hold. Work you had already delivered to a client before that point may continue in use, so that ending this licence never breaks something your own customer relies on.
- No warranty beyond the description
The warranties and limits in section 19 and section 20 of the Terms of Sale and Use apply to this licence as well.
- Governing law
This licence is governed by the law of India, and section 24 of the Terms of Sale and Use applies to any dispute about it. If a translation and the English version differ in meaning, the English version governs.
Static Website in Docker with OpenTofu
- ₹ 299+ GST, ₹ 352,82 no total
- US$ 5