GE - Como Fazer - Ferramenta de implantação de sites e aplicações web

Voltar

Como Fazer > Utilidades/Diversos > Ferramenta de implantação de sites e aplicações web

Script de Implantação

A ferramenta de implantação gerencia a execução do script de implantação, que é gerado automaticamente na pasta temporária do Windows com o nome "CGImplanta.bat", utilizando a codificação 1252.

🔄 Origem do Script

• Inicialmente, a ferramenta tenta baixar o script a partir de um serviço web hospedado na CIGAM Corporativa.
• Caso não haja conectividade, será utilizado o script incorporado no próprio instalador.
• Se a conexão for bem-sucedida, a ferramenta compara a versão do script remoto com a versão interna:

• Caso a versão interna seja mais recente, ela será utilizada;
• Em geral, o script hospedado estará sempre atualizado e será o utilizado normalmente.

Utilização da Ferramenta em Modo Console

A ferramenta de implantação pode ser executada em modo console, mas exclusivamente via Windows PowerShell (powershell.exe).

❌ A execução via Prompt de Comando (cmd.exe) não é suportada.

🔐 Elevação de Permissão

A execução deve ser feita como administrador.

Se não estiver com privilégios elevados, a ferramenta solicitará reabertura com os mesmos parâmetros informados.

📝 Uso sem Parâmetros

Se a ferramenta for executada sem parâmetros, será exibida uma lista de opções disponíveis, permitindo ao usuário conhecer os comandos que o script aceita.

Utilização da Ferramenta em Modo Interativo

A ferramenta também pode ser executada em modo tela interativa quando iniciada diretamente no ambiente Windows.

🔐 Permissão de Administrador

A execução deve ser feita como administrador.

Caso não ocorra a elevação, a própria ferramenta solicitará reabertura com os privilégios necessários.

📁 Diretório de Instalação

Por padrão, os sites e aplicações são implantados abaixo da pasta padrão, em:

%SYSTEMDRIVE%\inetpub\wwwroot

Esse caminho pode ser personalizado criando um atalho para a ferramenta com o parâmetro:

/p:<caminho da pasta>

✅ Certifique-se de que o diretório informado possua as permissões de acesso e segurança adequadas para execução e gravação pelo IIS.

🚀 Interface Inicial

Ao abrir a ferramenta, será exibida uma lista de implantação, preenchida com as aplicações detectadas na máquina conforme o padrão da instalação.

▶️ Criar novo site/aplicação

Use o botão “Novo site/aplicação” para adicionar um item à lista.

Também é possível editar um item existente clicando no botão “#” correspondente.

🛡️ Recomendação: Use porta HTTPS para maior segurança.

Após a implantação, é necessário configurar o certificado no IIS para o domínio/porta definidos.

⚠️ Certifique-se de que todos os portais utilizem o mesmo protocolo (HTTP/HTTPS) para evitar problemas de conteúdo misto nos navegadores (especialmente em portais React).

🔄 Atualização de Portais Existentes

Ao atualizar portais já implantados, mantenha marcada a opção:

“Manter as configurações do arquivo Web.config caso o site ou aplicação já existe”.

Isso garante que as configurações existentes no Web.config ou definidas no IIS (em “Configurações do Aplicativo”) não sejam sobrescritas.

🔐 Conexão com Banco de Dados Criptografada

Para utilizar conexões criptografadas nos portais e na API CIGAM, é necessário:

1. Executar a ferramenta %CIGAM_INSTAL%CGConnectionString.exe.
2. Seguir o guia "Como Fazer - CGConnectionString".
3. Selecionar o tipo de conexão: Nativa (recomendado).
4. Após gerar e encriptar a string, copiar o conteúdo gerado.
5. Colar no campo "String de conexão" da aplicação.

⚙️ Funcionalidades Adicionais

Ação	Botão / Opção
Excluir item da lista de implantação	Botão X no item
Implantar os itens selecionados	Botão “Implantar selecionados”
Visualizar log de execução	Botão ... no item
Abrir configurações no IIS	Botão específico na barra de ferramentas
Salvar/Carregar lista de implantação (XML)	Opções na barra de ferramentas

• 

  Implantar os itens selecionados (tela de processamento da implantação)

• 

  Tela Log da implantação

• 

  Exibição de Recursos

Voltar ao início

Certificado de Autenticidade da Ferramenta

Em situações onde é necessário validar a autenticidade do aplicativo para permitir a execução como administrador, deve-se instalar o certificado “CGImplanta.pfx”, que acompanha o instalador.

🛠️ Etapas de Instalação:

• Instale o certificado no repositório:

“Autoridades de Certificação Raiz Confiáveis” do usuário no Windows.

✅ Resultado Esperado:

• Após a instalação, o sistema deverá reconhecer o aplicativo como válido e confiável, permitindo sua execução com privilégios elevados sem exibir alertas de origem desconhecida.

📸 A seguir, são apresentados exemplos comparativos do comportamento antes e depois da instalação do certificado, tanto nas propriedades do arquivo quanto na tela de controle de conta de usuário (UAC) do Windows.

• 

  Antes

• 

  Depois

Configurações Adicionais das Aplicações no IIS

A depender da aplicação instalada, algumas configurações manuais devem ser realizadas no IIS, como chave de criptografia, mapeamento de rede, limites de upload/download e tempo de requisição. Essas definições são feitas via editor de configurações ou filtragem de solicitações.

🔗 Para mais detalhes, consulte: GE - Como Fazer - Configurações Adicionais das Aplicações no IIS

Configuração dos Portais no IIS

Os portais devem ser instalados como aplicações web no IIS, utilizando pacotes “.zip”. Algumas configurações manuais são necessárias conforme o tipo de portal, como definição de diretório virtual, limite de visualização de documentos e navegação via menu mosaico.

🔗 Para mais detalhes, consulte: GE - Como Fazer - Configuração dos Portais no IIS

Parametrização dos Portais no CIGAM Desktop

Além da configuração no IIS, algumas parametrizações adicionais podem ser realizadas manualmente no CIGAM Desktop, conforme os portais instalados.

➡️ Para isso, é necessário revisar as orientações sobre a implementação dos portais no CIGAM Desktop.

📄 Referência: GE - Como Fazer - Implementação Portais Web

Voltar ao início

Configuração do Magic Broker no IIS

A aplicação Magic Broker é responsável por intermediar a comunicação com o Magic Enterprise Server. Ela deve ser instalada como uma aplicação web no IIS, utilizando o pacote compactado “Broker.zip”.

Orientações de Configuração:

• Na implantação, informe o endereço desta aplicação no campo “Endereço do servidor de aplicação Magic”.
• A biblioteca “MGrqispi.dll” deve ser configurada e ativada para funcionamento com o protocolo ISAPI.
• Para completar a comunicação, edite o arquivo “mgreq.ini”, localizado na raiz da aplicação web, configurando:

• MessagingServer: informe o endereço e a porta do servidor no formato: SERVIDOR/PORTA

Exemplo: 192.168.0.100/1234

• DefError: defina como: XML

Observação:

• Após a instalação e configuração, o Magic Broker estará apto para colocar a aplicação Magic em estado de espera para requisições.

🔗 Para mais detalhes sobre as parametrizações avançadas, consulte: GE - Como Fazer - Configuração de aplicação com Broker

Configuração do Agendador de Tarefas no IIS

O Agendador de Tarefas deve ser instalado como uma aplicação web no IIS, utilizando o pacote compactado “CGScheduler.zip”.

Orientações importantes:

• Durante a implantação, configure a identidade do Pool de Aplicativos como LocalService.
• A instalação deve ser realizada no mesmo ambiente onde o Agendador de Tarefas será executado.
• É fundamental garantir que todas as dependências e permissões necessárias estejam corretamente configuradas.

🔗 Para mais detalhes sobre as parametrizações necessárias para a execução das tarefas, consulte: GE - Como Fazer - Integração com o Agendador de Tarefas do Windows.

Configuração da Aplicação React no IIS

A aplicação React deve ser instalada como um site exclusivo no IIS, utilizando o módulo URL Rewrite. Após a instalação, é necessário configurar o arquivo config.json localizado na pasta static, ajustando parâmetros como DEFAULT_PORTAL e DEFAULT_LOGIN.

🔗 Para mais detalhes, consulte: GE - Como Fazer - Configuração da Aplicação React no IIS

Voltar ao início

Configuração da API no IIS

