Getting started
In this tutorial, we’ll walk you through the process of deploying the Discourse charm, relating it to the nginx-ingress-integrator charm, the postgresql-k8s charm and the redis-k8s charm, and inspecting the kubernetes resources created.
Requirements
You will need:
- A laptop or desktop running Ubuntu (or you can use a VM).
-
Juju and Microk8s installed. We’ll also want to make sure the ingress add-on is enabled, which we can do by running
microk8s enable ingress.
Deploy this charm
Discourse requires connections to PostgreSQL and Redis, so those will be deployed too and related to the Discourse charm. For more information, see the Charm Architecture.
All the above charms will the deployed in a new model named discourse:
# Add the model
juju add-model discourse
# Deploy the charms
juju deploy redis-k8s
juju deploy postgresql-k8s
juju deploy discourse-k8s
# Relate redis-k8s and postgresql-k8s to discourse-k8s
juju relate redis-k8s discourse-k8s
# For postgresql-k8s the "db" interface needs to be specified as the charm provides more than one
juju relate discourse-k8s postgresql-k8s:db
By running juju status --relations the current state of the deployment can be queried, with all the charms eventually reaching Activestate:
Model Controller Cloud/Region Version SLA Timestamp
discourse microk8s-localhost microk8s/localhost 2.9.37 unsupported 10:35:00+01:00
App Version Status Scale Charm Channel Rev Address Exposed Message
discourse-k8s active 1 discourse-k8s edge 13 10.152.183.34 no
postgresql-k8s res:postgresql-image@8a72e11 active 1 postgresql-k8s stable 20 no Pod configured
redis-k8s ubuntu/redis@691f315 active 1 redis-k8s stable 7 no
Unit Workload Agent Address Ports Message
discourse-k8s/0* active idle 10.1.180.82
postgresql-k8s/0* active idle 10.1.180.81 5432/TCP Pod configured
redis-k8s/0* active idle 10.1.180.78 6379/TCP
Relation provider Requirer Interface Type Message
postgresql-k8s:db discourse-k8s:db pgsql regular
postgresql-k8s:peer postgresql-k8s:peer peer peer
redis-k8s:redis discourse-k8s:redis redis regular
Run kubectl get pods -n discourse to see the pods that are being created by the charms:
NAME READY STATUS RESTARTS AGE
modeloperator-7879f68947-s4q59 1/1 Running 0 10m
postgresql-k8s-operator-0 1/1 Running 0 10m
redis-k8s-operator-0 1/1 Running 0 10m
redis-k8s-0 1/1 Running 0 10m
postgresql-k8s-0 1/1 Running 0 10m
discourse-k8s-0 2/2 Running 0 9m
In order to expose the charm, the Nginx Ingress Integrator is to be deployed alongside Discourse to provide ingress capabilities
juju deploy nginx-ingress-integrator
# If your cluster has RBAC enabled you'll be prompted to run the following:
juju trust nginx-ingress-integrator --scope=cluster
juju relate discourse-k8s nginx-ingress-integrator
Discourse will be deployed with discourse-k8s as default hostname. In order to reach it, modify your /etc/hosts file so that it points to 127.0.0.1
echo 127.0.0.1 discourse-k8s >> /etc/hosts
After that, visit http://discourse-k8s to reach Discourse.
This charm allows you to add a admin user by executing the corresponding action. Instead of interacting with the Discourse UI just run juju run-action discourse-k8s/0 add-admin-user email=email@example.com password=somepwd --wait and it will be registered and validated.