Distribuire Devolutions Server con Docker

Questo articolo mostra come distribuire Devolutions Server utilizzando Docker.

Per semplicità, la versione dell'immagine Docker di Devolutions Server è indicata come 20XX.X nei blocchi di codice di questo articolo. Modifichi questa variabile con la versione che desidera utilizzare.

Prerequisiti

• Docker versione 20.10.X o successiva. Su macOS ARM64, utilizzi --platform linux/amd64 durante la fase di inizializzazione a causa della compatibilità degli assembly. La modalità runtime viene eseguita in modo nativo su ARM64.
• Un'istanza di SQL Server correttamente configurata per Devolutions Server.
• I requisiti di sistema minimi per eseguire Devolutions Server.

Windows

Configurazione iniziale di Devolutions Server

1. Crei un login e un database dedicati utilizzando un account amministratore (ad esempio, sa o un amministratore Azure SQL). Conceda l'accesso con privilegi minimi a Devolutions Server.
2. Scarichi l'ultima immagine Docker di Devolutions Server:

   docker pull devolutions/devolutions-server:release-20XX.X

3. Esegua Devolutions Server in modalità di inizializzazione per creare lo schema del database e il suo primo amministratore, generare le chiavi di crittografia e configurare HTTPS con un certificato autofirmato. Salvi App_Data in modo che la configurazione della crittografia sia recuperabile per il passaggio successivo.

docker volume create dvls-init-data

docker run --rm `
  -e DATABASE_HOST=your-sql-server.database.windows.net `
  -e DATABASE_NAME=dvls `
  -e DATABASE_USERNAME=dvls_user `
  -e DATABASE_PASSWORD='YourSecurePassword!' `
  -e HOSTNAME=localhost `
  -e WEB_SCHEME=https `
  -e PORT=5000 `
  -e DVLS_INIT=true `
  -v dvls-init-data:/opt/devolutions/dvls/App_Data `
  -p 5000:5000 `
  devolutions/devolutions-server:release-20XX.X

1. Estragga encryption.config dal volume di inizializzazione:

   docker run --rm `
     -v dvls-init-data:/data `
     alpine `
     cat /data/encryption.config

2. Converta il file estratto in base64 e lo conservi in modo sicuro, poiché sarà necessario a ogni avvio del runtime:

   docker run --rm `
     -v dvls-init-data:/data `
     alpine `
     cat /data/encryption.config > $env:TEMP\encryption.config
   
   $content = Get-Content -Path "$env:TEMP\encryption.config" -Raw
   $bytes = [System.Text.Encoding]::UTF8.GetBytes($content)
   $base64 = [System.Convert]::ToBase64String($bytes)
   $base64 | Out-File -FilePath "$env:TEMP\encryption.config.b64" -NoNewline -Encoding ASCII

3. Avvii Devolutions Server utilizzando la configurazione di crittografia in base64. Una volta fatto ciò, utilizzi i comandi docker ps e docker logs dvls-server per assicurarsi che tutto funzioni correttamente.

   $encryptionConfig = Get-Content "$env:TEMP\encryption.config.b64" -Raw
   
   docker run -d --name dvls-server `
     -e DATABASE_HOST=your-sql-server.database.windows.net `
     -e DATABASE_NAME=dvls `
     -e DATABASE_USERNAME=dvls_user `
     -e DATABASE_PASSWORD='YourSecurePassword!' `
     -e HOSTNAME=localhost `
     -e WEB_SCHEME=https `
     -e PORT=5000 `
     -e DVLS_ENCRYPTION_CONFIG_B64="$encryptionConfig" `
     -p 5000:5000 `
     devolutions/devolutions-server:release-20XX.X

4. Acceda all'interfaccia web aprendo https://localhost:5000 nel suo browser. Superi l'avviso di sicurezza relativo al certificato autofirmato facendo clic su Avanzate – Procedi. Potrà montare un certificato TSL personalizzato in un secondo momento.
5. Effettui l'accesso utilizzando dvls-admin sia come nome utente sia come password.

Subito dopo l'accesso, cambi la password predefinita andando in Amministrazione – Utenti, facendo clic sul pulsante con i puntini di sospensione verticali dell'utente dvls-admin e selezionando Cambia password.

1. Si assicuri che Devolutions Server sia in esecuzione con DVLS_ENCRYPTION_CONFIG_B64, che la sua interfaccia web sia accessibile e che encryption.config.b64 sia salvato in una posizione sicura (è necessario a ogni riavvio e ridistribuzione). Una volta fatto ciò, il volume temporaneo di inizializzazione può essere rimosso in modo sicuro:

   docker volume rm dvls-init-data

Modalità operative

Il container Docker di DVLS funziona in tre modalità distinte:

Modalità	Variabile d'ambiente	Scopo	Comportamento
Runtime (predefinita)	Nessuna variabile speciale	Funzionamento normale	Avvia il server web e rimane in esecuzione.
Inizializzazione	DVLS_INIT=true	Configurazione iniziale	Crea lo schema del database e l'utente amministratore, quindi esce.
Aggiornamento	DVLS_UPDATE_MODE=true	Aggiornamento del database	Esegue il backup dei file di configurazione, migra il database, quindi esce.

Le modalità Inizializzazione e Aggiornamento si escludono a vicenda.

Porta personalizzata

Modifichi la porta su cui Devolutions Server è in ascolto impostando la variabile d'ambiente PORT, ad esempio con la porta 8080 come nell'esempio seguente:

docker run -d --name dvls-server `
  -e DATABASE_HOST=your-sql-server.database.windows.net `
  -e DATABASE_NAME=dvls `
  -e DATABASE_USERNAME=dvls_user `
  -e DATABASE_PASSWORD='YourSecurePassword!' `
  -e HOSTNAME=localhost `
  -e WEB_SCHEME=https `
  -e PORT=8080 `
  -p 8080:8080 `
  devolutions/devolutions-server:release-20XX.X

Montare un certificato TSL personalizzato

Monti i propri file di certificato invece di utilizzare il certificato autofirmato generato automaticamente:

mkdir -p /host/path/certs
cp /path/to/server.pem /host/path/certs/
cp /path/to/server.key /host/path/certs/

