Installing the WorkZone containers using a master Helm chart
Authenticate to remote registry (ACR)
The command will prompt for the user name and password and provide the credentials to authenticate with Azure Container Registry (ACR).
werf helm registry login <registry-name>
werf helm registry login kmdworkzone.azurecr.io
Deployment from the registry (ACR)
Make sure that the global.image.tag is set to the current WorkZone version before you execute the command, for example --set global.image.tag=24_5
.
werf bundle apply --tag v1.0.0 --release myapp --namespace myapp-production --repo kmdworkzone.azurecr.io/helm/werf-oauth2-odata --set global.image.tag=24_5 --values values.yaml --values environment.yaml
Command descriptions:
--tag: |
The specific chart tag to be deployed. If it is not specified, the default tag will be the latest. |
--release: |
The name of the release to be deployed. Change the value accordingly. |
--namespace: |
The name of the namespace where the release is deployed. Change the value accordingly. |
--repo: |
The registry (ACR) URL that contains the bundled chart. Change the value accordingly. |
--set: |
Overrides the default image tag value. |
--values: |
Passing and overriding the value files. The order is important. The value file which is at the rightmost has the highest priority. Change the value files according to environment. |
Helm values
The command uses two value files, values.yaml
and environment.yaml
. The first value file contains the default values with WorkZone internal URLs and the second value file contains the WorkZone public URL along with database details.
Verify the installation
To prepare for WorkZone deployment, it is important to create a namespace to register secrets for the pods.
Once the containers are installed, it is time to do an initial verification of the installation. You can do this by activating the SCIMADMIN user in the WorkZone instance.
-
Ensure that the local user SCIMADMIN is mapped to the UPN for scimadmin user in MicrosoftEntra.
-
SQL statement: update sjsysadm.users set upn=(E-Mail) where user_name='SCIMADMIN’
-
Access and authentication to your WorkZone URL.
-
Open WorkZone Configurator, which should open and display the WorkZone Configurator page.