Skip to content

Guia de Pré-requisitos, Instalação e Configuração do App Builder On-Premises

Pré-requisitos

Esta seção lista os pré-requisitos para instalar a versão On-premises do App Builder e é destinada a Administradores de Sistema que configuram parâmetros operacionais que mantêm e suportam Linux/Mac OS/Windows.

Gerenciamento de Banco de Dados

Com base em seus requisitos, você pode decidir usar MySQL, MSSQL Server ou PostgreSQL como sistemas de gerenciamento de banco de dados.

Instalação MySQL

1 - Instale a edição community do MySQL (link direto para windows)

  • Selecione:

    • Developer default, Next e Execute.

    Nota: se você receber um prompt dizendo “um ou mais requisitos de produtos não foram satisfeitos. Você quer continuar?” Apenas selecione Sim)

  • Após a instalação terminar:

    • Selecione next para configurar o servidor, quando solicitado, digite a senha raiz que desejar, então Execute.
    • Após a configuração do servidor terminar, selecione Cancel para sair do instalador, pois o resto da configuração não é necessário.

2 - Permita a conexão do container ao MySQL.

Conecte-se ao MySQL com o usuário raiz e a senha da etapa 1 e execute o seguinte script sql (nome de usuário e senha serão os usados pelo AppBuilder).

Nota: você pode usar a ferramenta MySQL Workbench para executar scripts sql.

CREATE USER 'username'@'%' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON *.* TO 'username'@'%' WITH GRANT OPTION;

Instalação do MSSQL Server

1 - Instale o Sql Server (link direto)

Instalação do Sql Express On-Premises

Nota: um servidor On-premises deve ter um Sql Server real, não um Sql Server Express incorporado do VS

2 - Habilite tcp/ip - explicação detalhada aqui.

Gerenciador de Configuração do SqlServer

3 - Adicione um novo usuário App_Builder parte do Sql Express. Você pode instalar Sql Server Management Studio e usá-lo para esse propósito.

Diálogo de Parâmetros de Login

Nota: Permissões de criar banco de dados podem ser negadas para o usuário recém-adicionado. Você deve considerar dar a ele um Server Roles que lhe dará credenciais para criar banco de dados como dbcreator.

Nota: Com base na decisão do administrador, uma mudança de modo de autenticação com SSMS pode ser necessária. O SQL Server Database Engine está definido como modo de Autenticação do Windows ou modo de Autenticação do SQL Server e do Windows.

Instalar Docker

Guia do Windows -> guia docs.microsoft.com

Instalação

Esta seção assume que você já tem Docker e um banco de dados (MySQL, MSSQL Server ou PostgreSQL) instalados.

Instalação pela Primeira Vez

1 - Baixe o appbuilder.zip que faz parte de sua seção de Download no Portal de Clientes Infragistics.
2 - Extraia o appbuilder.tar contido no arquivo appbuilder.zip.
3 - Abra uma janela de terminal ou prompt de comando no local extraído.
4 - Carregue e verifique a imagem.

Execute:

docker load --input appbuilder.tar

Para verificar se a imagem foi carregada corretamente, veja o exemplo com a tabela abaixo:

docker images
REPOSITORYTAGIMAGE IDCREATEDSIZE
appbuilder1.02a05977e039b12 days ago854MB

5 - Execute o container:

docker run --restart always -p 80:5000 -e "ConnectionStrings:AppBuilderMySqlConnection=server=<your-mysql-database-ip>;database=<your-mysql-schema>;user=<your-mysql-database-user>;password=<your-mysql-database-password>;oldguids=false" -v <external-folder-for-logs>:/appbuilder/logs -v <external-folder-for-storage>:/appbuilder/storage --name appbuilder appbuilder:1.0
  • Exemplo de MySQL - Este seria o comando assumindo que sua instância MySql está executando um schema chamado IndigoAppBuilderOnPrem em 192.168.2.5 com username=appbuilder e password=appbuilder e que você selecionou C:/AppBuilder como a pasta externa para armazenar os logs e armazenamento.
docker run --restart always -p 80:5000 -e "ConnectionStrings:AppBuilderMySqlConnection=server=192.168.2.5;database=IndigoAppBuilderOnPrem;user=appbuilder;password=appbuilder;oldguids=false" -v C:/AppBuilder/logs:/appbuilder/logs -v C:/AppBuilder/storage:/appbuilder/storage --name appbuilder appbuilder:1.0
  • Exemplo de MSSQL Server - Este seria o comando assumindo que sua instância Sql Server está executando um schema chamado IndigoAppBuilderOnPrem com servidor SQLEXPRESS, com USER ID=APP_BUILDER e password=Appbuilder2023! e que você selecionou C:/AppBuilder como a pasta externa para armazenar os logs e armazenamento.
docker run --restart always -p 80:5000 -e "ConnectionStrings:Provider=SqlServer" -e "ConnectionStrings:AppBuilderSqlServerConnection=Data Source=DEV-ZKOLEV\SQLEXPRESS,1433;Database=IndigoAppBuilderOnPrem;User ID=APP_BUILDER;Password=Appbuilder2023!;Connect Timeout=15;Encrypt=False;TrustServerCertificate=False;ApplicationIntent=ReadWrite;MultiSubnetFailover=False" -v C:/AppBuilder/logs:/appbuilder/logs -v C:/AppBuilder/storage:/appbuilder/storage --name appbuilder appbuilder:1.0

6 - Abra seu navegador e digite http://localhost/

Nota: Se você estiver usando Docker Desktop, vá para Containers/Apps, encontre seu container e clique em Open in browser

Docker Containers/Apps

Autenticação com OpenID Connect (OAuth 2.0)

Siga o tópico Autenticação On-Prem com OpenID Connect (OAuth 2.0) para mais informações.

Atualizações

1 - Siga os primeiros 4 passos da instalação pela primeira vez com o arquivo zip recém-publicado

2 - Verifique que a nova imagem foi carregada corretamente (a imagem antiga deve ser marcada como )

docker images
REPOSITORYTAGIMAGE IDCREATEDSIZE
appbuilder1.027ff4c1079ac43 hours ago932MB
2a05977e039b12 days ago854MB

3 - Pare o container

docker stop appbuilder

4 - Remova o container

docker rm appbuilder

5 - Execute o container com o mesmo comando usado na etapa 5 da instalação pela primeira vez

Ativação

Esta seção assume que você já instalou a instância On-premises e que ela agora está funcionando.

Quando o servidor é iniciado pela primeira vez, um diálogo de prompt fornecerá a você ID de Instalação e uma chave de Autenticação será solicitada. Envie este ID de Instalação ao nosso departamento de Vendas com base em sua região e forneceremos a você a chave de Autenticação para ativar o servidor.

Ativar App Builder

Nota: Você receberá uma mensagem de aviso diretamente através da interface do usuário trinta dias antes da sua chave expirar.

Visão Geral da Configuração

Configuração Padrão

Quando você inicia a imagem Docker do AppBuilder sem configuração personalizada, os seguintes recursos estão desabilitados por padrão:

  • Conexão do banco de dados - Nenhuma credencial de banco de dados fornecida (deve ser configurada via variáveis de ambiente ou arquivo de configuração)
  • Recursos de IA - Toda funcionalidade de IA desabilitada
  • Painel de Chat de IA - Interface de chat oculta
  • Notificações do Teams - Nenhuma integração de registro externo
  • Limitação de taxa - Nenhuma limitação de solicitações
  • Integração GitHub/Azure DevOps - Recursos de publicação desabilitados

Métodos de Configuração

Você tem duas opções para configurar o AppBuilder:

Opção 1: Variáveis de Ambiente (Quick Start)

Passe a configuração diretamente como variáveis de ambiente ao iniciar o container:

docker run --restart always -p 80:5000 \
  -v C:/appbuilder/config:/appbuilder/config \
  -v C:/appbuilder/logs:/appbuilder/logs \
  -v C:/appbuilder/storage:/appbuilder/storage \
  --name appbuilder \
  appbuilder:1.0

Estrutura de diretório necessária:

/appbuilder/config/
├── appsettings.json                    # Sobrescritas de configuração principal
└── ai/                                 # Configuração de IA (opcional)
    ├── ai.appsettings.json             # Configurações de provedor e modelo de IA
    ├── ai.providers.appsettings.json   # Configuração de endpoint do provedor
    └── ai.credentials.appsettings.json # Chaves de API e credenciais
    └── ai.models.appsettings.json      # Modelos de API disponíveis

Referência do Arquivo de Configuração

ArquivoPropósitoObrigatório
appsettings.jsonConfiguração backend principal - controla banco de dados, autenticação, registro, armazenamento e integrações
configs/ai/ai.appsettings.jsonConfigurações de recursos de IA - define qual provedor e modelos de IA usarApenas se IA habilitada
configs/ai/ai.credentials.appsettings.jsonChaves de API do provedor de IA - armazena credenciais de autenticação para serviços de IAApenas se IA habilitada
configs/ai/ai.providers.appsettings.jsonEndpoints do provedor de IA - configura URLs base da API (raramente precisa de mudanças)Apenas se IA habilitada
configs/ai/ai.models.appsettings.jsonModelos do provedor de IAApenas se IA habilitada

Nota: Se você não planeja habilitar recursos de IA, pode ignorar completamente os arquivos de configuração de IA.

Configuração Principal (appsettings.json)

Conexão de Banco de Dados

As configurações de conexão do banco de dados determinam onde o AppBuilder armazena todos os dados da aplicação, incluindo projetos do usuário, componentes, ativos e metadados.

{
  "ConnectionStrings": {
    "Provider": "MySql",
    "AppBuilderMySqlConnection": "server=host.docker.internal;port=3306;database=IndigoAppBuilder;user=root;password=yourpassword;oldguids=false",
    "AppBuilderSqlServerConnection": "Data Source=<server>;Database=<database>;User Id=<username>;Password=<password>;Encrypt=False;TrustServerCertificate=True;MultipleActiveResultSets=True",
    "AppBuilderPostgreSqlConnection": "Host=<hostname>;Port=5432;Database=<database>;Username=<username>;Password=<password>"
  }
}
OpçãoTipoDescrição
ProviderstringDetermina qual mecanismo de banco de dados usar. Valores válidos: “MySql”, “SqlServer”, “PostgreSql”. A aplicação só usará a string de conexão que corresponde a este valor de provedor.
AppBuilderMySqlConnectionstringString de conexão do MySQL/MariaDB. Usada quando Provider é “MySql”. O parâmetro oldguids=false é necessário para o tratamento correto de GUID. Use host.docker.internal para conectar a um banco de dados na máquina host do Docker, ou server=mysql para conectar a um banco de dados hospedado em um container Docker. Importante: Ao usar um banco de dados em container, inicie o container do AppBuilder com a opção --network (por exemplo, docker run --restart always -p 8080:5000 --network appbuilder-network)
AppBuilderSqlServerConnectionstringString de conexão do SQL Server. Usada quando Provider é “SqlServer”. MultipleActiveResultSets=True é obrigatório para que o Entity Framework Core funcione corretamente com o SQL Server.
AppBuilderPostgreSqlConnectionstringString de conexão do PostgreSQL. Usada quando Provider é “PostgreSql”. Formato padrão de string de conexão Npgsql.

Configuração de Registro

Controla como os registros da aplicação são gravados e gerenciados.

{
  "Logging": {
    "LogLevel": {
      "Default": "Debug",
      "System": "Warning",
      "Microsoft": "Warning"
    }
  },
  "CustomLogging": {
    "MinimumLevel": {
      "Default": "Information",
      "Override": {
        "Microsoft": "Warning",
        "System": "Warning",
        "Microsoft.EntityFrameworkCore": "Error"
      }
    },
    "Files": {
      "Paths": {
        "AI": "./logs/ai.log",
        "Backend": "./logs/backend.log",
        "DataProtection": "./logs/data-protection.log"
      },
      "RollingInterval": "Infinite",
      "FileSizeLimitBytes": 52428800,
      "RollOnFileSizeLimit": true,
      "FlushToDiskInterval": "00:00:01",
      "Retention": 90
    },
    "Teams": {
      "AIError": {
        "Enabled": false,
        "LogicAppUrl": "",
        "Period": "00:00:01",
        "TeamId": "",
        "ChannelId": ""
      },
      "DataProtection": {
        "Enabled": false,
        "Email": ""
      }
    }
  }
}

Notificações do Teams

OpçãoDescrição
Teams.AIError.EnabledQuando true, erros de IA são enviados a um canal do Microsoft Teams via webhook de Logic App.
Teams.AIError.LogicAppUrlURL do Azure Logic App que publica no Teams.
Teams.DataProtection.EnabledQuando true, alertas de proteção de dados são enviados por email.
Teams.DataProtection.EmailEndereço de email para alertas de proteção de dados.

Opções de Limitação de Taxa

Controla a limitação de taxa de solicitação para prevenir abuso.

{
  "IPRateLimiterOptions": {
    "Enabled": false,
    "PermitLimit": 500,
    "SegmentsPerWindow": 10,
    "WindowSeconds": 60,
    "QueueLimit": 0,
    "QueueProcessingOrder": "OldestFirst"
  },
  "UserRateLimiterOptions": {
    "Enabled": false,
    "PermitLimit": 1000,
    "SegmentsPerWindow": 6,
    "WindowSeconds": 60,
    "QueueLimit": 0,
    "QueueProcessingOrder": "OldestFirst"
  }
}
OpçãoTipoDescrição
EnabledbooleanSe a limitação de taxa está ativa. Defina como true para habilitar. Para redes internas/confiáveis, pode permanecer false.
PermitLimitintegerNúmero máximo de solicitações permitidas por janela. O limitador de IP padroniza para 500, o limitador de usuário para 1000.
SegmentsPerWindowintegerNúmero de segmentos em que a janela de tempo é dividida. Usado para algoritmo de janela deslizante. Valores mais altos = limitação mais suave.
WindowSecondsintegerTamanho da janela de tempo em segundos. As solicitações são contadas dentro desta janela contínua.
QueueLimitintegerNúmero de solicitações a enfileirar quando o limite é excedido. 0 significa rejeitar imediatamente. Valores mais altos enfileiram solicitações para processamento posterior.
QueueProcessingOrderstringOrdem de processar solicitações enfileiradas. "OldestFirst" (FIFO) ou "NewestFirst" (LIFO).

Limitador de Taxa IP: Limita solicitações por endereço IP. Protege contra atores ruins individuais.

Limitador de Taxa de Usuário: Limita solicitações por usuário autenticado. Protege contra abuso de usuários autenticados.

Integração GitHub

Habilita a publicação de projetos em repositórios GitHub.

Defina disablePublishToGithub: false em

{
  "FrontendOptions": {
    "Extras": "{ disablePublishToGithub: false, disableSurvey: true, disableAnalytics: true, disableFeedback: true, requiresActivation: true }"
  }
}
{
  "GithubOptions": {
    "Enabled": true,
    "BaseUrl": "https://github.com/",
    "AuthorizeClientEndpoint": "/login/oauth/authorize",
    "AccessTokenEndpoint": "/login/oauth/access_token",
    "Scope": "user repo workflow",
    "RedirectUri": "/oauth/github/auth-callback",
    "ClientId": "<your-github-oauth-app-client-id>",
    "ClientSecret": "<your-github-oauth-app-client-secret>",
    "PackageAccessTokenSuffix": ""
  }
}
OpçãoTipoDescrição
BaseUrlstringURL base do GitHub. Use "https://github.com/" para github.com ou sua URL do GitHub Enterprise.
AuthorizeClientEndpointstringCaminho do endpoint de autorização OAuth. Valor padrão, não altere a menos que esteja usando GitHub Enterprise personalizado.
AccessTokenEndpointstringCaminho do endpoint de token OAuth. Valor padrão, não altere.
ScopestringEscopos OAuth a solicitar. "user repo workflow" permite ler informações do usuário, acessar repositórios e acionadores de fluxos de trabalho.
RedirectUristringCaminho de callback OAuth. Isso deve corresponder ao que está configurado nas configurações do seu aplicativo OAuth do GitHub.
ClientIdstringID do Cliente do Aplicativo OAuth do GitHub. Crie um aplicativo OAuth em GitHub > Settings > Developer settings > OAuth Apps.
ClientSecretstringSegredo do Cliente do Aplicativo OAuth do GitHub. Mantenha este segredo!

Etapas de Configuração:

  1. Vá para GitHub > Settings > Developer settings > OAuth Apps > New OAuth App
  2. Defina Homepage URL para sua URL do AppBuilder
  3. Defina Authorization callback URL para https://your-appbuilder-url/oauth/github/auth-callback
  4. Copie Client ID e Client Secret para configuração
  5. Reinicie o container para incluir as mudanças docker run --restart always -p 8080:5000 --network appbuilder-network -v C:/appbuilder/config:/appbuilder/config --name appbuilder -d appbuilder:2.0

Integração Azure DevOps

Habilita a publicação de projetos em repositórios Azure DevOps.

Defina disablePublishToDevOps: false em

{
  "FrontendOptions": {
    "Extras": "{ disablePublishToDevOps: false, disableSurvey: true, disableAnalytics: true, disableFeedback: true, requiresActivation: true }"
  }
}
{
  "DevOpsOptions": {
    "Enabled": true,
    "TokenEncryptionKeyBase64": "<generate-a-random-16-byte-base64-key>",
    "BaseUrl": "https://login.microsoftonline.com/",
    "TenantId": "common",
    "AuthorizeClientEndpoint": "oauth2/v2.0/authorize",
    "RedirectUri": "/oauth/devops/auth-callback",
    "AccessTokenEndpoint": "oauth2/v2.0/token",
    "RevokeTokenEndpoint": "https://graph.microsoft.com/v1.0/users/{userObjectId}/revokeSignInSessions",
    "Scopes": "499b84ac-1321-427f-aa17-267ca6975798/user_impersonation offline_access openid profile user.read",
    "ClientId": "<your-azure-ad-app-client-id>",
    "ClientSecret": "<your-azure-ad-app-client-secret>",
    "RestApiVersion": "7.1",
    "ExcludedOrganizations": []
  }
}
OpçãoTipoDescrição
TokenEncryptionKeyBase64stringChave para criptografar tokens OAuth armazenados. Gere com openssl rand -base64 16.
BaseUrlstringURL de login do Azure AD. Valor padrão para plataforma de identidade Microsoft.
TenantIdstringTenant do Azure AD. Use "common" para permitir qualquer conta Microsoft, ou especifique seu ID de tenant para um único tenant.
ScopesstringEscopos OAuth para Azure DevOps. O GUID é o ID de recurso do Azure DevOps. Não modifique a menos que saiba o que está fazendo.
ClientIdstringID do Cliente do Registro do Aplicativo do Azure AD.
ClientSecretstringSegredo do Cliente do Registro do Aplicativo do Azure AD.
RestApiVersionstringVersão da API REST do Azure DevOps. "7.1" é versão estável atual.
ExcludedOrganizationsarrayLista de organizações Azure DevOps a ocultar. Os usuários não verão estas orgs ao publicar.

Reinicie o container para incluir as mudanças docker run --restart always -p 8080:5000 --network appbuilder-network -v C:/appbuilder/config:/appbuilder/config --name appbuilder -d appbuilder:2.0

Configuração de Email

Habilita notificações por email (opcional).

{
  "EmailOptions": {
    "Smtp": {
      "Server": "smtp.your-server.com",
      "Port": "587",
      "User": "your-smtp-user",
      "Password": "your-smtp-password"
    }
  }
}
OpçãoTipoDescrição
ServerstringNome de host do servidor SMTP.
PortstringPorta do servidor SMTP. Valores comuns: "587" (TLS), "465" (SSL), "25" (não criptografado - não recomendado).
UserstringNome de usuário de autenticação SMTP.
PasswordstringSenha de autenticação SMTP.

Configuração de IA

Os recursos de IA são opcionais. Para habilitá-los, configure os arquivos em configs/ai/.

ai.appsettings.json

Controla qual provedor de IA e modelos são usados.

{
  "AIOptions": {
    "Provider": "OPENAI",
    "Model": "gpt-4.1-mini",
    "SupportsVision": true
  },
  "ImageGeneration": {
    "Provider": "OPENAI",
    "Model": "gpt-image-1"
  },
  "GoogleCloudTranscribe": {
    "Enabled": false,
    "Credentials": "GoogleCloud",
    "Model": "latest_long",
    "DefaultLanguageCode": "en-US"
  }
}
OpçãoTipoDescrição
AIOptions.ProviderstringProvedor de geração de texto. Valores: "OPENAI", "ANTHROPIC", "GOOGLECLOUD", "GROQ"
AIOptions.ModelstringID do modelo de geração de texto. Deve ser um modelo válido para o provedor selecionado (veja tabela abaixo).
AIOptions.SupportsVisionbooleanSe o modelo pode analisar imagens. Habilite para modelos com capacidades de visão.
ImageGeneration.ProviderstringProvedor de geração de imagem. Valores: "OPENAI", "GOOGLECLOUD", "RUNWARE"
ImageGeneration.ModelstringID do modelo de geração de imagem.
GoogleCloudTranscribe.EnabledbooleanHabilitar fala-para-texto. Requer credenciais do Google Cloud.
GoogleCloudTranscribe.DefaultLanguageCodestringIdioma padrão para reconhecimento de fala. Por exemplo, "en-US", "de-DE", "fr-FR".

Modelos Disponíveis:

ProvedorModelos de TextoModelos de Imagem
OpenAIgpt-5.2, gpt-5.1, gpt-5-mini, gpt-5-nano, gpt-4.1, gpt-4.1-mini, gpt-4.1-nanogpt-image-1
Anthropicclaude-sonnet-4-5-20250929, claude-haiku-4-5-20251001-
Google Cloudgemini-2.5-pro, gemini-2.5-flash, gemini-3-pro-previewimagen-4.0-generate-001, imagen-4.0-ultra-generate-001, imagen-4.0-fast-generate-001
Groqllama-3.3-70b-versatile, llama-3.1-8b-instant-
Runware-runware:100@1, runware:101@1

ai.credentials.appsettings.json

Armazena chaves de API para provedores de IA.

{
  "AICredentialsOptions": {
    "OpenAI": {
      "ApiKey": "<your-openai-api-key>"
    },
    "Anthropic": {
      "ApiKey": "<your-anthropic-api-key>"
    },
    "Groq": {
      "ApiKey": "<your-groq-api-key>"
    },
    "Runware": {
      "ApiKey": "<your-runware-api-key>"
    },
    "GoogleCloud": {
      "JsonCredentials": {
        "type": "service_account",
        "project_id": "your-project-id",
        "private_key_id": "...",
        "private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
        "client_email": "...",
        "client_id": "...",
        "auth_uri": "https://accounts.google.com/o/oauth2/auth",
        "token_uri": "https://oauth2.googleapis.com/token"
      }
    }
  }
}

Configure apenas os provedores que você planeja usar. Obtenha chaves de API de:

Configurações de Ambiente Frontend

Essas configurações são passadas para a aplicação frontend e controlam recursos e comportamento da interface do usuário.

{
  "FrontendOptions": {
    "Extras": "{ disableSurvey: true, disableAnalytics: true, disableFeedback: true, requiresActivation: true, disableAI: false, enableAIChat: true }"
  }
}

O campo Extras é uma string JSON contendo sinalizadores de configuração frontend:

ConfiguraçãoPadrão (On-Prem)Descrição
disableAItrueInterruptor mestre para recursos de IA. Quando true, toda interface do usuário relacionada a IA fica oculta e APIs de IA não são chamadas.
enableAIChatfalseMostra painel de chat de IA na caixa de ferramentas. O painel permite aos usuários interagir com IA para gerar componentes e layouts.
enableSpeechToTextfalseMostra botão de microfone para entrada de voz no chat de IA. Requer que fala-para-texto do Google Cloud esteja configurado.

Como funciona: Esses valores são injetados no frontend em tempo de execução via API backend. O frontend lê esses sinalizadores na inicialização e habilita/desabilita recursos de acordo. Para que a funcionalidade de IA funcione, você deve fornecer as credenciais, modelos e configurações necessários nestes arquivos ai.appsettings.json, ai.credentials.appsettings.json, ai.providers.appsettings.json, ai.models.appsettings.json.

Instalação da Imagem Docker e Execução do Container

Montagens de Volume

Caminho do ContainerPropósitoObrigatório
/app/appsettings.jsonConfiguração principalSim
/app/configs/ai/Arquivos de configuração de IAApenas se IA habilitada
/app/storage/Armazenamento de arquivo (uploads, exportações)Sim (para persistência)
/app/logs/Arquivos de logRecomendado

Comandos de Execução Docker

Carregue a imagem

docker load -i appbuilder.tar

Execute o container fornecendo apenas uma variável de ambiente para conexão DB

docker run --restart always -p 80:5000 \
  -e "ConnectionStrings:AppBuilderSqlServerConnection=Data Source=<server>,<port>;Database=<db-name>;User ID=<user>;Password=<password>;Encrypt=False;TrustServerCertificate=False;MultipleActiveResultSets=True" \
  -v C:/appbuilder/logs:/appbuilder/logs \
  -v C:/appbuilder/storage:/appbuilder/storage \
  --name appbuilder \
  appbuilder:1.0

Execute o container quando configuração personalizada está montada -v C:/appbuilder/config:/appbuilder/config \

Se você quiser conectar a banco de dados executando em container docker separado: O arquivo appsettings define a string de conexão para : AppBuilderMySqlConnection": "Server=mysql;Port=3306;Database=AppBuilder;User=user;Password=password;, Crie rede docker e inclua o mysql. Forneça a rede no comando de inicialização.

docker run --restart always -p 80:5000 \
  --network appbuilder-network \
  -v C:/appbuilder/config:/appbuilder/config \
  -v C:/appbuilder/logs:/appbuilder/logs \
  -v C:/appbuilder/storage:/appbuilder/storage \
  --name appbuilder \
  appbuilder:1.0

Se você quiser conectar a banco de dados executando na PC do host para servidor use host.docker.internal: O arquivo appsettings define a string de conexão para : AppBuilderMySqlConnection": "server=host.docker.internal;Port=3306;Database=AppBuilder;User=user;Password=password;,

docker run --restart always -p 80:5000 \
  -v C:/appbuilder/config:/appbuilder/config \
  -v C:/appbuilder/logs:/appbuilder/logs \
  -v C:/appbuilder/storage:/appbuilder/storage \
  --name appbuilder \
  appbuilder:1.0

Lista de Verificação de Quick Start

Configuração Mínima

  1. Atualize ConnectionStrings em appsettings.json ou use a opção de sobrescrita de ambiente (sinalizador)

Com Autenticação

  1. Conclua configuração mínima
  2. Defina SkipAuth como false
  3. Configure provedor OAuth (Azure AD, Okta, Keycloak, etc.)
  4. Defina Authority, ClientId em AuthSettings

Com Recursos de IA

  1. Conclua configuração mínima
  2. Obtenha chave de API do seu provedor de IA escolhido
  3. Configure ai.appsettings.json com provedor e modelo
  4. Adicione chave de API a ai.credentials.appsettings.json
  5. Defina disableAI: false e enableAIChat: true no arquivo appsetting.json em FrontendOptions

Com Integração GitHub/DevOps

  1. Crie aplicativo OAuth (GitHub) ou Registro de Aplicativo (Azure AD)
  2. Configure URLs de callback no provedor
  3. Adicione ID do Cliente e Segredo à configuração

Solução de Problemas

Locais de Log

Arquivo de LogConteúdo
./logs/appbuilder.logSolicitações de API, autenticação, erros gerais relacionados
./logs/codegen.logSolicitações de API, autenticação, erros gerais relacionados
./logs/ai.logSolicitações e respostas do provedor de IA

Problemas Comuns

Falha de conexão do banco de dados

  • Verifique se o formato da string de conexão corresponde ao seu provedor
  • Verifique se servidor de banco de dados está acessível do container
  • Para Docker Desktop em Windows/Mac, use host.docker.internal em vez de localhost
  • Garanta que o usuário do banco de dados tem permissões para criar tabelas

Erros CORS no navegador

  • Adicione sua origem exata (incluindo protocolo e porta) a CorsPolicy.Origins
  • Verifique console do navegador para a origem real sendo bloqueada

Recursos de IA não funcionando

  • Verifique se disableAI: false no ambiente frontend
  • Verifique se chave de API é válida e tem créditos
  • Revise ai.log para mensagens de erro específicas
  • Garanta que nome do modelo corresponda exatamente aos modelos disponíveis

Uploads de arquivo falham

  • Verifique se diretório de armazenamento existe e é gravável
  • Verifique MaxImageSizeMb se carregando imagens grandes
  • Garanta que volume está montado corretamente no Docker

Autenticação não funciona

  • Verifique se SkipAuth é false
  • Verifique se URL Authority está acessível
  • Verifique se URLs de callback correspondem tanto em configuração como em provedor OAuth
  • Verifique console do navegador para erros OAuth

Docker Desktop em Windows

Docker Desktop em Windows não está iniciando automaticamente sem Login na máquina Windows Docker Desktop em Windows - O time Docker não recomenda Docker Desktop para cargas de trabalho de produção. Você deve usar Docker em uma caixa Linux ou Docker para Windows Server se quiser containers Windows.

Recursos Adicionais