Docker Compose Build (Tutorial para Desenvolvedores)

O que é Docker?

Docker é uma plataforma de código aberto que simplifica o processo de desenvolvimento, implantação e execução de aplicativos usando conteinerização. Contêineres são unidades ultraleves e portáteis que empacotam um aplicativo junto com suas dependências, permitindo execução consistente em diversos ambientes, desde o sistema local de um desenvolvedor até servidores de produção. Diferente de máquinas virtuais tradicionais, os contêineres utilizam o kernel do sistema operacional host, aumentando sua velocidade e eficiência.

Docker oferece um modelo virtualizado por meio de imagens Docker para criar e gerenciar conjuntos de contêineres. Inclui o Docker Hub, uma forma de repositório de imagens de contêiner. O grande apelo dessa tecnologia é sua escalabilidade, portabilidade e eficiência, tornando-a altamente popular em DevOps e fluxos de trabalho de desenvolvimento centrados na nuvem.

Como funciona o Docker?

• O Docker Daemon escuta por solicitações do Cliente Docker, que podem incluir docker build, docker pull, ou docker run.
• O Docker Daemon lida com a criação, gerenciamento e monitoramento de contêineres. Ele também recupera as imagens Docker necessárias de um registro, como o Docker Hub.
• Usando a imagem baixada, o daemon cria um contêiner isolado, efetivamente uma instância em execução do aplicativo.
• Os contêineres compartilham o kernel do sistema operacional da máquina host, mas permanecem isolados uns dos outros, permitindo que o software opere em um ambiente único com suas dependências.

+--------------------+
|   Docker Client   |
|  (CLI/API)        |
+--------------------+
         |
          v
+--------------------+               +---------------------+
|   Docker Daemon    |   -------->   |   Docker Registry  |
|  (manages resources|               |  (stores images)   |
|  & runs containers)|               +---------------------+
+--------------------+
         |
          v
+---------------------+
|      Container      |  
|  (App Instance)    |
+---------------------+
         |
          v
+---------------------+
| Docker Image        |  
| (App Blueprint)    |
+---------------------+

+--------------------+
|   Docker Client   |
|  (CLI/API)        |
+--------------------+
         |
          v
+--------------------+               +---------------------+
|   Docker Daemon    |   -------->   |   Docker Registry  |
|  (manages resources|               |  (stores images)   |
|  & runs containers)|               +---------------------+
+--------------------+
         |
          v
+---------------------+
|      Container      |  
|  (App Instance)    |
+---------------------+
         |
          v
+---------------------+
| Docker Image        |  
| (App Blueprint)    |
+---------------------+

O que é o Docker Compose?

O Docker Compose fornece uma maneira fácil de gerenciar uma aplicação Docker de múltiplos contêineres usando um único arquivo: docker-compose.yml. Este arquivo YAML permite a configuração de múltiplos serviços, especificando aspectos como imagens Docker, variáveis de ambiente, redes e volumes. Você pode utilizar comandos do Docker Compose como docker-compose up ou docker-compose down para gerenciar todos os contêineres em uma aplicação com uma única ação.

+--------------------------+
|   docker-compose.yml     |  (Configuration file)
+--------------------------+
           |
            v
+----------------+    +----------------+    +----------------+
|   Service 1    |    |   Service 2    |    |   Service 3   |
|  (e.g. web)    |    |  (e.g. db)     |    |  (e.g. cache) |
+----------------+    +----------------+    +----------------+
            |                  |                  |
            -----------------------------------------
                         Docker Application

+--------------------------+
|   docker-compose.yml     |  (Configuration file)
+--------------------------+
           |
            v
+----------------+    +----------------+    +----------------+
|   Service 1    |    |   Service 2    |    |   Service 3   |
|  (e.g. web)    |    |  (e.g. db)     |    |  (e.g. cache) |
+----------------+    +----------------+    +----------------+
            |                  |                  |
            -----------------------------------------
                         Docker Application

O Docker Compose é particularmente vantajoso para aplicações complexas, como microsserviços com inúmeras instâncias de contêineres. É utilizado efetivamente em ambientes de desenvolvimento, teste e produção.

