DEV Community: Igor Souto

Docker machine: what is and the main commands

Igor Souto — Sun, 05 Jul 2020 00:09:22 +0000

Docker machine allows us to easily deploy an environment from a local machine in any infrastructure service, like AWS, DigitalOcean, Google Cloud, etc, through the installation of the driver that you want, environment variables, etc.

With that, we can create a host Docker in any of these platforms, and easily manage those machines from our local machine.

Main commands

CREATE

docker-machine create --driver virtualbox first-host-box

This command, creates a new host docker, with the driver VirtualBox and with the name "first-host-box".

LS

docker-machine ls

Lists all the available hosts in your machine.

ENV

Lists the environment variables that need to be set.

We can easily declare it with:

eval $(docker-machine env first-host-box)

IP

docker-machine ip first-host-box

Lists the ip of the host docker.

SSH

docker-machine ssh first-host-box

With this command, we can access via SSH this host docker and use Linux commands inside it.

INSPECT

docker-machine inspect first-host-box

Shows details of the host docker.

STOP

docker-machine stop first-host-box

Stops the host.

START

docker-machine start first-host-box

Starts the host.

RM

docker-machine rm first-host-box

Removes the host.

Conclusion

With this, the Docker machine promotes great ease of installation and deployment in a cloud environment from its local containers.

Docker machine: o que é e principais comandos

Igor Souto — Sat, 04 Jul 2020 23:55:26 +0000

A Docker machine possibilita deployar um ambiente de sua máquina local na infra que desejar, como AWS, DigitalOcean, Google Cloud etc, através da instalação do Driver que desejar, variáveis de ambiente e etc.

Com isso estamos criando um host Docker em uma máquina de uma uma dessas plataformas, e podemos facilmente gerenciar essas máquinas de nossa máquina local.

Principais comandos

CREATE

docker-machine create --driver virtualbox first-host-box

Com este comando, estamos criando um novo "host Docker", com o driver VirtualBox e dando o nome de "first-host-box".

LS

docker-machine ls

Irá listar todos os hosts disponíveis em sua máquina.

ENV

Irá listar todas as variáveis the ambiente que precisam ser configuradas.

Nós podemos facilmente declarar com o seguinte comando:

eval $(docker-machine env first-host-box)

IP

docker-machine ip first-host-box

Lista todos os IPs do nosso host Docker.

SSH

docker-machine ssh first-host-box

Com este comando podemos facilmente acessar via SSH nosso host Docker e executar comandos Linux dentro dele.

INSPECT

docker-machine inspect first-host-box

Mostra alguns detalhes do host Docker.

STOP

docker-machine stop first-host-box

Irá parar o host Docker.

START

docker-machine start first-host-box

Irá iniciar o host Docker.

RM

docker-machine rm first-host-box

Remove o host Docker.

Com isso, o Docker machine promove grande facilidade de instalação e deploy em um ambiente cloud a partir de seus containers locais.

Dockerhub and Registry Server

Igor Souto — Fri, 26 Jun 2020 22:22:52 +0000

Dockerhub is the Docker's website for repositories of images, very similar to Github, where we create repositories of code, that other people can use. On Docker, we host our Docker images, private ou public, of enterprises or not. And then, other people can use that image that you've created.

Accessing the Dockerhub's website, we can create our account and start using it.

Some commands

LOGIN

With the command docker login, you can sign in your Dockerhub's account. If you want to sign in another Registry instead of Dockerhub, just put the URL after like docker login <URL> .

PUSH

With the command docker push, it's possible to push a local image to Dockerhub.

The image's name must contain:

Your Dockerhub's username + the name that you want to give for the image + the version:

docker push username/webserver:1.0

To change the docker's name, use the command:

docker tag username/serverweb:2.0

PULL

To download the image from Dockerhub to the local machine, use:

docker pull image-name

The download will be made, and when finish, run using like:

docker run -ti webserver

Registry

A registry is like a "personal Dockerhub", for you or for your company. You can run in your local machine or any server, setting your own DNS, access control for users and etc.

It's possible to add web interfaces, so you can easily view your registry, in Dockerhub has many examples of templates to install.

Creating a local registry

For building your local registry, in order not to need Dockerhub, either for your self or your company, we do the following:

docker run -d -p 5000:5000 --restart=always --name registry registry:2

This command is linking our port 5000 of host docker (local machine) and the image.

We are telling Docker that if something happens to our container and he dies, it will be automatically restarted. We're giving our container the name "registry" and using the image "registry:2" from Dockerhub.

Pushing an image to the local registry

For pushing images to the local registry, just renaming an image, replacing the username for the registry's URL, that in our case it would be like:

 docker tag <image-id> [localhost:5000/webserver:](http://localhost:5000/webserver:1.0`)1.0

But it could be a server DNS etc.

We use docker push for pushing the image, as we did for pushing to Dockerhub, and docker pull if we want to download an image from the registry.

For verifying the images in your registry, run: (if is a DNS you would change it and either the port.

curl localhost:5000/v2/_catalog

Conclusion

Dockerhub is a very interesting alternative if you or a company wants to share images, whether public or private. And for those who want to have a more private alternative, with their own rules and settings, the Registry is a great alternative, being very customizable and having a lot of content available to assist those who want to create one.

Dockerhub e Servidor Registry

Igor Souto — Fri, 26 Jun 2020 22:18:19 +0000

Dockerhub é reposítorio de imagens do Docker, semelhante ao Github, onde criamos repositórios de códigos em que outras pessoas possam usar, no Dockerhub hospedamos nossas imagens do Docker, privadas ou públicas, de organizações ou não. E assim outras pessoas podem utilizar esta imagem que você criou.
Acessando o site do Dockerhub, podemos criar nossa conta nele e já começar a usar.

Comandos para utilizar o Dockerhub localmente

LOGIN

Com o comando docker login podemos fazer login em nosso Dockerhub. Caso queira fazer login em outro registry sem ser o Dockerhub, basta colocar a url dele: docker login <url> .

PUSH

Com o comando docker push é possível fazer o push de uma imagem local para o Dockerhub. O nome da imagem deve conter o seu nome de usuário do dockerhub + o nome que você quer dar a imagem + a versão. Ex:

docker push username/webserver:1.0

(Para mudar o nome da imagem, utilize o comando:

docker tag username/image-name .

PULL

Para baixar a imagem de volta para a máquina local, basta usar o comando:

docker pull <nome-da-imagem>

Será feito o download da imagem. Finalizado o download, podemos rodar a imagem com:

docker run -ti <nome-da-imagem>

Registry

Um registry seria como um Dockerhub próprio, para você ou sua empresa. Você pode rodar em sua máquina local ou em algum servidor, configurando seu próprio DNS, controle de acesso de usuários e etc.

É possível também adicionar interfaces web para que você possa visualizar seu Registry mais facilmente, no Dockerhub tem muitos exemplos.

Criando um registry local

Para criar um Registry local, para não precisar do Dockerhub, seja para você mesmo ou para sua empresa, fazemos o seguinte:

docker run -d -p 5000:5000 --restart=always --name registry registry:2

Este comando está linkando nossa porta 5000 do host docker (máquina local) e da imagem. Estamos dizendo também que caso aconteça algo com nosso container e ele caia, ele será automaticamente restartado. Estamos dando o nome do nosso container de "registry" e utilizando a imagem "registry:2" do Dockerhub.

Subindo imagem para o registry local

Para subir imagens para este registry local, apenas renomeamos uma imagem, substituindo o nome de usuário pela url do registry, que no nosso caso no momento fica: docker tag <id-da-imagem> [localhost:5000/webserver:](http://localhost:5000/webserver:1.0)1.0` , mas poderia ser um dns que tivesse etc.

docker push também para subir, assim como era para subir para o Dockehub, e docker pull caso quisermos baixar uma imagem do registry.

Para verificarmos quais imagens temos em nosso Registry, podemos rodar: (caso seja um DNS, seria apenas trocar a url, assim como a porta também).

bash curl localhost:5000/v2/_catalog

Conclusão

O Dockerhub é uma alternativa bem interessante caso você ou empresa queira compartilhar imagens, seja pública ou privado. E para quem deseja ter uma alternativa mais privada, com suas próprias regras e configurações, o Registry é uma ótima alternativa, sendo muito personalizável e tendo muito conteúdo disponível para auxiliar quem deseja fazer a criação de um.

Dockerfile: main commands and instructions

Igor Souto — Wed, 24 Jun 2020 23:39:53 +0000

The Dockerfile what we use to create an image.

It works like a recipe, we pass an image as base, commands and all the step by step.

When building this Dockerfile, we create an image, and from this image, we create a container.

Useful Dockerfile commands

FROM

FROM debian

Must be the first command in a Dockerfile, with this command we set the image that will be used as base in our image.

ADD

ADD opa.txt /directory/

To move a file into a container directory, it can be .tar files.

CMD

CMD ["sh, "-c", "echo", "$HOME"]

It defines a command to be executed when a container with this image initializes.

There can be only one CMD instruction in a Dockerfile. If you add more than one, only the last will take effect.

It can be overwritten when using if we pass another command in command line, like:

docker run -d my-image /bin/bash

LABEL

LABEL Description="Bla bla bla giropops"

Use it to set a container's description and keep it easy to manage all containers.

COPY

COPY opa.txt /directory/

Similar to ADD, but you can copy normal files and directories.

ENTRYPOINT

ENTRYPOINT ["npm", "run", "dev"]

It's like CMD, but this can not be overwritten, it will always execute, the container will run as an executable.

When this command dies, the container dies too.

ENV

ENV API_KEY="Igor Souto"

Sets environment variables to the container.

EXPOSE

EXPOSE 80

Sets ports that container will expose, so that container will be accessible by this ports.

RUN

RUN apt-get update && apt-get install apache2 && apt-get clean

Used to run commands in the container, generally used to install packages.
Each RUN creates a new layer in our container, so we need to avoid creating too many RUN, to create fewer layers and don't let all too messy, after all, we only have read-write access in the last layer, so depending on what we want to do, we can't (e.g. apt-get clean in another RUN).
You can read the Docker post here to undestand more about image's layers.

USER

USER igor

To define a user inside the container, the default is the ROOT user.

WORKDIR

WORKDIR /mydir

Defines the directory of work. As the container gets executed, this is the directory that we will get inside when we access the container.

VOLUME

VOLUME /mydir

Creates a volume, a directory that will have a copy in our machine/host-docker.

Changing something in that volume in our machine will reflect the container, and vice-versa.

MAINTAINER

MAINTAINER Igor myemail@provider.com

Set the container owner.

Build container

docker build -t first_image:1.0 .

Now to build the image, we use the Docker build command. we pass the -t parameter to name this image, a colon, and the version. And we use the ".", To say that our Dockerfile is at the same directory level. We don't point to the Dockerfile, but the directory it is in.

Dockerfile: principais comandos e instruções

Igor Souto — Wed, 24 Jun 2020 23:29:48 +0000

O Dockerfile é o meio que utilizamos para construir uma imagem.

Ele funciona como uma receita, em que vamos passando uma imagem base, comandos e todo o passo a passo.

Ao construir este Dockerfile, criamos nossa imagem, e a partir desta imagem, criamos nosso container.

Comandos mais úteis no Dockerfile

FROM

FROM debian

Deve ser o primeiro comando de um Dockerfile, com ele configuramos qual a imagem que queremos utilizar como base na nossa imagem.

ADD

ADD opa.txt /diretorio/

Para mover um arquivo para dentro de um diretório do container, podendo ser arquivos .tar .

CMD

CMD ["sh, "-c", "echo", "$HOME"]

Define um comando para ser executado quando um container com esta imagem inicializar.

Pode haver apenas uma instrução CMD em um Dockerfile. Se você adicionar mais de um, apenas o último entrará em vigor.

Ele pode ser sobrescrito se passarmos outro comando na linha de comando, como:

docker run -d minha-imagem /bin/bash

LABEL

LABEL Description="Bla bla bla giropops"

Para adicionar uma descrição ao container e ficar mais fácil de gerenciar os containers.

COPY

COPY opa.txt /diretorio/

Semelhante ao ADD, porém vc pode copiar arquivos normais e diretórios.

ENTRYPOINT

ENTRYPOINT ["npm", "run", "dev"]

É bem parecido com o CMD, mas este não pode ser sobrescrito, ele sempre será executado e o container irá rodar como um executável.

Quando este comando "morrer", o container morrerá também.

ENV

ENV API_KEY="Igor Souto"

Para configurar variáveis de ambiente para o container.

EXPOSE

EXPOSE 80

Configura portas que o container irá expor, e então o container será acessível por essas portas.

RUN

RUN apt-get update && apt-get install apache2 && apt-get clean

Usado para executar comandos no contêiner, geralmente usado para instalar pacotes.
Cada RUN cria uma nova camada em nosso contêiner, portanto, precisamos evitar criar RUNs demais, criar menos camadas e não deixar tudo muito confuso, afinal, só temos acesso read-write na última camada, dependendo sobre o que queremos fazer, não podemos (por exemplo, apt-get clean rodando em outro RUN).
Para entender melhor como funcionam as camadas da imagem, acesse aqui o post sobre Docker.

USER

USER igor

Para definirmos qual será o usuário dentro do container, por padrão ele é o usuário ROOT.

WORKDIR

WORKDIR /catota

Para definirmos qual o diretório de trabalho. Assim que o container for executado, este diretório será o que iremos cair dentro ao acessar o container.

VOLUME

VOLUME /diretorio

Passamos o caminho em que o Docker irá criar um volume, ou seja, um diretório que terá uma cópia em nossa máquina local e que se alterarmos algo neste diretório, será alterado dentro do container também e vice-versa.

MAINTAINER

MAINTAINER Igor igor@email.com

Passamos quem é o dono do container.

Build container

docker build -t primeira_imagem:1.0 .

Agora para buildar a imagem, usamos o comando build do Docker. passamos o parametro -tpara nomear esta imagem, dois pontos e uma versão. E utilizamos o " . ", para dizer que nosso Dockerfile se encontra neste mesmo nível de diretório. Não apontamos o Dockerfile, e sim o diretório que ele se encontra.

Docker: Imagens, Containers, e seus principais comandos

Igor Souto — Sat, 20 Jun 2020 16:17:01 +0000

O Docker veio para facilitar a criação e gerenciamento de ambientes, para usos perssoais, de empresas e comunidades open-source. Rodando apenas um comando, agora podemos ter o ambiente inteiro em que um projeto foi construido, com suas versões e aplicações instaladas e rodando.

E agora a frase "Mas na minha máquina funciona" já não é mais necessária, porque sempre teremos o mesmo ambiente, independente de onde a aplicação esteja rodando. :D

Vamos ver um pouco de como o Docker funciona e o que podemos fazer com ele!

Container

Um container é onde as dependências serão instaladas, as aplicações e tudo para nosso projeto poder rodar. Ele utiliza de imagens (como pequenos SOs como base) para rodar a aplicação. Quando a aplicação precisar utilizar o Kernel, ela não utilizará o Kernel do container, porque ele não possui um. Ele utilizará o Kernel do host docker (máquina física).

Este único Kernel irá gerenciar todos os container em execução.

Um container não é uma VM, como muitas pessoas dizem. Em uma VM todo o SO é virtualizado, um SO completo com um kernel e muitas camadas até a aplicação, consumindo muito mais recursos.

Um container é pequeno, a aplicação fica muito mais perto da infraestrutura e SO.

Uma VM emula uma máquina , um container emula uma aplicação.

Um container também é portável, você facilmente consegue pegar os binários que o Docker cria e passar para uma outra máquina/servidor, funcionará perfeitamente.

Imagens

Uma imagem é como se fôsse um container em um ponto no tempo ou como um container parado.

Quando você constrói um container, usa imagens que foram um container e compartilhado no Dockerhub (ou você pode construir a sua própria do zero).

Se você constrói um container, para ele e compartilha, outras pessoas poderão usar ele como uma imagem dentro de seus containers.

Usando o conceito de POO, é como se a imagem fosse uma classe e o container uma instância desta imagem.

Camadas

O file system do Docker trabalha com camadas.

Quando se está construindo uma imagem, cada passo cria uma camada, e todas as camadas são read-only, exceto a última, que será sempre read-write.

Copy on Write

Quando é preciso modificar uma camada read-only, esta camada será copiada para a camada read-write e então poderá ser modificada.

Esta ação é chamada de Copy on Write.

É como se fosse um livro, que você pode ler, mas quando você for alterar uma página, no momento em que você encosta a caneta na folha está folha é copiada e você modifica esta folha copiada, que criará uma nova folha, preservando a folha antiga.

Comando da CLI do Docker

RUN

docker run hello-world

É o comando que inicializa um container, passando o nome da imagem que o container irá utilizar.

Se o Docker não encontrar esta imagem localmente, ele autmaticamente ira tentar encontrar esta imagem no Dockerhub irá começar a fazer seu download e em seguida rodar o container.

PS

docker ps

Lista todos os containers em execução.

Passando o parâmetro -a depois de ps irá listar todos os containers, incluindo os que estão parados.

IMAGES

docker images

Vai listar todas as imagens que estão na sua máquina.

CREATE

docker create ubuntu

Irá criar um container, mas não irá executá-lo.

STOP

docker stop container-id

Para um container.

START

docker start container-id

Inicia um container parado.

STATS

docker stats container-id

Mostra os status que um container está utilizando, como memória, rede e CPU.

RM

docker rm container-id

Remove um container, se um container estiver em execução, use o parâmetro -f para forçar.

Parâmetros importantes do comando RUN

-ti

docker run -ti image-name /bin/bash

O t é de terminal, e i de interativo, então estamos dizendo que queremos utilizar o terminar e que seja interativo para utilizar o container.

-d

docker -d image-name

É para todar um container em modo daemon (em background).

É útil para containers "data-only", que não precisará de interação.

ATTACH

docker attach container-id

Retorna para um container fechado (mas não parado).

Commandos para o Bash

CTRL + D

Vai fechar o container, matando o bash, e se o bash for o job principal do container, irá matar o container também.

CTRL + P + Q

Irá sair do container sem matar ele, apenas fechado. Você pode voltar para este container utilizando o comandoattach.

Bônus: liberando memória

docker rm $(docker ps -a -q); docker rmi $(docker images -a -q) -f

docker system prune --volumes

Conclusão

O Docker veio para ajudar muito em nossas vidas, com apenas algumas configurações, nós podemos desenvolver um grande ambiente, em que qualquer um com Docker poderá utilizar também.

Docker: Images, Containers, and its main commands

Igor Souto — Sat, 20 Jun 2020 16:02:07 +0000

Docker came to facilitate the creation and management of environments, for personal users, enterprises, and open-source communities.
Running just a command, we can now have the entire environment that the project was built with, with its versions and applications installed and running, easy setup.

And the phrase "but it works on my machine" is not necessary anymore, because we always have the same environment, whatever we are running the application. :D

Let's see a little bit of how Docker works and what we can do with it!

Container

A container is where you will install your dependencies, application, and everything to your project to start running. It will use the container images (like little OS as a base) to run the application, and when it needs to use the Kernel, it will not use the container's kernel, because it does not have one. It will use the host docker's Kernel (the physical machine).

This Kernel will manage all the containers running.

A container is not a VM like most people say. A VM you have to virtualize all the OS, it's big, a complete OS with a kernel and many layers until the application, consuming much more resources.
A container is small, the application is closer to the infrastructure and OS.

A VM emulates a machine, the container emulates an application.

It's portable too, you can easily get the binaries that Docker creates for the container and put in another server/machine, it will work like a charm.

Images

A Docker image is like a Docker container in a point at the time, or like stopped docker container.

When you build a container, you use images that are a container that was created and shared in Dockerhub (or you can build yours from scratch).

If you build a container, stop and share it, other people can use it inside their container as an image.

Using the OOP concept, It's like the image is a Class and a container is an instance of that image.

Layers

The Docker's file system works with layers.

When you're building an image, each step creates a layer, and all layers are read-only, except the last layer that is Read-write.

Copy on Write

When you need to modify a read-only layer, this layer will be copied to the read-write layer and then it can be modified.

This action is called Copy on Write.

That is like a book, that you can read, but when you change a sheet, the moment that you touch the pen, that sheet is copied and you modify that copied sheet, creating a new sheet, preserving the old one.

CLI Commands

RUN

docker run hello-world

Is the command the initializes a container, passing the image's name that the container will use.

If Docker is unable to find that image locally, it will automatically try to find that image in Dockerhub and start downloading and running.

PS

docker ps

List the containers in execution.

Passing the parameter -a after ps will list all containers, including the stopped ones.

IMAGES

docker images

We Will list all images in your machine.

CREATE

docker create ubuntu

It creates a container but not execute it.

STOP

docker stop container-id

Stops the container.

START

docker start container-id

It starts a stopped container.

STATS

docker stats container-id

Show the stats like memory, net, and CPU of a container.

RM

docker rm container-id

Removes a container, if the container is running, use the parameter -f to force it.

Important parameters for command Run

-ti

docker run -ti image-name /bin/bash

The t is terminal, and i is interactive, so we are telling that we can want a terminal and it will be interactive to use the container.

-d

docker -d image-name

It is for running the container in daemon mode (in the background).

It's useful for "data-only" containers, that will not need interaction.

ATTACH

docker attach container-id

Return to a closed (but not stopped) container.

Bash commands

CTRL + D

Will exit the container "killing" the bash, and if the bash is the principal job of the container, the container will be killed.

CTRL + P + Q

Will exit the container without "killing" it, just closing. You can go back to this container using the attach command.

Freeing memory

docker rm $(docker ps -a -q); docker rmi $(docker images -a -q) -f

docker system prune --volumes

Conclusion

Docker came to help a lot with our lives, with just some settings, we can develop a huge environment that anyone with Docker can easily use too.