Skip to content

Commit

Permalink
Add deployment/docker.md to pt/mkdocs.yml
Browse files Browse the repository at this point in the history
  • Loading branch information
ayr-ton committed Nov 22, 2022
1 parent c1d3889 commit eff095f
Show file tree
Hide file tree
Showing 2 changed files with 10 additions and 11 deletions.
20 changes: 9 additions & 11 deletions docs/pt/docs/deployment/docker.md
Expand Up @@ -30,29 +30,29 @@ CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]

</details>

## O que é um contêiner
## O que é um Contêiner

contêineres (especificamente contêineres Linux) são um jeito muito **leve** de empacotar aplicações contendo todas as dependências e arquivos necessários enquanto os mantém isolados de outros contêineres (outras aplicações ou componentes) no mesmo sistema.
Contêineres (especificamente contêineres Linux) são um jeito muito **leve** de empacotar aplicações contendo todas as dependências e arquivos necessários enquanto os mantém isolados de outros contêineres (outras aplicações ou componentes) no mesmo sistema.

contêineres Linux rodam usando o mesmo kernel Linux do hospedeiro (máquina, máquina virtual, servidor na nuvem, etc). Isso simplesmente significa que eles são muito leves (comparados com máquinas virtuais emulando um sistema operacional completo).
Contêineres Linux rodam usando o mesmo kernel Linux do hospedeiro (máquina, máquina virtual, servidor na nuvem, etc). Isso simplesmente significa que eles são muito leves (comparados com máquinas virtuais emulando um sistema operacional completo).

Dessa forma, contêineres consomem **poucos recursos**, uma quantidade comparável com rodar os processos diretamente (uma máquina virtual consumiria muito mais).

contêineres também possuem seus próprios processos (comumente um único processo), sistema de arquivos e rede **isolados** simplificando deploy, segurança, desenvolvimento, etc.
Contêineres também possuem seus próprios processos (comumente um único processo), sistema de arquivos e rede **isolados** simplificando deploy, segurança, desenvolvimento, etc.

## O que é uma Imagem de contêiner
## O que é uma Imagem de Contêiner

Um **contêiner** é o que roda a partir de uma **imagem de contêiner**.

Uma imagem de contêiner é uma versão **estática** de todos os arquivos, variáveis de ambiente e do comando/programa padrão que deve estar presente num contêiner. **Estática** aqui significa que a **imagem** de contêiner não está rodando, não está sendo executada, somente contém os arquivos e metadados empacotados.

Em contraste com a "**imagem de contêiner**" que contém os conteúdos estáticos armazenados, um "**contêiner**" normalmente se refere à instância rodando, a coisa que está sendo **executada**.

Quando o **contêiner** é iniciado e está rodando (iniciado a partir de uma **imagem de contêiner**), ele pode criar ou modificar arquivos, variáveis de ambiente, etc. Essas mudanças vão existir somente nesse contêiner, mas não estarão subjacentes na imagem do contêiner (não serão salvas no disco).
Quando o **contêiner** é iniciado e está rodando (iniciado a partir de uma **imagem de contêiner**), ele pode criar ou modificar arquivos, variáveis de ambiente, etc. Essas mudanças vão existir somente nesse contêiner, mas não persistirão na imagem subjacente do container (não serão salvas no disco).

Uma imagem de contêiner é comparável ao arquivo de **programa** e seus conteúdos, ex.: `python` e algum arquivo `main.py`.

E o **contêiner** próprio (em contraste à **imagem de contêiner**) é a própria instância da imagem rodando, comparável a um **processo**. Na verdade, um contêiner está rodando somente quando há um **processo rodando** (e normalmente é somente um processo). O contêiner finaliza quando não há um processo rodando nele.
E o **contêiner** em si (em contraste à **imagem de contêiner**) é a própria instância da imagem rodando, comparável a um **processo**. Na verdade, um contêiner está rodando somente quando há um **processo rodando** (e normalmente é somente um processo). O contêiner finaliza quando não há um processo rodando nele.

## Imagens de contêiner

Expand All @@ -62,7 +62,7 @@ E existe um <a href="https://hub.docker.com/" class="external-link" target="_bla

Por exemplo, há uma <a href="https://hub.docker.com/_/python" class="external-link" target="_blank">Imagem Python</a> oficial.

E existe muitas outras imagens para diferentes bancos de dados, por exemplo:
E existe muitas outras imagens para diferentes coisas, como bancos de dados, por exemplo:

* <a href="https://hub.docker.com/_/postgres" class="external-link" target="_blank">PostgreSQL</a>
* <a href="https://hub.docker.com/_/mysql" class="external-link" target="_blank">MySQL</a>
Expand Down Expand Up @@ -119,7 +119,6 @@ pydantic>=1.8.0,<2.0.0
uvicorn>=0.15.0,<0.16.0
```

And you would normally install those package dependencies with `pip`, for example:
E você normalmente instalaria essas dependências de pacote com `pip`, por exemplo:

<div class="termy">
Expand All @@ -135,7 +134,7 @@ Successfully installed fastapi pydantic uvicorn
!!! info
Há outros formatos e ferramentas para definir e instalar dependências de pacote.

Eu vou mostrar um exemplo usando Poetry mais abaixo em uma seção abaixo. 👇
Eu vou mostrar um exemplo depois usando Poetry em uma seção abaixo. 👇

### Criando o Código do **FastAPI**

Expand Down Expand Up @@ -284,7 +283,6 @@ COPY ./app /code/app
Agora que todos os arquivos estão no lugar, vamos construir a imagem do contêiner.

* Vá para o diretório do projeto (onde está o seu `Dockerfile`, contendo o diretório `app`).
* Build your FastAPI image:
* Construa sua imagem FastAPI:

<div class="termy">
Expand Down
1 change: 1 addition & 0 deletions docs/pt/mkdocs.yml
Expand Up @@ -87,6 +87,7 @@ nav:
- deployment/versions.md
- deployment/https.md
- deployment/deta.md
- deployment/docker.md
- alternatives.md
- history-design-future.md
- external-links.md
Expand Down

0 comments on commit eff095f

Please sign in to comment.