Deploy Temporal Admin

This is part of the Charmed Temporal Tutorial. Please refer to this page for more information and the overview of the content.

The Temporal Admin Tools are a set of command-line utilities used to configure and support the Temporal server.

Requirements

• You have completed Environment Setup.
• You have completed Deploy Temporal Server.
• You have completed Deploy PostgreSQL Database.

Deploy

To deploy Charmed Temporal Admin, you need to run the following command, which will fetch the charm from Charmhub and deploy it to your model:

juju deploy temporal-admin-k8s --channel 1.31/stable --base ubuntu@26.04

Check status:

juju status

Wait until the application is ready, when it is ready, juju status will show admin:temporal relation: database connections info not available at the admin app and admin:temporal relation: schema is not ready on the server app.

Relate Admin to Server

The admin charm in 1.31/stable requires two relations to reach active:

• admin - schema management bridge between admin and server.
• temporal-host-info - supplies the Temporal frontend’s gRPC host and port to the admin charm so that its cli action can reach the server.

Add both:

juju integrate temporal-k8s:admin              temporal-admin-k8s:admin
juju integrate temporal-k8s:temporal-host-info  temporal-admin-k8s:temporal-host-info

Deprecation notice: server-name is removed. The temporal-host-info relation must be used.

Monitor relations until they settle:

juju status --relations

After a short while, all applications should be active.

Create the initial namespace

You can run the following command to create the initial Temporal namespace:

# Create default namespace:
juju run temporal-admin-k8s/0 cli args="operator namespace create --namespace default --retention 3d" --wait 1m

# Output:
Running operation 19 with 1 task
  - task 20 on unit-temporal-admin-k8s-0

Waiting for task 20...
output: |
  Namespace default successfully registered.
result: command succeeded

See next: Deploy Temporal Web UI