Actualizar a Jitterbit App Builder 4.x desde Vinyl 3.3 en Docker

Introducción

Esta página muestra cómo actualizar una instancia de Docker Vinyl 3.3 a una instancia de Docker App Builder 4.x.

Consejo

Para obtener orientación sobre la planificación de una actualización en entornos de desarrollo, control de calidad y producción, incluidas ventanas de mantenimiento y estrategia de reversión, consulta Estrategias de actualización en producción.

Requisitos previos

Debes tener lo siguiente:

Una licencia de App Builder. Una licencia de Vinyl 3.x no funciona en una instancia de App Builder 4.x.

Lo siguiente debe ser verdadero:

Tu instancia de Vinyl utiliza Docker compose.
Tienes copias o acceso a los directorios data, keys y logs del directorio de Docker compose desde donde se ejecuta Vinyl.

Actualizar una instancia de Docker Vinyl 3.3 a una instancia de Docker App Builder 4.x

En el directorio de Docker compose de Vinyl, ejecuta este comando para detener la instancia:
```
docker compose down
```
Importante

No elimines ningún volumen de Docker.

Edita el archivo docker-compose.yml y cambia los valores de las siguientes claves:

Clave	Valor anterior	Valor nuevo
`services.vinyl.ports`	`8080:80`	`8080:8080`
`services.vinyl.image`	`jitterbit/vinyl:3.3`	`jitterbit/app-builder:<TAG>`
`service.vinyl.environment.License__LicenseKey`	(Si se utiliza) Tu licencia de Vinyl 3.3 codificada en base64	Tu licencia de App Builder 4.x codificada en base64

<TAG> es la etiqueta de versión de App Builder para la que tienes licencia.

Importante

No puedes cargar un archivo de licencia de App Builder 4.x en la interfaz de usuario, por lo que debes proporcionar la licencia a través de la clave License__LicenseKey en el archivo docker-compose.yml, o a través de un archivo appsettings.json ubicado en el subdirectorio data.

Para iniciar la instancia, ejecuta este comando:
```
docker compose up
```
Espera a que se complete la actualización. (Tarda más que un inicio normal).

Archivo `docker-compose.yml` de ejemplo

Las líneas modificadas se resaltan en el ejemplo a continuación:

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:

Solución de problemas

Para obtener información relacionada sobre la solución de problemas, consulta lo siguiente en la guía de solución de problemas de App Builder:

Implementación de Docker: No se puede cargar la licencia de App Builder 4.x en la interfaz de usuario