Atualização de publicação de serviços 26/07/2023

A partir dessa data, há uma nova modalidade de versionamento: serviços versionados exclusivo

serviços versionados exclusivo seguem o versionamento do ERP(2023.3.0.x), porém diferente de serviços versionados não exclusivos, rodam apenas uma instância, que deve ser compatível com todas as rotas das versões antigas.

Devido a criação de serviços versionados exclusivos, algumas mudanças foram feitas na publicação de serviços:

Adições à Jenkinsfile

Propriedades adicionadas às Jenkinsfiles:

Geral

• publishProdImageOnRelease:

  Quando definida como true, a build do Jenkins irá publicar a imagem de produção e de homologação ao liberar um commit na release.

  A imagem de homologação tomara efeito imediato nos ambientes da qualidade, enquanto a imagem de produção será atualizada somente à noite.

  A funcionalidade de Tag continua a mesma: libera imagem de produção, e atualiza imediatamente no portal de produção.

Frontend

• runAsContainer:

  Faz com que o Front rode como um container exclusivo na nuvem. Esse será o novo padrão.

  FrontEnd que rodam como containers ficam no servidor Process-3, e o nome do container é o Identificador do aplicativo.

Migrando frontend para rodar como container

1. Atualize a Jenkinsfile do repositório para a ultima versão utilizando o template do schematics

   • A propriedade runAsContainer deve ter o valor true.

2. Crie um compose para o front:

   1. Acesse o diretório Oracle/Process-3/frontend-composes em korp-aic.

   2. Duplique o arquivo compose-exemplo.yml, e o renomeia para compose-<app_id>.yml, onde <app_id> é o identificador do seu app.

   3. Verifique em qual das 3 categorias seu aplicativo se encaixa:

      • Frontend não versionado

      • Frontend versionado exclusivo

      • Frontend versionado não exclusivo

   4. Mantenha o template de compose para a sua categoria de versionamento, e remova as outras.

   5. Substitua as variáveis:

      • appIdentifier

      • version

   6. Crie um PR, e solicite para a equipe de DevOps atualizar o arquivo no servidor.

Migrando serviço não versionado para versionado exclusivo

Korp-IAC

1. Localizar compose do serviço

2. Alterar as propriedades image e container_name, adicionando a nova versão.

   <service-name>:
     image: "korp/<service-name>:<version>.x"
     container_name: "<service-name>-<version>"
     restart: "no"
     extra_hosts: *extra_hosts
     environment:
       - URL_CONSUL=http://consul-agent-process:8500
       - URL_GATEWAY=https://gateway.korp.com.br
       - HOST_ADDRESS=<host_addr>
       - HTTP_PORT=<port>
     networks:
       - servicos
     ports:
       - "<port>:<port>"
   

3. Subir PR para a equipe de DevOps e solicitar atualização do compose no servidor.

KorpSetupLinux

1. Localizar compose do serviço

2. Alterar as propriedades image e container_name, alterando a versão para ‘{{ version_without_build }}’

   <service-name>:
     image: "{{ docker_account }}/<service-name>:{{ version_without_build }}.x{{ docker_image_suffix }}"
     container_name: "<service-name>-{{ version_without_build }}"
     restart: unless-stopped
     extra_hosts: *default-extra_hosts
     environment:
       - ON_PREMISE_MODE=true
       - USE_SERVERGC={{ use_servergc }}
       - URL_CONSUL=http://consul-server:8500
       - CERT_FILE_PATH={{ containers_cert_path }}
     networks:
       - servicos
     volumes:
       - "{{ certs_directory }}/:{{ certs_directory }}/"
   

3. No diretório vars da role, editar o arquivo main.yml, e remover a propriedade version.unversioned do serviço.

4. Subir PR para a equipe de DevOps

infrastructure-setup-dev

1. Localizar compose do serviço

2. Alterar as propriedades image e container_name, alterando a versão para ‘{{ version_without_build }}’

   <service-name>:
     image: "korp/<service-name>:{{ version_without_build }}.x{{ docker_image_suffix }}"
     container_name: "<service-name>-{{ version_without_build }}"
     restart: on-failure:10
     extra_hosts: *default-extra_hosts
     environment:
       - URL_GATEWAY={{ frontend.endpoints.gateway_url }}
       - URL_CDN={{ frontend.endpoints.cdn_url }}
       - URL_LOADER={{ frontend.endpoints.frontend_url }}
       - URL_CONSUL=http://consul-server:8500
       - CERT_FILE_PATH={{ self_signed_ca_cert_path }}
     networks:
       - servicos
     volumes:
       - "{{ self_signed_certs_directory }}/:{{ self_signed_certs_directory }}/"
   

3. No diretório vars da role, editar o arquivo main.yml, e remover a propriedade version.unversioned do serviço.

4. Subir PR para a equipe de DevOps

Repositório

Criar branches das releases liberas