Criar um novo aplicativo React JS com ASP.NET Core

Siga estas etapas para criar um novo aplicativo React do Visual Studio com um backend ASP.NET Core e adicionar suporte ao Docker:

Pré-requisitos

• Visual Studio: Verifique se o Visual Studio 2022 ou mais recente está instalado com as cargas de trabalho necessárias:
  • Desenvolvimento Web e ASP.NET
  • Desenvolvimento Node.js (React)
  • Suporte Docker
• Docker Desktop: Precisa estar instalado e em execução.

Criar Novo Projeto

1. Abra o Visual Studio e escolha Novo Projeto no menu.

   

2. Procure por "React e ASP.NET Core Web Application" na caixa de diálogo "Criar um novo projeto" e selecione-o. Clique em Avançar.

   

3. Forneça um nome para o projeto, selecione um nome para a solução e escolha o local de salvamento. Clique em Avançar.

   

4. Verifique se o suporte ao Docker está habilitado. Escolha o framework desejado e clique em Criar.

   

5. Após a criação do projeto, adicione suporte ao Docker clicando com o botão direito no nó do projeto e selecionando Adicionar > Suporte ao Docker.

   

6. Escolha o nome e o tipo do contêiner, então clique em Ok.

   

Agora que o projeto recém-criado foi adicionado ao contêiner Docker, os comandos Docker Compose podem executá-lo. Abaixo está uma saída de exemplo gerada a partir do código do lado do cliente React JS.

Abaixo está o código do lado do servidor da API executando a partir do contêiner Docker.

IronSecureDoc

IronSecureDoc permite que desenvolvedores integrem de forma eficaz o processamento seguro de documentos em aplicativos conteinerizados. Com o suporte do Docker, encapsule seu aplicativo ASP.NET Core usando IronSecureDoc, incentivando uma implantação e escalonamento contínuos. Crie um Dockerfile para integrar o IronSecureDoc com seu aplicativo ASP.NET Core, juntamente com os scripts ou configurações necessários.

Além disso, um arquivo docker-compose.yml pode delinear dependências de serviço e variáveis de ambiente para fácil acesso, auxiliando no gerenciamento eficiente de tarefas de segurança de documentos em diferentes configurações de implantação. Garantir a instalação e configuração do IronSecureDoc, como o Docker, é essencial para oferecer recursos como criptografia e redação de documentos.

Instalando e Executando o IronSecureDoc

Recupere a imagem Docker do IronSecureDoc com este comando:

docker pull ironsoftwareofficial/ironsecuredoc

docker pull ironsoftwareofficial/ironsecuredoc

Depois de puxar a imagem, use o seguinte comando para lançar o IronSecureDoc em um novo contêiner:

docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

Usando o IronSecureDoc com Container Docker

A API REST do IronSecureDoc permite operações de documentos como redação, certificação e criptografia, uma vez instalado e em execução no Docker. Para mais informações sobre endpoints da API, verifique a documentação.

Para criptografar um documento, envie uma solicitação POST à API do IronSecureDoc:

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/encrypt?user_password=demo' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/encrypt?user_password=demo' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

Este comando envia o documento ao IronSecureDoc para criptografia.

Conclusão

Integrar o Docker Compose com o IronSecureDoc melhora significativamente a eficiência e confiabilidade de aplicações que requerem manuseio seguro de documentos. O Docker Compose gerencia efetivamente aplicações multi-contêiner, simplificando a coordenação de dependências e serviços, incluindo o IronSecureDoc, o que garante consistência no ambiente de desenvolvimento, simplifica configurações e aumenta a escalabilidade.

Nesta configuração, os desenvolvedores podem aproveitar plenamente os recursos de segurança de documentos, como criptografia e redação, dentro de uma estrutura conteinerizada. Em geral, combinar Docker Compose com IronSecureDoc enriquece o processo de desenvolvimento, oferecendo um método seguro e eficiente para manipular documentos sensíveis em aplicações modernas. Para informações sobre licenciamento do IronSecureDoc, visite esta página. Clique aqui para explorar mais produtos da Iron Software.