Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Utiliza Markdown em pequenos trechos de código #81

Open
wants to merge 6 commits into
base: main
Choose a base branch
from
Open

Utiliza Markdown em pequenos trechos de código #81

wants to merge 6 commits into from

Conversation

adarlan
Copy link

@adarlan adarlan commented Jul 18, 2018

Observei que o livro foi escrito em Markdown, mas diversos pequenos trechos de código não estavam marcados como código (utilizando o sinal de crase).
Verifiquei apenas os 10 primeiros itens do sumário.

Copy link
Owner

@gomex gomex left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Eu percebi que a maior mudança requirida foi a formatação do negrito para uma outra coisa, que acredito que seja itálico, certo? Por que você acha que assim seria melhor?

@@ -6,7 +6,7 @@ Esse livro apresenta a utilização do Docker focando nas melhores práticas de

## Sumário

1. [Organização](manuscript/organizacao.md)
1. [Como ler esse livro](manuscript/organizacao.md)
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tem como manter organização? Acho que mudaria muito do que ja está no livro impresso.

@@ -18,7 +18,7 @@ As imagens retornadas estão presentes no seu **Docker host** e não demandam qu
docker image pull python
```

Usamos a imagem chamada **python** como exemplo, mas caso deseje atualizar qualquer outra imagem, basta colocar seu nome no lugar de **python**.
Usamos a imagem chamada `python` como exemplo, mas caso deseje atualizar qualquer outra imagem, basta colocar seu nome no lugar de `python`.
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A ideia de colocar ** é ser negrito. A ideia é dar enfase ao python mesmo, se você ver é um estilo que uso no livro inteiro.

@@ -52,9 +52,9 @@ Segue um exemplo simples no seguinte comando:
```
docker container run -it --rm --name meu_python python bash
```
De acordo com o comando acima, será iniciado um container com o nome **meu_python**, criado a partir da imagem **python** e o processo executado nesse container será o **bash**.
De acordo com o comando acima, será iniciado um container com o nome `meu_python`, criado a partir da imagem `python` e o processo executado nesse container será o `bash`.
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A ideia de colocar ** é ser negrito. A ideia é dar enfase a palavra mesmo, se você ver é um estilo que uso no livro inteiro.


Vale lembrar que, caso o **CMD** não seja especificado no comando **docker container run**, é utilizado o valor padrão definido no **Dockerfile** da imagem utilizada. No nosso caso é **python** e seu comando padrão executa o binário **python**, ou seja, se não fosse especificado o **bash**, no final do comando de exemplo acima, ao invés de um shell bash do GNU/Linux, seria exibido um shell do **python**.
Vale lembrar que, caso o `CMD` não seja especificado no comando `docker container run`, é utilizado o valor padrão definido no `Dockerfile` da imagem utilizada. No nosso caso é `python` e seu comando padrão executa o binário `python`, ou seja, se não fosse especificado o `bash`, no final do comando de exemplo acima, ao invés de um shell bash do GNU/Linux, seria exibido um shell do `python`.
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A ideia de colocar ** é ser negrito. A ideia é dar enfase a palavra mesmo, se você ver é um estilo que uso no livro inteiro.

@@ -117,7 +117,7 @@ Esse comando é responsável por mostrar todos os containers, mesmo aqueles não
docker container ls <parâmetros>
```

Os parâmetros mais utilizados na execução do container são:
Os parâmetros mais utilizados na execução desse comando são:
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Aqui eu falei sobre executar um container mesmo, acha que faz mais sentido comando?

@@ -17,7 +17,7 @@ As imagens podem ser oficiais ou não oficiais.

#### Imagens oficiais e não oficiais

