> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Melhores Práticas de SDLC On-Premise

> Melhores Práticas de SDLC e Promoção de EKB de Não-Produção para Produção (On-Premise)

Este artigo define as melhores práticas recomendadas para:

* Promover a plataforma EKB (aplicação) de **Não-Produção para Produção**
* Promover **projetos e casos de uso de IA do EKB** de Não-Produção para Produção
* Definir claramente **funções e responsabilidades** para cada atividade de promoção, incluindo atualizações, testes, configuração e aprovação

A abordagem é projetada para **ambientes On-Premise** e está alinhada com **padrões comuns de SDLC, segurança e governança operacional**. Esta abordagem:

* Define claramente **funções e responsabilidades durante a promoção**
* Considera **atualizações de configuração específicas por ambiente**
* Alinha-se com **modelos On-Premise de SDLC e segurança corporativos**
* Mantém **controle de acesso rigoroso à Produção**
* Permite **promoções repetíveis e auditáveis**

***

## Modelo de Ambiente (On-Premise)

Sua equipe mantém **ambientes On-Premise separados de Não-Produção e Produção** para o EKB. Esses ambientes são:

* Logicamente e fisicamente isolados
* Promovidos por meio de **processos manuais controlados**

Tanto as **atualizações da plataforma** quanto as **promoções de projetos** são governadas sob um único framework de SDLC.

***

## Fases do SDLC e Visão Geral da Promoção

### Fase 1 – Design e Construção (Não-Prod)

* Os casos de uso são projetados e configurados no **EKB Não-Prod**
* Prompts, fluxos de trabalho e integrações são iterados e ajustados
* Dados de teste são utilizados quando possível

**Responsável:** Equipe de Negócios / Especialistas\
**Suporte:** EKB (AA)

### Fase 2 – Testes e Validação (Não-Prod)

* Testes funcionais e UAT
* Validação de precisão, desempenho e segurança
* Aprovação do negócio confirmando prontidão para promoção

**Responsável:** Equipe de Negócios / Especialistas

### Fase 3 – Prontidão para Promoção

Antes de qualquer promoção:

* Aprovações de alteração são obtidas
* Requisitos de firewall e rede são revisados
* Acesso à Produção e abordagem RBAC são confirmados
* Valores de configuração específicos por ambiente são identificados

***

## Mecanismos de Promoção

### Promoção de Plataforma (Ambiente)

A promoção da plataforma inclui:

* Atualizações de versão do EKB
* Patches de segurança
* Alterações de configuração em nível de plataforma

#### Fluxo de Alto Nível

1. Atualização aplicada no **Não-Prod**
2. Testes e validação da plataforma
3. Aprovação e agendamento da alteração
4. Implantação na **Produção**
5. Validação pós-implantação

### Promoção de Projeto / Caso de Uso

O EKB suporta promoção por meio de um **mecanismo de exportação/importação de projetos** entre ambientes On-Premise.

#### Incluído na Promoção

* Configuração do projeto
* Fluxos de trabalho e agentes
* Prompts e regras

#### Excluído da Promoção

* Usuários e atribuições de funções
* Segredos específicos do ambiente
* Configurações de rede e firewall

Isso garante que o **acesso à Produção permaneça explicitamente controlado**.

#### Fluxo de Alto Nível

1. Projeto finalizado no Não-Prod
2. Exportação do Não-Prod
3. Importação na Produção
4. Atualizações de configuração específicas por ambiente
5. Configuração de produção e setup de acesso
6. Testes de fumaça e go-live

***

## Funções e Responsabilidades para Atividades de Promoção

Esta seção define quem realiza cada atividade envolvida na promoção de atualizações e configurações de **Não-Prod para Prod**.

### Responsabilidades de Promoção de Plataforma (Ambiente)

| Atividade                                  | Equipe de Negócios | Equipe de Run / Middleware | EKB (AA) |
| ------------------------------------------ | ------------------ | -------------------------- | -------- |
| Planejar atualização da plataforma         | I                  | C                          | R        |
| Aplicar atualização no Não-Prod            | I                  | I                          | R        |
| Executar testes de regressão da plataforma | I                  | C                          | R        |
| Revisar resultados dos testes              | I                  | C                          | R        |
| Aprovação e agendamento da alteração       | I                  | R                          | C        |
| Implantar atualização na Produção          | I                  | C                          | R        |
| Validação pós-implantação                  | I                  | C                          | R        |

