Use Unleash Docker Image

Useful links:

• Azure Community Docker image on dockerhub
• OpenID Connect Community Docker image on dockerhub
• Official Unleash Helm Chart on artifacthub

Steps:

1. Create a network by running docker network create unleash
2. Start a postgres database:

docker run -d -e POSTGRES_PASSWORD=some_password \
  -e POSTGRES_USER=unleash_user -e POSTGRES_DB=unleash \
  --network unleash --name postgres postgres

3. Start Unleash via docker:

See index.js and auth-hook.js example implementations for azure within the example repository.

docker run -p 4242:4242 \
  -e DATABASE_HOST=postgres -e DATABASE_NAME=unleash \
  -e DATABASE_USERNAME=unleash_user -e DATABASE_PASSWORD=some_password \
  -e DATABASE_SSL=false \
  -e BASE_URI_PATH= \
  -e UNLEASH_AUTH_TENANT_ID={AZURE_TENANT_ID} \
  -e UNLEASH_AUTH_CLIENT_ID={AZURE_CLIENT_ID} \
  -e UNLEASH_AUTH_CLIENT_SECRET={AZURE_CLIENT_SECRET} \
  -e UNLEASH_HOST=http://localhost:4242 \
  -v $(pwd)/index.js:/unleash/index.js \
  -v $(pwd)/azure-hook.js:/unleash/auth-hook.js \
  --network unleash unleashorg/unleash-community-azure

All configuration options available in our documentation.

User accounts

• Once started up, you'll have to use the OIDC provider with your credentials.

Building the docker image

We expect a build-arg for which node-version to build with so if you're building using the docker cli, you have to use --build-arg NODE_VERSION=14-alpine OR --build-arg NODE_VERSION=16-alpine

Upgrade version

When we upgrade the unleash-version this project should be tagged with the same version number.

git tag -a 3.7.0 -m "upgrade to unleash-server 3.7.0"
git push origin main --follow-tags

You might also want to update the minor tag:

git tag -d 3.7
git push origin :3.7
git tag -a 3.7 -m "Update 3.7 tag"
git push origin main --follow-tags

This will automatically trigger a github actions which will build the new tag and push it to docker-hub.