Skip to content

Commit

Permalink
Merge branch 'main' into renovate/ops-2.x
Browse files Browse the repository at this point in the history
  • Loading branch information
arturo-seijas authored Oct 25, 2023
2 parents b36a465 + a8f2b46 commit ec0c95d
Show file tree
Hide file tree
Showing 23 changed files with 34 additions and 36 deletions.
2 changes: 1 addition & 1 deletion docs/explanation/containers.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,4 +47,4 @@ Golang client are exposed that are not part of the WordPress Apache’s metrics

This container is the main point of contact with the juju controller. It communicates with juju to
run necessary charm code defined by the main `src/charm.py`. The source code is copied to the
`/var/lib/juju/agents/unit-UNIT_NAME/charm` directory.
`/var/lib/juju/agents/unit-UNIT_NAME/charm` directory.
2 changes: 1 addition & 1 deletion docs/explanation/lifecycle-events.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,4 +55,4 @@ installed themes and plugins with the incoming list of themes and plugins.
### upgrade-charm

Upgrade charm event is fired on the upgrade charm command `juju refresh wordpress-k8s`. Sets up
secrets in peer-relation databag for upgraded deployment of WordPress if not already set.
secrets in peer-relation databag for upgraded deployment of WordPress if not already set.
2 changes: 1 addition & 1 deletion docs/explanation/oci-image.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,4 +24,4 @@ the latest stable version by default, downloaded from the source.

This is the image required for sidecar container apache-prometheus-exporter. Openly available image
`bitnami/apache-exporter` is used. Read more about the image from the official Docker Hub
[source](https://hub.docker.com/r/bitnami/apache-exporter/).
[source](https://hub.docker.com/r/bitnami/apache-exporter/).
2 changes: 1 addition & 1 deletion docs/explanation/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,4 +4,4 @@ The wordpress-k8s charm aims to provide core functionalities of WordPress with h
scalable architecture, leveraging its flexible capabilities enhanced by plugins. Operational
capabilities are enhanced through integration with the
Canonical Observability Stack ([COS](https://charmhub.io/topics/canonical-observability-stack/))
charms.
charms.
2 changes: 1 addition & 1 deletion docs/explanation/relations.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,4 +45,4 @@ Grafana-dashboard is a part of the COS integration to enhance observability. Thi
a pre-made dashboard used for monitoring Apache server hosting WordPress. The wordpress-k8s charm
satisfies the `grafana_dashboard` interface by providing the pre-made dashboard template to the
Grafana relation data bag under the "dashboards" key. Requires Prometheus datasource to be already
integrated with Grafana.
integrated with Grafana.
2 changes: 1 addition & 1 deletion docs/how-to/configure-hostname.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,4 +42,4 @@ Test the ingress by sending a GET request to the service with `Host` headers.

```
curl -H "Host: <desired-hostname>" http://<nginx-ingress-integrator-service-ip>
```
```
2 changes: 1 addition & 1 deletion docs/how-to/configure-initial-settings.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,4 +22,4 @@ WordPress(`http://<wordpress-unit-ip>/wp-admin/options-general.php`).

You can also pass in the wordpress-k8s `configuration.yaml` file with the parameters above. See how
to pass in a configuration file in the
[juju documentation](https://juju.is/docs/olm/manage-applications#heading--configure-an-application-during-deployment).
[juju documentation](https://juju.is/docs/olm/manage-applications#heading--configure-an-application-during-deployment).
2 changes: 1 addition & 1 deletion docs/how-to/configure-object-storage.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,4 +61,4 @@ You can then configure wordpress-k8s charm using the yaml contents above.

```
juju config wordpress-k8s wp_plugin_openstack-objectstorage_config="$(cat <path-to-yaml>)"
```
```
2 changes: 1 addition & 1 deletion docs/how-to/contribute.md
Original file line number Diff line number Diff line change
Expand Up @@ -83,4 +83,4 @@ The following commands can then be used to run the tests:

Canonical welcomes contributions to the WordPress Operator. Please check out our
[contributor agreement](https://ubuntu.com/legal/contributors) if you're interested in contributing
to the solution.
to the solution.
2 changes: 1 addition & 1 deletion docs/how-to/enable-antispam.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,4 +11,4 @@ enable Akismet plugin.
juju config wordpress-k8s wp_plugin_akismet_key=<akismet-api-key>
```

The Akismet plugin should automatically be active after running the configuration.
The Akismet plugin should automatically be active after running the configuration.
2 changes: 1 addition & 1 deletion docs/how-to/enable-waf.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,4 +47,4 @@ Annotations: nginx.ingress.kubernetes.io/enable-modsecurity: true
Events: <none>
```

Note the `nginx.ingress.kubernetes.io/enable-modsecurity: true` annotation.
Note the `nginx.ingress.kubernetes.io/enable-modsecurity: true` annotation.
2 changes: 1 addition & 1 deletion docs/how-to/install-plugins.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,4 +17,4 @@ juju config wordpress-k8s plugins=<plugin-slug>,<plugin-slug>
```

Once the configuration is complete, you can navigate to `http://<wordpress-unit-ip>/wp-admin/plugins.php` to
verify your new plugin installation.
verify your new plugin installation.
2 changes: 1 addition & 1 deletion docs/how-to/install-themes.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,4 +16,4 @@ juju config wordpress-k8s themes=<theme-slug>,<theme-slug>
```

Once the configuration is complete, you can navigate to `http://<wordpress-unit-ip>/wp-admin/themes.php` to
verify your new theme installation.
verify your new theme installation.
2 changes: 1 addition & 1 deletion docs/how-to/integrate-with-cos.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,4 +53,4 @@ juju run-action grafana-k8s/0 get-admin-password --wait

You can now log into the grafana dashboard by visiting `http://<grafana-unit-ip>:3000`. Navigate to
`http://<grafana-unit-ip>:3000/dashboards` and access the WordPress dashboard named Wordpress Operator
Overview.
Overview.
2 changes: 1 addition & 1 deletion docs/how-to/retrieve-initial-credentials.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,4 +21,4 @@ unit-wordpress-k8s-0:
You can use the password to login to the admin account in `http://<wordpress-unit-ip>/wp-admin.php`.

Note that if `admin_password` value has been passed in the `initial_settings` configuration, the
password from the action is invalid.
password from the action is invalid.
2 changes: 1 addition & 1 deletion docs/how-to/rotate-secrets.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,4 +6,4 @@ To securely update all the WordPress secrets, run the following action.
juju run-action wordpress-k8s/0 rotate-wordpress-secrets –wait
```

This action will force users to be logged out. All sessions and cookies will be invalidated.
This action will force users to be logged out. All sessions and cookies will be invalidated.
26 changes: 12 additions & 14 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -1,33 +1,31 @@
# WordPress Operator
A [Juju](https://juju.is/) [charm](https://juju.is/docs/olm/charmed-operators) deploying and managing WordPress on Kubernetes. [WordPress](https://wordpress.com/) is the world's most popular website builder, and it's free and open-source.

A Juju charm deploying and managing WordPress on Kubernetes. [WordPress](https://wordpress.com/) is the world's most popular website builder, and it's free and open-source.
This charm simplifies initial deployment and "day N" operations of WordPress on Kubernetes, including scaling the number of instances, integration with SSO, access to OpenStack Swift object storage for redundant file storage, and more. It allows for deployment on many different Kubernetes platforms, from [MicroK8s](https://microk8s.io/) to [Charmed Kubernetes](https://ubuntu.com/kubernetes) to public cloud Kubernetes offerings.

This charm simplifies initial deployment and "day N" operations of WordPress on Kubernetes, including scaling the number of instances, integration with SSO, access to OpenStack Swift object storage for redundant file storage and more. It allows for deployment on many different Kubernetes platforms, from [MicroK8s](https://microk8s.io/) to [Charmed Kubernetes](https://ubuntu.com/kubernetes) to public cloud Kubernetes offerings.
As such, the charm makes it easy for those looking to take control of their own content management system whilst keeping operations simple and gives them the freedom to deploy on the Kubernetes platform of their choice.

As such, the charm makes it easy for those looking to take control of their own content management system whilst keeping operations simple, and gives them the freedom to deploy on the Kubernetes platform of their choice.
This charm will make operating WordPress simple and straightforward for DevOps or SRE teams through Juju's clean interface. It will allow easy deployment into multiple environments to test changes and support scaling out for enterprise deployments.

For DevOps or SRE teams this charm will make operating WordPress simple and straightforward through Juju's clean interface. It will allow easy deployment into multiple environments for testing of changes, and supports scaling out for enterprise deployments.
## In this documentation

| | |
|--|--|
| [Tutorials](https://charmhub.io/wordpress-k8s/docs/tutorials-getting-started)</br> Get started - a hands-on introduction to using the Charmed WordPress operator for new users </br> | [How-to guides](https://charmhub.io/wordpress-k8s/docs/how-to-contribute) </br> Step-by-step guides covering key operations and common tasks |
| [Reference](https://charmhub.io/wordpress-k8s/docs/reference-actions) </br> Technical information - specifications, APIs, architecture | [Explanation](https://charmhub.io/wordpress-k8s/docs/explanation-overview) </br> Concepts - discussion and clarification of key topics |

## Contributing to this documentation

Documentation is an important part of this project, and we take the same open-source approach to the documentation as the code. As such, we welcome community contributions, suggestions and constructive feedback on our documentation. Our documentation is hosted on the [Charmhub forum](https://discourse.charmhub.io/t/wordpress-documentation-overview/4052) to enable easy collaboration. Please use the "Help us improve this documentation" links on each documentation page to either directly change something you see that's wrong, ask a question, or make a suggestion about a potential change via the comments section.
Documentation is an important part of this project, and we take the same open-source approach to the documentation as the code. As such, we welcome community contributions, suggestions, and constructive feedback on our documentation. Our documentation is hosted on the [Charmhub forum](https://discourse.charmhub.io/t/wordpress-documentation-overview/4052) to enable easy collaboration. Please use the "Help us improve this documentation" links on each documentation page to either directly change something you see that's wrong, ask a question, or make a suggestion about a potential change via the comments section.

If there's a particular area of documentation that you'd like to see that's missing, please [file a bug](https://github.com/canonical/wordpress-k8s-operator/issues).

## Project and community

The WordPress Operator is a member of the Ubuntu family. It's an open source project that warmly welcomes community projects, contributions, suggestions, fixes and constructive feedback.
The WordPress Operator is a member of the Ubuntu family. It's an open-source project that warmly welcomes community projects, contributions, suggestions, fixes, and constructive feedback.

- [Code of conduct](https://ubuntu.com/community/code-of-conduct)
- [Get support](https://discourse.charmhub.io/)
- [Join our online chat](https://chat.charmhub.io/charmhub/channels/charm-dev)
- [Contribute](Contribute)

Thinking about using the WordPress Operator for your next project? [Get in touch](https://chat.charmhub.io/charmhub/channels/charm-dev)!

## In this documentation

| | |
|--|--|
| [Tutorials](https://charmhub.io/wordpress-k8s/docs/tutorials-getting-started)</br> Get started - a hands-on introduction to using the Charmed Wordpress operator for new users </br> | [How-to guides](https://charmhub.io/wordpress-k8s/docs/how-to-contribute) </br> Step-by-step guides covering key operations and common tasks |
| [Reference](https://charmhub.io/wordpress-k8s/docs/reference-actions) </br> Technical information - specifications, APIs, architecture | [Explanation](https://charmhub.io/wordpress-k8s/docs/explanation-overview) </br> Concepts - discussion and clarification of key topics |
2 changes: 1 addition & 1 deletion docs/reference/actions.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
# Actions

See [Actions](https://charmhub.io/wordpress-k8s/actions).
See [Actions](https://charmhub.io/wordpress-k8s/actions).
2 changes: 1 addition & 1 deletion docs/reference/configurations.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
# Configurations

See [Configure](https://charmhub.io/wordpress-k8s/configure).
See [Configure](https://charmhub.io/wordpress-k8s/configure).
2 changes: 1 addition & 1 deletion docs/reference/integrations.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,4 +60,4 @@ Database endpoint can be related to mysql based charms, providing long term stor
Database relation connect wordpress-k8s with charms that support the `mysql_client` interface on port 3306
in the database side.

Example database relate command: juju relate wordpress-k8s:database mysql-k8s:database
Example database relate command: juju relate wordpress-k8s:database mysql-k8s:database
2 changes: 1 addition & 1 deletion docs/reference/plugins.md
Original file line number Diff line number Diff line change
Expand Up @@ -80,4 +80,4 @@ _\*The descriptions of the following plugins are taken from the WordPress plugin
- [wp-statistics](https://wordpress.org/plugins/wp-statistics/): GDPR compliant website statistics
tool.
- [xubuntu-team-members](https://git.launchpad.net/~canonical-sysadmins/wordpress/+git/wp-plugin-xubuntu-team-members):
Adds the role "Xubuntu Team member"
Adds the role "Xubuntu Team member"
2 changes: 1 addition & 1 deletion docs/reference/themes.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,4 +19,4 @@ By default, the following WordPress themes are installed with the latest version
- [xubuntu-website/xubuntu-eighteen](https://git.launchpad.net/~canonical-sysadmins/wordpress/+git/wp-theme-xubuntu-website)
- [xubuntu-website/xubuntu-fifteen](https://git.launchpad.net/~canonical-sysadmins/wordpress/+git/wp-theme-xubuntu-website)
- [xubuntu-website/xubuntu-fourteen](https://git.launchpad.net/~canonical-sysadmins/wordpress/+git/wp-theme-xubuntu-website)
- [xubuntu-website/xubuntu-thirteen](https://git.launchpad.net/~canonical-sysadmins/wordpress/+git/wp-theme-xubuntu-website)
- [xubuntu-website/xubuntu-thirteen](https://git.launchpad.net/~canonical-sysadmins/wordpress/+git/wp-theme-xubuntu-website)
2 changes: 1 addition & 1 deletion docs/tutorial/getting-started.md → docs/tutorial.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,4 +88,4 @@ model environment that you’ve created using the following command.

```
juju destroy model wordpress-tutorial -y --release-storage
```
```

0 comments on commit ec0c95d

Please sign in to comment.