This article shows how to install the Exalate app for Azure DevOps on the server using Docker.
You need to install the Docker. Check docker documentation for more details.
How to install Exalate for Azure DevOps
Check the release notes for the latest version.
1. Create a docker-compose.
Create a directory which would hold the docker-compose file:
Create a docker-compose.yml file in it:
Below you can find the environment variables used for the app container. All of them are optional, and in the given example, we've overridden AZURENODE_PG_DB, AZURENODE_PG_USER, and AZURENODE_PG_PWD just to show how to pass different credentials to the Exalate application.
|Variable name||Default value||Example||Description|
|AZURENODE_PG_HOST||AZURENODE_PG_HOST=database||AZURENODE_PG_HOST=db.acme.com||tells the exalate application where is the postgres database to connect to hosted|
|AZURENODE_PG_DB||AZURENODE_PG_DB=azurenode||AZURENODE_PG_DB=exalate||tells the exalate application what is the postgres database name for the exalate application|
|AZURENODE_PG_USER||AZURENODE_PG_USER=idalko||AZURENODE_PG_USER=exalate||tells the exalate application what is the postgres database user name for the exalate application to perform queries with|
|AZURENODE_PG_PWD||AZURENODE_PG_PWD=idalko||AZURENODE_PG_PWD=secret||tells the exalate application what is the postgres database user's password for the exalate application to perform queries with|
tells what which is the port to start the exalate application on. Note that this is the port within the exalateazurenode_azurenode_1 container, thus if this variable is changed (for example to 80), the
should also be changed to
|AZURENODE_SMTP_HOST_NAME||AZURENODE_SMTP_HOST_NAME=mail.server.com||AZURENODE_SMTP_HOST_NAME=smtp.gmail.com||is used to send email notifications about errors blocking synchronization|
|AZURENODE_SMTP_PORT||AZURENODE_SMTP_PORT=465||AZURENODE_SMTP_PORT=587||is used to send email notifications about errors blocking synchronization|
|AZURENODE_SMTP_FROM||AZURENODE_SMTP_FROMfirstname.lastname@example.org||AZURENODE_SMTP_FROMemail@example.com||is used to send email notifications about errors blocking synchronization|
|AZURENODE_SMTP_USER||AZURENODE_SMTP_USER=admin||AZURENODE_SMTP_USER=my.name||is used to send email notifications about errors blocking synchronization|
|AZURENODE_SMTP_PASS||AZURENODE_SMTP_PASS=1234567||AZURENODE_SMTP_PASS=secret||is used to send email notifications about errors blocking synchronization|
|AZURENODE_SMTP_TLS||AZURENODE_SMTP_TLS=true||AZURENODE_SMTP_TLS=true||is used to send email notifications about errors blocking synchronization. Can be set to false, but then the AZURENODE_SMTP_PORT should be set to the port, that accepts non-SSL and non-TLS connections|
create createdb.sh (referenced from docker-compose.yml):
Ensure that the volumes are included in your backup strategy:
2. Start the application.
How to manage the application on docker
Run queries to the application's database
You can find all tables using psql's \dt+ command:
All the postgres SQL queries are permitted
To exit the application's DB:
Inspect the application's filesystem
Remove the application
Remove the application data
Danger zone - do this only if you wish to lose all the synchronization information, including the current synchronizations enqueued to be performed and synchronization status.
Be sure that the remote side (you exalate issues with) knows that you're stopping synchronization and are ready to handle synchronization errors.
Problems during the installation of the Exalate server for Azure DevOps
If you have problems during the installation of the Exalate app for Azure DevOps you can find logs describing possible problem inside
The name for the file is generated randomly and automatically by the OS, but you can find the file by the creation date.
Problems while running the Exalate server for Azure DevOps
Logs will be generated under the directory:
Refer to these logs to get more information about possible problems and communicate with our support if you need any assistance.
Check our Support options.