Execute o Jitterbit App Builder no Docker

Introdução

Esta página mostra como executar App Builder como um Docker contêiner usando Jitterbit App Builder Imagem do Docker e um válido App Builder licença.

O App Builder A imagem do Docker tem suporte para estes bancos de dados:

Edições Standard ou Enterprise x64 do Microsoft SQL Server 2016 ou posterior. Isso deve ser configurado com sequência de collation SQL_Latin1_General_CP1_CI_AS e autenticação de modo misto.
MySQL 8.0 ou posterior.
PostgreSQL 14 ou posterior.

Importante

Enquanto você deve executar an App Builder instância e seu banco de dados separadamente em hosts que atendem App Builderrequisitos do sistema, por uma questão de simplicidade, essas instruções usam um hospedar para ambos.

Antes de começar, você deve ter um mecanismo Docker e Docker compose instalado e esteja ciente das limitações. Para o docker run exemplo, é necessário um banco de dados existente. O docker compose e adicional exemplos incluem um serviço que executa an App Builder banco de dados, então não requer um existente.

Etiquetas suportadas

As tags de imagem do Docker a página mostra quais tags estão disponíveis.

As tags são feitas de App Builder número da versão com um número de compilação opcional (por exemplo 4.0.{{ construir }}). Tags sem números de compilação (4.0) são as compilações mais recentes.

Para estabilidade, você deve usar tags com números de compilação e fixar seu App Builder instância para essa compilação. Para escolher uma, consulte as notas de versão.

Começar an App Builder Instância com `docker run`

Para começar an App Builder instância que se conecta a um banco de dados existente em execução no mesmo hospedar, siga estas etapas:

Crie um arquivo vinyl.env contendo as seguintes variáveis de ambiente, com valores substituídos conforme tabela abaixo:

ConnectionInfo__DatabaseType=<DB TYPE>
ConnectionInfo__HostName=<DB HOSTNAME>
ConnectionInfo__DatabaseName=<DB NAME>
ConnectionInfo__Port=<DB PORT>
ConnectionInfo__UserName=<DB USERNAME>
ConnectionInfo__Password=<DB PASSWORD>

Valor	Substituir por
`<DB TYPE>`	Um dos `SQLServer`, `MySQL`, ou `PostgreSql`.
`<DB HOSTNAME>`	Nome do host ou endereço IP do servidor de banco de dados.
`<DB PORT>`	(Opcional) Número da porta em que o serviço de banco de dados é executado. Padrão: `1433` (SQL Server), `3306` (MySQL), `5432` (PostgreSQL).
`<DB NAME>`	(Opcional) App Builder nome do banco de dados. Padrão: `App Builder`. Isso pode ser qualquer coisa, mas deve seguir as regras de nome do banco de dados.
`<DB USERNAME>`	App Builder nome de usuário do banco de dados.
`<DB PASSWORD>`	App Builder senha do usuário do banco de dados.

(Estas e outras variáveis de ambiente são descritas em Configurando App Builder na inicialização.)

Exemplo para PostgreSQL:

ConnectionInfo__DatabaseType=PostgreSql
ConnectionInfo__HostName=host.docker.internal
ConnectionInfo__DatabaseName=vinyl
ConnectionInfo__Port=5432
ConnectionInfo__UserName=postgres
ConnectionInfo__Password=postgres

Inicie o contêiner Docker:

docker run --publish "80:80" --env-file vinyl.env jitterbit/vinyl:3.3

Insira http://localhost na barra de endereço do seu navegador e aguarde o App Builder página de login:
(Opcional) Use seu navegador, curl, ou uma ferramenta de teste de API da web para fazer um GET solicitação no endpoint de verificação de integridade do contêiner http://localhost:80/ping. A resposta deve ser App Builder - OK - YYYY-mm-DDTHH:MM:SSZ, com a data e hora expressas no formato ISO 8601 UTC.
Faça login com estas credenciais:
- Nome de usuário: admin
- Senha: P@55w0rd (O padrão App Builder senha do administrador.)
Na página Senha expirada, altere a senha padrão e clique em Salvar senha:
Na página Senha alterada, clique em Continuar.
Na página Licença ativa, clique em Carregar:
Na página Upload de licença, clique em Navegue para abrir o navegador de arquivos do seu sistema. Encontre e abra seu App Builder arquivo de licença e clique em Salvar:
Na página Upload de licença, clique em Ativar:
Na página Licença Ativa, clique em Iniciar:
O App Builder página de boas-vindas abre:

Começar an App Builder Instância e banco de dados com `docker compose`

O exemplo a seguir usa o Docker Compose para iniciar an App Builder instância e um banco de dados Microsoft SQL Server (mais exemplos abaixo):

Em um diretório vazio, crie um arquivo docker-compose.yml contendo o seguinte:

version: "3"

services:
  db:
    image: mcr.microsoft.com/mssql/server
    hostname: vinyldb
    environment:
      MSSQL_SA_PASSWORD: P@55w0rd
      ACCEPT_EULA: Y
    volumes:
      - ./db_data:/var/opt/mssql/data

  vinyl:
    depends_on:
      - db
    image: jitterbit/vinyl:3.3
    ports:
      - 80:80
    volumes:
      - ./vinyl_data:/app/data
      - ./vinyl_logs:/app/logs
      - ./vinyl_keys:/app/keys
    environment:
      ConnectionInfo__DatabaseType: SQLServer
      ConnectionInfo__HostName: vinyldb
      ConnectionInfo__DatabaseName: App Builder
      ConnectionInfo__UserName: sa
      ConnectionInfo__Password: P@55w0rd

volumes:
  db_data:
  vinyl_data:
  vinyl_logs:
  vinyl_keys:

Inicie os serviços:
```
docker compose up -d
```
Verifique os arquivos de log em vinyl_logs, montado no App Builder diretório de logs /app/logs. (As outras montagens são /app/keys onde as chaves de criptografia são armazenadas e /app/data, o diretório de dados.)
Continue seguindo as etapas 3 a 12 da seção anterior.

Limitações

As seguintes limitações se aplicam a App Builder executando como um contêiner Docker e para qualquer instalação baseada em Linux:

O suporte para recursos do Windows varia dependendo do App Builder versão:

Aplicativo	Suportado em App Builder 3.3+	Suportado em App Builder 3.2
IBM DB2 para i
Plataforma Salesforce
Autenticação do Active Directory
Relatórios de Cristal
Representação do sistema de arquivos
Autenticação Integrada do Windows (IWA)
SAP ABAP
Plugins de terceiros

Os uploads de arquivos são limitados a 30.000.000 bytes (28,6 MB) por padrão. Isso é para ajudar a proteger contra ataques de negação de serviço (DoS).

Para aumentar esse limite, defina a variável de ambiente Kestrel__Limits__MaxRequestBodySize para o tamanho máximo de arquivo desejado em bytes.

Adicional `docker compose` Exemplos

Exemplo docker-compose.yml para App Builder usando MySQL como banco de dados de backend:

version: '3.0'

services:
  db:
    image: mysql
    hostname: vinyldb
    environment:
      MYSQL_ROOT_PASSWORD: P@55w0rd
    volumes:
      - db_data:/var/lib/mysql

  vinyl:
    depends_on:
      - db
    image: jitterbit/vinyl:3.3
    ports:
      - 80:80
    volumes:
      - ./vinyl_data:/app/data
      - ./vinyl_logs:/app/log
      - ./vinyl_keys:/app/keys
    environment:
      ConnectionInfo__DatabaseType: MySQL
      ConnectionInfo__HostName: vinyldb
      ConnectionInfo__UserName: root
      ConnectionInfo__Password: P@55w0rd

volumes:
  db_data:
  vinyl_data:
  vinyl_logs:
  vinyl_keys:

Exemplo docker-compose.yml para App Builder usando PostgreSQL como banco de dados de backend:

version: "3"

services:
  db:
    image: postgres
    hostname: vinyldb
    environment:
      POSTGRES_PASSWORD: postgres
    volumes:
      - db_data: /var/lib/postgresql/data

  vinyl:
    depends_on:
      - db
    image: jitterbit/vinyl:3.3
    ports:
      - 80:80
    volumes:
      - ./vinyl_data:/app/data
      - ./vinyl_logs:/app/logs
      - ./vinyl_keys:/app/keys
    environment:
      ConnectionInfo__DatabaseType: PostgreSql
      ConnectionInfo__HostName: vinyldb
      ConnectionInfo__UserName: postgres
      ConnectionInfo__Password: postgres

volumes:
  db_data:
  vinyl_data:
  vinyl_logs:
  vinyl_keys: