docs: tutorial (#54)

* docs: basic tutorial

* docs: phrasing improvements & links to docs

* fix: upgrade libs

* fix: punctuation

* docs: merge overview/intro with main tutorial

* docs: remove edge deployment method

* docs: wording clarity improvements

* docs: remove destory force flag

* docs: clarify database configuration option

* docs: improve database integration wording

* docs: code snippet improvements

* docs: environment base to model based tutorial setup

* chore: rename tutorial to getting-started

* docs: add what you'll learn section

docs/tutorials/getting-started.md

@@ -0,0 +1,125 @@
+# Tutorial
+
+## What you'll learn
+
+- Deploy the [wordpress-k8s charm](https://charmhub.io/wordpress-k8s)
+- [Deploy and relate database](#deploy-and-relate-database)
+- [Get admin credentials](#get-admin-credentials)
+
+The wordpress-k8s charm helps deploy a horizontally scalable WordPress application with ease and
+also helps operate the charm by liaising with the Canonical Observability Stack (COS). This
+tutorial will walk you through each step of deployment to get a basic WordPress deployment.
+
+### Prerequisites
+
+To deploy wordpress-k8s charm, you will need a juju bootstrapped with any kubernetes controller.
+To see how to bootstrap your juju installation with microk8s, please refer to the documentation
+on microk8s [installation](https://juju.is/docs/olm/microk8s).
+
+### Setting up the tutorial model
+
+To easily clean up the resources and to separate your workload from the contents of this tutorial,
+it is recommended to set up a new model with the following command.
+
+```
+juju add-model wordpress-tutorial
+```
+
+### Deploy wordpress-k8s charm
+
+Deployment of WordPress requires a database integration. The preferred method in juju is through an
+integration. In this case, a `mysql` [interface](https://juju.is/docs/sdk/integration) is required
+by the wordpress-k8s charm and hence, [`mysql-k8s`](https://charmhub.io/mysql-k8s) charm will be
+used.
+
+Start off by deploying the wordpress charm. By default it will deploy the latest stable release of
+the wordpress-k8s charm.
+
+```
+juju deploy wordpress-k8s
+```
+
+### Deploy and relate database
+
+#### Database relation
+
+The following commands deploys the mysql-k8s charm and relates wordpress-k8s charm through its mysql
+interface.
+
+```
+juju deploy mysql-k8s \
+    --config mysql-interface-user=wordpress-tutorial-user \
+    --config mysql-interface-database=wordpress-tutorial-database
+# mysql interface is required since mysql-k8s charm provides multiple mysql interfaces
+juju relate wordpress-k8s:mysql mysql-k8s:mysql
+```
+
+#### Database configuration
+
+Note: This section is required only if database relation is not used. If you want to deploy your
+wordpress-k8s charm through configuration, you may continue to follow the steps in this section.
+
+The commands below create the MySQL deployment in microk8s which we can then use to configure the
+database for wordpress-k8s. Note that the environment variables are for demonstration purposes only
+and should not be used for production environments.
+
+```
+microk8s kubectl run mysql -n wordpress-tutorial --image=mysql:latest \
+--env="MYSQL_ROOT_PASSWORD=<strong-password>" \
+--env=”MYSQL_DATABASE=wordpress-tutorial-database” \
+--env=”MYSQL_USER=wordpress-tutorial-user” \
+--env=”MYSQL_PASSWORD=<strong-password>
+WORDPRESS_IP=microk8s kubectl get pod mysql --template '{{.status.podIP}}'
+juju config wordpress-k8s \
+db_host=$WORDPRESS_IP \
+db_name=wordpress-tutorial-database \
+db_user=wordpress-tutorial-user \
+db_password=<strong-password>
+```
+
+Use the following command to watch your deployment progress through different stages of deployment.
+
+```
+juju status --color --watch 2s
+```
+
+### Get admin credentials
+
+After the database has been configured in the
+[Deploy and relate database section](#deploy-and-relate-database), you can now access the WordPress
+application by accessing the IP of a wordpress-k8s unit. To start managing WordPress as an
+administrator, you need to get the credentials for the admin account.
+
+By running the `get-initial-password` action on a wordpress-k8s unit, juju will read and fetch the
+admin credentials setup for you. You can use the following command below.
+
+```
+juju run-action wordpress-k8s/0 get-initial-password --wait
+```
+
+The result should look something similar to the contents below:
+
+```
+unit-wordpress-k8s-0:
+  UnitId: wordpress-k8s/0
+  id: "6"
+  results:
+    password: <password> # should look something like: XXXXXXXXXXXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXX
+  status: completed
+  timing:
+    completed: 2023-02-24 02:46:27 +0000 UTC
+    enqueued: 2023-02-24 02:46:25 +0000 UTC
+    started: 2023-02-24 02:46:26 +0000 UTC
+```
+
+You can now access your WordPress application at `http://<UNIT_IP>/wp-login.php` and login with
+username admin and password the action above.
+
+### Cleaning up the environment
+
+Congratulations! You have successfully finished the wordpress-k8s tutorial. You can now remove the
+model environment that you’ve created using the following command.
+
+```
+juju destroy model wordpress-tutorial -y --release-storage
+```