As imagens oficiais do docker são aquelas sem usuários em seus nomes. A imagem **“ubuntu:16.04″** é oficial, por outro lado, a imagem [“nuagebec/ubuntu”](https://hub.docker.com/r/nuagebec/ubuntu/) não é oficial. Essa segunda imagem é mantida pelo usuário [nuagebec](https://hub.docker.com/u/nuagebec/), que mantém outras imagens não oficiais.
As imagens oficiais do docker são aquelas sem usuários em seus nomes. A imagem `ubuntu:16.04` é oficial, por outro lado, a imagem [“nuagebec/ubuntu”](https://hub.docker.com/r/nuagebec/ubuntu/) não é oficial. Essa segunda imagem é mantida pelo usuário [nuagebec](https://hub.docker.com/u/nuagebec/), que mantém outras imagens não oficiais.
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A ideia de colocar ** é ser negrito. A ideia é dar enfase a palavra mesmo, se você ver é um estilo que uso no livro inteiro.

@@ -27,7 +27,7 @@ As imagens não oficiais são mantidas pelos usuários que as criaram. Falaremos

**Nome da imagem**

O nome de uma imagem oficial é composto por duas partes. A primeira, a [documentação](https://docs.docker.com/engine/userguide/containers/dockerimages/) chama de **“repositório”** e, a segunda, é chamada de **“tag”**. No caso da imagem **“ubuntu:14.04”**, **ubuntu** é o repositório e **14.04** é a tag.
O nome de uma imagem oficial é composto por duas partes. A primeira, a [documentação](https://docs.docker.com/engine/userguide/containers/dockerimages/) chama de **“repositório”** e, a segunda, é chamada de **“tag”**. No caso da imagem `ubuntu:14.04`, `ubuntu` é o repositório e `14.04` é a tag.
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A ideia de colocar ** é ser negrito. A ideia é dar enfase a palavra mesmo, se você ver é um estilo que uso no livro inteiro.

@@ -41,7 +41,7 @@ docker image list

### Como criar imagens

Há duas formas de criar imagens customizadas: com **commit** e com **Dockerfile**.
Há duas formas de criar imagens customizadas: com `commit` e com `Dockerfile`.
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A ideia de colocar ** é ser negrito. A ideia é dar enfase a palavra mesmo, se você ver é um estilo que uso no livro inteiro.

@@ -73,7 +73,7 @@ Agora, efetuamos o **commit** desse **container** em uma **imagem**:
docker container commit containercriado meuubuntu:nginx
```

No exemplo do comando acima, **containercriado** é o nome do container criado e modificado nos passos anteriores; o nome **meuubuntu:nginx** é a imagem resultante do **commit**; o estado do **containercriado** é armazenado em uma imagem chamada **meuubuntu:nginx** que, nesse caso, a única modificação que temos da imagem oficial do ubuntu na versão 16.04 é o pacote **nginx** instalado.
No exemplo do comando acima, `containercriado` é o nome do container criado e modificado nos passos anteriores; o nome `meuubuntu:nginx` é a imagem resultante do `commit`; o estado do `containercriado` é armazenado em uma imagem chamada `meuubuntu:nginx` que, nesse caso, a única modificação que temos da imagem oficial do ubuntu na versão 16.04 é o pacote `nginx` instalado.
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A ideia de colocar ** é ser negrito. A ideia é dar enfase a palavra mesmo, se você ver é um estilo que uso no livro inteiro.

@@ -93,7 +93,7 @@ Se quiser validar, pode executar o mesmo comando na imagem oficial do ubuntu:
docker container run -it --rm ubuntu:16.04 dpkg -l nginx
```

> Vale salientar que o método **commit** não é a melhor opção para criar imagens, pois, como verificamos, o processo de modificação da imagem é completamente manual e apresenta certa dificuldade para rastrear as mudanças efetuadas, uma vez que, o que foi modificado manualmente não é registrado, automaticamente, na estrutura do docker.
> Vale salientar que o método `commit` não é a melhor opção para criar imagens, pois, como verificamos, o processo de modificação da imagem é completamente manual e apresenta certa dificuldade para rastrear as mudanças efetuadas, uma vez que, o que foi modificado manualmente não é registrado, automaticamente, na estrutura do docker.
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A ideia de colocar ** é ser negrito. A ideia é dar enfase a palavra mesmo, se você ver é um estilo que uso no livro inteiro.

@somatorio somatorio changed the base branch from master to main July 22, 2020 12:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants