Ir para o conteúdo

Atualizar para Jitterbit App Builder 4.x do Vinyl 3.3 no Docker

Introdução

Esta página mostra como atualizar uma instância Docker Vinyl 3.3 para uma instância Docker App Builder 4.x.

Dica

Para orientações sobre planejamento de uma atualização em ambientes de desenvolvimento, QA e produção, incluindo janelas de manutenção e estratégia de reversão, consulte Estratégias de atualização em produção.

Pré-requisitos

Você deve ter o seguinte:

O seguinte deve ser verdadeiro:

  • Sua instância Vinyl usa Docker compose.

  • Você tem cópias ou acesso aos diretórios data, keys e logs do diretório Docker compose de onde o Vinyl é executado.

Atualizar uma instância Docker Vinyl 3.3 para uma instância Docker App Builder 4.x

  1. No diretório Docker compose do Vinyl, execute este comando para parar a instância:

    docker compose down

    Importante

    Não remova nenhum volume do Docker.

  2. Edite o arquivo docker-compose.yml e altere os valores das seguintes chaves:

    Chave Valor antigo Novo valor
    services.vinyl.ports 8080:80 8080:8080
    services.vinyl.image jitterbit/vinyl:3.3 jitterbit/app-builder:<TAG>
    service.vinyl.environment.License__LicenseKey (Se usado) Sua licença Vinyl 3.3 codificada em base64 Sua licença App Builder 4.x codificada em base64

    Importante

    Você não pode fazer upload de um arquivo de licença App Builder 4.x na interface, portanto, você deve fornecer a licença por meio da chave License__LicenseKey no arquivo docker-compose.yml ou por meio de um arquivo appsettings.json localizado no subdiretório data.

  3. Para iniciar a instância, execute este comando:

    docker compose up

  4. Aguarde a conclusão da atualização. (Leva mais tempo do que uma inicialização normal.)

Exemplo de arquivo docker-compose.yml

As linhas alteradas estão destacadas no exemplo abaixo:

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

  vinyl:
    depends_on:
      - db
    image: jitterbit/app-builder:4.45
    ports:
      - "8080:8080"
    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
      License__LicenseKey: eyJpZCI6IjY2NjVmMWE3LTNjNWMtNGRkMS1hYzllLWE3NDgzYjgzNGRmNSIsInZlciI6MiwiaWF0IjoiMjAyNC0wOS…TheRestOfTheBase64EncodedAppBuilderLicenseKey

volumes:
  db_data:
  vinyl_data:
  vinyl_logs:
  vinyl_keys:

Solução de problemas

Para solução de problemas relacionada, consulte o seguinte no guia de solução de problemas do App Builder: