Este documento objetiva detalhar processo de instalação da aplicação Servidor de Estoque através do Podman.
Etapa 1 - Preparação ambiente para instalação da imagem da aplicação
Esta etapa objetiva preparar um diretório no servidor onde será instalada e executada a imagem do Servidor de Estoque.
Atenção
Caso já tenha havido processo de preparação de ambiente para o servidor, os passos abaixo podem ser ignorados. Se as recomendações desta foram seguidas, basta verificar se existe diretório com nomenclatura container-linx no diretório /home.
| INFORMAÇÕES | EXEMPLO |
|---|---|
1 - Criação de diretório Sugerimos a criação de um diretório exclusivo para receber a imagem da aplicação. Dessa forma, sugerimos que seja criado diretório containers-linx, no /home . Na coluna ao lado estão os exemplos de comandos a serem executados o sistema operacional linux | TERMINAL LINUX user@group /home: mkdir containers-linx |
2 - Concessão de Permissões Conceder permissão completa para diretório acima definido, a fim de habilitar as ações de leitura, escrita e execução da aplicação. Na coluna ao lado está detalhado comando CHMOD. | TERMINAL user@group /home: chmod 777 -R containers-linx |
Etapa 2 - Download da Imagem do Servidor de Estoque
Esta etapa objetiva explicar processo de download da release do Servidor de Estoque que está disponível no RCA Azure Linx.
Atenção
Para a sequencia dessa etapa é mandatório que usuário tenha o acesso mencionado na seção pré-requisitos.
| INFORMAÇÕES | EXEMPLO |
|---|---|
| 1- Iniciar um novo TERMINAL e executar comando para processo de autenticação no Azure. Após a execução do comando, será solicitada a digitação do usuário e senha. | TERMINAL LINUX user@group /home/containers-linx: podman login acrlinxbigretail.azurecr.io |
2 - Realizar download da imagem da aplicação. Neste passo, deve ser informada a versão do release desejado no formato XX.XX.XX. No exemplo ao lado está sendo considerada a versão 3.0.0 do Servidor de Estoque. Após execução do comando, download será iniciado. | TERMINAL LINUX user@group /home/containers-linx: podman pull acrlinxbigretail.azurecr.io/linx-servidor-estoque:<versao> // substitua o <versao> pelo número da versão EX: 3.0.0 TERMINAL WINDOWS root@aa-VirtualBox /home: podman pull acrlinxbigretail.azurecr.io/linx-servidor-estoque:3.0.0 Trying to pull acrlinxbigretail.azurecr.io/linx-servidor-estoque:3.0.0... Getting image source signatures Copying blob adb1afd7072d skipped: already exists Copying blob 7b11f246b3d3 skipped: already exists Copying blob 75f829a71a1c skipped: already exists Copying blob 506aff4a9c5a skipped: already exists Copying blob b765648c2a58 skipped: already exists Copying blob 7906d463638b skipped: already exists Copying blob aa78f0ffbb98 skipped: already exists Copying blob cdd1404b6c75 skipped: already exists Copying blob 25cdcfb4a1f3 skipped: already exists Copying blob 78bf96c066c8 skipped: already exists Copying blob 4ac5275d3fa2 skipped: already exists Copying blob 10ff85bee518 skipped: already exists Copying blob ad6c68b0b765 skipped: already exists Copying blob cad21cb20163 skipped: already exists Copying blob 3487f675a371 skipped: already exists Copying blob d36edfef5b07 skipped: already exists Copying config 9bb3c06023 done Writing manifest to image destination Storing signatures 9bb3c0602373f7cc9b3e8ead9e01a02e71876518009ea723d22f9d225abb5373 |
Etapa 3 -Configurando o Container (Podman) para Execução
Nesse passo vamos detalhar processo de configuração para execução do container (Podman) contendo a aplicação do Servidor de Estoque
Principal objetivo é detalhar as instruções para prover as configurações necessárias para funcionamento da aplicação como:
- Apontamentos e credenciais de banco de dados
- Definições de tunning de memória da JVM
- Configurações de volume externo ao contêiner onde haverá uma visibilidade para informações necessárias do cotidiano como: acesso aos logs e arquivos de configuração da aplicação.
| INFORMAÇÕES | EXEMPLO | |||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1- Criação de diretório para armazenar as configurações Sugerimos a criação do diretório container-servidor-estoque, no /home/conatiner-linx . Atenção Caso tenha sido escolhido um outro diretório na Etapa 01 deste documento, a instrução acima deve considerar este diretório como a raiz para criação do container-servidor-estoque. | TERMINAL LINUX user@group /home/containers-linx: mkdir container-servidor-estoque | |||||||||||||||||||||||||||||||||
2 - Concessão de Permissões Conceder permissão completa para diretório completo a fim de habilitar as ações de leitura, escrita e execução da aplicação. Na coluna ao lado está detalhado comando CHMOD. | TERMINAL user@group /home/containers-linx: chmod 777 -R container-servidor-estoque | |||||||||||||||||||||||||||||||||
3- Definir as configurações por linha de comando Uma vez realizados os processos acima, deve ser executado comando abaixo para configuração da base de dados necessário para funcionamento do Servidor de Estoque. podman run --name servidor-estoque --privileged -dit --restart=always -p 8444:8443 -p 8080:8080 -p 4058:4058 -p 8191:8191 -p 4048:4048 -e DB_CONNINFO=<string conexao banco>-e DB_USER=<usuario banco> -e DB_PASS=<password usuario banco> -e DB_DRIVER=oracle -e MEM_MS=512m -e MEM_MX=512m -e MEM_MAX_PERM=1024m -e MEM_MAX_HEAP=1024m -v /home/containers-linx/container-servidor-estoque:/opt/jboss/wildfly/standalone/data/linx-servidor-estoque/ -v /home/containers-linx/container-servidor-estoque:/opt/jboss/wildfly/standalone/log/ acrlinxbigretail.azurecr.io/linx-servidor-estoque:<versao> Os itens marcados em vermelho precisam ser substituídos pelos valores definidos do ambiente onde o servidor será executado. Abaixo uma tabela com o detalhamentos desses parâmetros:
Adicionalmente, para uma melhor compreensão do comando, segue abaixo uma tabela com detalhamento das informações:
podman run --name servidor-estoque --privileged -dit --restart=always -p 8444:8443 -p 8080:8080 -p 4058:4058 -p 8191:8191 -p 4048:4048 -e DB_CONNINFO=jdbc:oracle:thin:@10.4.229.26:1522/ora19-e DB_USER=dbcsi_p2k -e DB_PASS=dbcsi_p2k -e DB_DRIVER=oracle -e MEM_MS=512m -e MEM_MX=512m -e MEM_MAX_PERM=1024m -e MEM_MAX_HEAP=1024m -v /home/containers-linx/container-servidor-estoque:/opt/jboss/wildfly/standalone/data/linx-servidor-estoque/ -v /home/containers-linx/container-servidor-estoque:/opt/jboss/wildfly/standalone/log/ acrlinxbigretail.azurecr.io/linx-servidor-estoque:3.0.0 | TERMINAL LINUX user@group /home/containers-linx/container-servidor-pedidos: podman run --name servidor-estoque --privileged -dit --restart=always -p 8444:8443 -p 8080:8080 -p 4058:4058 -p 8191:8191 -p 4048:4048 -e DB_CONNINFO=<string conexao banco>-e DB_USER=<usuario banco> -e DB_PASS=<password usuario banco> -e DB_DRIVER=oracle -e MEM_MS=512m -e MEM_MX=512m -e MEM_MAX_PERM=1024m -e MEM_MAX_HEAP=1024m -v /home/containers-linx/container-servidor-estoque:/opt/jboss/wildfly/standalone/data/linx-servidor-estoque/ -v /home/containers-linx/container-servidor-estoque:/opt/jboss/wildfly/standalone/log/ acrlinxbigretail.azurecr.io/linx-servidor-estoque:<versao> |