#### Ponto-Chave

**EKB (AA)** é responsável por executar atualizações da plataforma e rodar testes em nível de plataforma.\
**Equipes de Run / Middleware** controlam aprovações, agendamento e prontidão de infraestrutura.

### Responsabilidades de Promoção de Projeto / Caso de Uso

| Atividade                                       | Equipe de Negócios | Equipe de Run / Middleware | EKB (AA) |
| ----------------------------------------------- | ------------------ | -------------------------- | -------- |
| Desenvolver e configurar caso de uso (Não-Prod) | R                  | I                          | C        |
| Testes funcionais e UAT                         | R                  | I                          | C        |
| Confirmar prontidão para promoção               | R                  | I                          | I        |
| Exportar projeto do Não-Prod                    | I                  | I                          | R        |
| Importar projeto na Produção                    | I                  | C                          | R        |
| Testes de fumaça na Produção                    | R                  | C                          | C        |
| Aprovação para go-live                          | R                  | I                          | I        |

#### Ponto-Chave

**As partes interessadas de negócios da sua equipe são responsáveis pela validação e aprovação**, enquanto o **EKB (AA)** executa as etapas técnicas de promoção.

### Configuração Pós-Promoção (Produção)

Essas atividades ocorrem **após a importação** para manter os controles de Produção.

| Atividade                  | Equipe de Negócios | Equipe de Run / Middleware | EKB (AA) |
| -------------------------- | ------------------ | -------------------------- | -------- |
| Criar usuários de Produção | I                  | R                          | I        |
| Atribuir RBAC              | I                  | R                          | C        |
| Configurar firewall / rede | I                  | R                          | C        |
| Validar integrações        | R                  | C                          | C        |

***

## Atualizações de Configuração Específicas por Ambiente (Necessárias Durante a Promoção)

Quando um projeto é promovido de **Não-Produção para Produção**, certos valores de configuração devem ser atualizados para refletir o ambiente de Produção. Esses valores **não são transferidos automaticamente** e devem ser revisados durante a promoção.

### Atualizações de Configuração RPA (Se Aplicável)

Para casos de uso que se integram com **ferramentas RPA**, os seguintes valores normalmente precisam ser atualizados na Produção:

* URL do Control Room
* Nome de usuário
* Token v2 do Usuário

Esses valores devem fazer referência à **infraestrutura e credenciais RPA de Produção**.

### Atualizações de Configuração do EKB

Dentro do EKB, os seguintes **valores específicos por ambiente** devem ser revisados e atualizados após a promoção:

* **URL Base**
  * Exemplo:
    * Não-Prod: `https://nonprod.example.com`
    * Prod: `https://prod.example.com`

* **ID do Projeto**

* **xApiKey do Projeto**

* **xApiSecret do Projeto**

* **ID(s) da Tabela Inteligente**

Esses valores são **únicos por ambiente** e são necessários para o funcionamento correto em runtime na Produção.

### Responsabilidade pelas Atualizações de Configuração

| Atividade                                          | Equipe de Negócios | Equipe de Run / Middleware | EKB (AA) |
| -------------------------------------------------- | ------------------ | -------------------------- | -------- |
| Identificar alterações de configuração necessárias | C                  | C                          | R        |
| Atualizar variáveis de Produção RPA                | I                  | R                          | C        |
| Atualizar variáveis de Produção do EKB             | I                  | C                          | R        |
| Validar alterações de configuração                 | R                  | C                          | C        |

***

## Modelo Operacional de Produção

### Sua Equipe

* Detém as **operações de Produção**
* Gerencia **usuários, RBAC e monitoramento**
* Fornece **resposta a incidentes de primeira linha**

### EKB (AA)

* Detém a **estabilidade e correções da plataforma**
* Fornece **atualizações e patches da plataforma**
* Suporta **problemas complexos de configuração**

O EKB **não atua como a equipe operacional de Produção**.

***

## Gestão de Alterações e Governança

* Todas as alterações em Produção seguem **processos formais de gestão de alterações**
* **Não-Prod é o único ambiente para experimentação**
* Correções de emergência seguem **aprovações simplificadas**

Cada caso de uso de Produção deve ter:

* Proprietário de negócio
* Escopo definido
* Contatos de suporte
* Plano de reversão