A aplicação API deve ser implantada como aplicação web no IIS, utilizando o pacote compactado “API.zip”.

Configurações importantes:

• Banco de Dados:

Ao configurar o campo “Banco de dados” na implantação:

• Para Microsoft SQL Server (MSSQL), selecione: System.Data.SqlClient
• Para Oracle, selecione: Oracle.ManagedDataAccess.Client

• String de Conexão - Oracle:

É obrigatório utilizar o IP do servidor de banco de dados na string de conexão, devido à arquitetura da API que utiliza Entity Framework.

Exemplo de string de conexão:

  Data Source=192.168.0.101:1521/orcl;User ID=CIGAM;Password=CIGAM;Persist Security Info=True;

Configuração da CDN no IIS

A configuração da CDN no IIS consiste na instalação da aplicação web a partir do pacote “CDN.zip” e definição de parâmetros essenciais para o funcionamento correto da entrega de arquivos, como a pasta base de conteúdo compartilhado (CONTENT_SHARE), permissões de acesso, controle de conteúdo externo, tokens públicos de acesso e chaves de validação. Essas configurações permitem que arquivos sejam acessados e gerenciados de forma segura e integrada pelas aplicações do CIGAM, com suporte a uploads, downloads e exclusões.

🔗 Para mais detalhes, consulte: GE - Como Fazer - Configuração da CDN no IIS

Configuração do APM no IIS

A aplicação APM deve ser instalada como uma aplicação web no IIS utilizando o pacote compactado “CGAPM.zip”. Durante a implantação, os serviços de monitoramento do APM são configurados e iniciados automaticamente na mesma máquina que executa o IIS.

Na raiz da aplicação, a pasta “services” contém o conjunto de ferramentas responsáveis pela coleta e exibição das informações do APM - incluindo Grafana, Prometheus, Promtail e Loki. Caso essa pasta não exista, ela será criada com a configuração padrão durante a instalação.

Após a implantação, é necessário realizar configurações adicionais manualmente no IIS, especialmente para habilitar o acesso da aplicação e garantir sua integração com os sistemas front-end.

Parâmetros obrigatórios:

• Acesso público da aplicação

Permite que terceiros acessem o APM sem autenticação. Deve conter ao menos 15 caracteres, entre letras e números, sem caracteres especiais.

Parâmetro: PUBLIC_TOKEN

🔹 Exemplo: a98x48djuh58vj38dhfg3

• Chave de cálculo para acesso

Utilizada na validação de acesso pela aplicação. Deve ser única por cliente ou instalação, com até 3 caracteres.

Parâmetro: KEY_TOKEN

🔹 Exemplo: 1

⚠️ Esses valores devem estar pareados nas aplicações de Front-end para garantir a comunicação correta com o APM.

🔗 Para mais detalhes sobre as parametrizações e funcionalidades de monitoramento, consulte: GE - Como Fazer - Configuração do CIGAM APM.

Voltar ao início

Configuração do BI no IIS

A aplicação BI deve ser instalada como uma aplicação web no IIS utilizando o pacote compactado “BI.zip”.

Após a implantação, é necessário realizar configurações adicionais manualmente no IIS, especialmente relacionadas ao arquivo de parametrização da aplicação.

⚙️ Caminho do arquivo de configurações e licenciamento:
A aplicação depende do arquivo config.xml, responsável por armazenar as configurações e informações de licenciamento. É possível informar esse caminho de duas formas:

• Local padrão (sem caminho especificado):

O arquivo config.xml será mantido na própria pasta de instalação da aplicação. Neste caso, é necessário recuperá-lo da cópia de segurança feita durante a atualização.

• Caminho completo externo:

Permite indicar um diretório externo ao da instalação, dispensando a utilização do arquivo padrão.

🔑 Chave de configuração no IIS:

ArquivoConfig

🔹 Exemplo: config.xml

🔗 Para informações detalhadas sobre a parametrização e a geração do arquivo de configuração, consulte o documento: Instalação BI WEB.

Conferência manual das instalações no IIS

Havendo alguma necessidade é possível checar as configurações das aplicações implantadas conforme a ferramenta de implantação, pois estas seguem algumas regras básicas.

🔗 Para mais detalhes, consulte: GE - Como Fazer - Conferência manual das instalações no IIS

Voltar ao início