docker run -d --name dvls-server `
  -e DATABASE_HOST=your-sql-server.database.windows.net \
  -e DATABASE_NAME=dvls `
  -e DATABASE_USERNAME=dvls_user `
  -e DATABASE_PASSWORD='YourSecurePassword!' `
  -e HOSTNAME=devolutions-server.company.com `
  -e WEB_SCHEME=https `
  -e PORT=5000 `
  -e TLS_CERTIFICATE_FILE=/opt/devolutions/dvls/certs/server.pem `
  -e TLS_PRIVATE_KEY_FILE=/opt/devolutions/dvls/certs/server.key `
  -p 5000:5000 `
  -v /host/path/certs:/opt/devolutions/dvls/certs:ro `
  devolutions/devolutions-server:release-20XX.X

Gestione del container

Comandi	Funzioni
docker start dvls-server	Avvia il container.
docker stop dvls-server	Arresta il container.
docker rm dvls-server	Rimuove il container.

La rimozione del container è sicura purché disponga del file encryption.config.b64, dell'accesso al suo database SQL Server e delle sue variabili d'ambiente documentate.

macOS

Configurazione iniziale di Devolutions Server

1. Crei un login e un database dedicati utilizzando un account amministratore (ad esempio, sa o un amministratore Azure SQL). Conceda l'accesso con privilegi minimi a Devolutions Server.
2. Scarichi l'ultima immagine Docker di Devolutions Server:

   docker pull devolutions/devolutions-server:release-20XX.X

3. Esegua Devolutions Server in modalità di inizializzazione per creare lo schema del database e il suo primo amministratore, generare le chiavi di crittografia e configurare HTTPS con un certificato autofirmato. Salvi App_Data in modo che la configurazione della crittografia sia recuperabile per il passaggio successivo.

Su macOS, è qui che occorre aggiungere --platform linux/amd64.

docker volume create dvls-init-data

docker run --rm \
  -e DATABASE_HOST=your-sql-server.database.windows.net \
  -e DATABASE_NAME=dvls \
  -e DATABASE_USERNAME=dvls_user \
  -e DATABASE_PASSWORD='YourSecurePassword!' \
  -e HOSTNAME=localhost \
  -e WEB_SCHEME=https \
  -e PORT=5000 \
  -e DVLS_INIT=true \
  -v dvls-init-data:/opt/devolutions/dvls/App_Data \
  -p 5000:5000 \
  devolutions/devolutions-server:release-20XX.X

1. Estragga encryption.config dal volume di inizializzazione:

   docker run --rm \
     -v dvls-init-data:/data \
     alpine \
     cat /data/encryption.config

2. Converta il file estratto in base64 e lo conservi in modo sicuro, poiché sarà necessario a ogni avvio del runtime:

   docker run --rm \
     -v dvls-init-data:/data \
     alpine \
     cat /data/encryption.config > /tmp/encryption.config
   
   base64 -i /tmp/encryption.config -o /tmp/encryption.config.b64

3. Avvii Devolutions Server utilizzando la configurazione di crittografia in base64. Una volta fatto ciò, utilizzi i comandi docker ps e docker logs dvls-server per assicurarsi che tutto funzioni correttamente:

   docker run -d --name dvls-server \
     -e DATABASE_HOST=your-sql-server.database.windows.net \
     -e DATABASE_NAME=dvls \
     -e DATABASE_USERNAME=dvls_user \
     -e DATABASE_PASSWORD='YourSecurePassword!' \
     -e HOSTNAME=localhost \
     -e WEB_SCHEME=https \
     -e PORT=5000 \
     -e DVLS_ENCRYPTION_CONFIG_B64="$(cat /tmp/encryption.config.b64)" \
     -p 5000:5000 \
     devolutions/devolutions-server:release-20XX.X

4. Acceda all'interfaccia web aprendo https://localhost:5000 nel suo browser. Superi l'avviso di sicurezza relativo al certificato autofirmato facendo clic su Avanzate – Procedi. Potrà montare un certificato TSL personalizzato in un secondo momento.
5. Effettui l'accesso utilizzando dvls-admin sia come nome utente sia come password.

Subito dopo l'accesso, cambi la password predefinita andando in Amministrazione – Utenti, facendo clic sul pulsante con i puntini di sospensione verticali dell'utente dvls-admin e selezionando Cambia password.

1. Si assicuri che Devolutions Server sia in esecuzione con DVLS_ENCRYPTION_CONFIG_B64, che la sua interfaccia web sia accessibile e che encryption.config.b64 sia salvato in una posizione sicura (è necessario a ogni riavvio e ridistribuzione). Una volta fatto ciò, il volume temporaneo di inizializzazione può essere rimosso in modo sicuro:

   docker volume rm dvls-init-data

Modalità operative

Il container Docker di DVLS funziona in tre modalità distinte:

Modalità	Variabile d'ambiente	Scopo	Comportamento
Runtime (predefinita)	Nessuna variabile speciale	Funzionamento normale	Avvia il server web e rimane in esecuzione.
Inizializzazione	DVLS_INIT=true	Configurazione iniziale	Crea lo schema del database e l'utente amministratore, quindi esce.
Aggiornamento	DVLS_UPDATE_MODE=true	Aggiornamento del database	Esegue il backup dei file di configurazione, migra il database, quindi esce.

Le modalità Inizializzazione e Aggiornamento si escludono a vicenda.

Porta personalizzata

Modifichi la porta su cui Devolutions Server è in ascolto impostando la variabile d'ambiente PORT, ad esempio con la porta 8080 come nell'esempio seguente:

docker run -d --name dvls-server \
  -e DATABASE_HOST=your-sql-server.database.windows.net \
  -e DATABASE_NAME=dvls \
  -e DATABASE_USERNAME=dvls_user \
  -e DATABASE_PASSWORD='YourSecurePassword!' \
  -e HOSTNAME=localhost \
  -e WEB_SCHEME=https \
  -e PORT=8080 \
  -p 8080:8080 \
  devolutions/devolutions-server:release-20XX.X

Montare un certificato TSL personalizzato

Monti i propri file di certificato invece di utilizzare il certificato autofirmato generato automaticamente:

mkdir -p /host/path/certs
cp /path/to/server.pem /host/path/certs/
cp /path/to/server.key /host/path/certs/

docker run -d --name dvls-server \
  -e DATABASE_HOST=your-sql-server.database.windows.net \
  -e DATABASE_NAME=dvls \
  -e DATABASE_USERNAME=dvls_user \
  -e DATABASE_PASSWORD='YourSecurePassword!' \
  -e HOSTNAME=devolutions-server.company.com \
  -e WEB_SCHEME=https \
  -e PORT=5000 \
  -e TLS_CERTIFICATE_FILE=/opt/devolutions/dvls/certs/server.pem \
  -e TLS_PRIVATE_KEY_FILE=/opt/devolutions/dvls/certs/server.key \
  -p 5000:5000 \
  -v /host/path/certs:/opt/devolutions/dvls/certs:ro \
  devolutions/devolutions-server:release-20XX.X

Gestione del container

Comandi	Funzioni
docker start dvls-server	Avvia il container.
docker stop dvls-server	Arresta il container.
docker rm dvls-server	Rimuove il container.

La rimozione del container è sicura purché disponga del file encryption.config.b64, dell'accesso al suo database SQL Server e delle sue variabili d'ambiente documentate.

Linux

Configurazione iniziale di Devolutions Server

1. Crei un login e un database dedicati utilizzando un account amministratore (ad esempio, sa o un amministratore Azure SQL). Conceda l'accesso con privilegi minimi a Devolutions Server.
2. Scarichi l'ultima immagine Docker di Devolutions Server:

   docker pull devolutions/devolutions-server:release-20XX.X

3. Esegua Devolutions Server in modalità di inizializzazione per creare lo schema del database e il suo primo amministratore, generare le chiavi di crittografia e configurare HTTPS con un certificato autofirmato. Salvi App_Data in modo che la configurazione della crittografia sia recuperabile per il passaggio successivo.

docker volume create dvls-init-data

docker run --rm \
  -e DATABASE_HOST=your-sql-server.database.windows.net \
  -e DATABASE_NAME=dvls \
  -e DATABASE_USERNAME=dvls_user \
  -e DATABASE_PASSWORD='YourSecurePassword!' \
  -e HOSTNAME=localhost \
  -e WEB_SCHEME=https \
  -e PORT=5000 \
  -e DVLS_INIT=true \
  -v dvls-init-data:/opt/devolutions/dvls/App_Data \
  -p 5000:5000 \
  devolutions/devolutions-server:release-20XX.X

1. Estragga encryption.config dal volume di inizializzazione:

   docker run --rm \
     -v dvls-init-data:/data \
     alpine \
     cat /data/encryption.config

2. Converta il file estratto in base64 e lo conservi in modo sicuro, poiché sarà necessario a ogni avvio del runtime:

   docker run --rm \
     -v dvls-init-data:/data \
     alpine \
     cat /data/encryption.config > /tmp/encryption.config
   
   base64 -w 0 /tmp/encryption.config > /tmp/encryption.config.b64

3. Avvii Devolutions Server utilizzando la configurazione di crittografia in base64. Una volta fatto ciò, utilizzi i comandi docker ps e docker logs dvls-server per assicurarsi che tutto funzioni correttamente:

   docker run -d --name dvls-server \
     -e DATABASE_HOST=your-sql-server.database.windows.net \
     -e DATABASE_NAME=dvls \
     -e DATABASE_USERNAME=dvls_user \
     -e DATABASE_PASSWORD='YourSecurePassword!' \
     -e HOSTNAME=localhost \
     -e WEB_SCHEME=https \
     -e PORT=5000 \
     -e DVLS_ENCRYPTION_CONFIG_B64="$(cat /tmp/encryption.config.b64)" \
     -p 5000:5000 \
     devolutions/devolutions-server:release-20XX.X

4. Acceda all'interfaccia web aprendo https://localhost:5000 nel suo browser. Superi l'avviso di sicurezza relativo al certificato autofirmato facendo clic su Avanzate – Procedi. Potrà montare un certificato TSL personalizzato in un secondo momento.
5. Effettui l'accesso utilizzando dvls-admin sia come nome utente sia come password.

Subito dopo l'accesso, cambi la password predefinita andando in Amministrazione – Utenti, facendo clic sul pulsante con i puntini di sospensione verticali dell'utente dvls-admin e selezionando Cambia password.

1. Si assicuri che Devolutions Server sia in esecuzione con DVLS_ENCRYPTION_CONFIG_B64, che la sua interfaccia web sia accessibile e che encryption.config.b64 sia salvato in una posizione sicura (è necessario a ogni riavvio e ridistribuzione). Una volta fatto ciò, il volume temporaneo di inizializzazione può essere rimosso in modo sicuro:

   docker volume rm dvls-init-data

Modalità operative

Il container Docker di DVLS funziona in tre modalità distinte:

Modalità	Variabile d'ambiente	Scopo	Comportamento
Runtime (predefinita)	Nessuna variabile speciale	Funzionamento normale	Avvia il server web e rimane in esecuzione.
Inizializzazione	DVLS_INIT=true	Configurazione iniziale	Crea lo schema del database e l'utente amministratore, quindi esce.
Aggiornamento	DVLS_UPDATE_MODE=true	Aggiornamento del database	Esegue il backup dei file di configurazione, migra il database, quindi esce.

Le modalità Inizializzazione e Aggiornamento si escludono a vicenda.

Porta personalizzata

Modifichi la porta su cui Devolutions Server è in ascolto impostando la variabile d'ambiente PORT, ad esempio con la porta 8080 come nell'esempio seguente:

docker run -d --name dvls-server \
  -e DATABASE_HOST=your-sql-server.database.windows.net \
  -e DATABASE_NAME=dvls \
  -e DATABASE_USERNAME=dvls_user \
  -e DATABASE_PASSWORD='YourSecurePassword!' \
  -e HOSTNAME=localhost \
  -e WEB_SCHEME=https \
  -e PORT=8080 \
  -p 8080:8080 \
  devolutions/devolutions-server:release-20XX.X

Montare un certificato TSL personalizzato

Monti i propri file di certificato invece di utilizzare il certificato autofirmato generato automaticamente:

mkdir -p /host/path/certs
cp /path/to/server.pem /host/path/certs/
cp /path/to/server.key /host/path/certs/

docker run -d --name dvls-server \
  -e DATABASE_HOST=your-sql-server.database.windows.net \
  -e DATABASE_NAME=dvls \
  -e DATABASE_USERNAME=dvls_user \
  -e DATABASE_PASSWORD='YourSecurePassword!' \
  -e HOSTNAME=devolutions-server.company.com \
  -e WEB_SCHEME=https \
  -e PORT=5000 \
  -e TLS_CERTIFICATE_FILE=/opt/devolutions/dvls/certs/server.pem \
  -e TLS_PRIVATE_KEY_FILE=/opt/devolutions/dvls/certs/server.key \
  -p 5000:5000 \
  -v /host/path/certs:/opt/devolutions/dvls/certs:ro \
  devolutions/devolutions-server:release-20XX.X

Gestione dei container

Comandi	Funzioni
docker start dvls-server	Avvia il container.
docker stop dvls-server	Arresta il container.
docker rm dvls-server	Rimuove il container.

La rimozione del container è sicura a condizione che disponga del file encryption.config.b64, dell'accesso al database SQL Server e delle proprie variabili d'ambiente documentate.

Vedere anche

• Elenco di controllo per la sicurezza
• Distribuzione di Devolutions Server in Azure App Service tramite un container
• Configurazione Docker avanzata per Devolutions Server