mirror of
https://github.com/bitnami/charts.git
synced 2026-03-04 06:47:57 +08:00
132 lines
5.5 KiB
Markdown
132 lines
5.5 KiB
Markdown
# _Application_
|
|
|
|
- _Short introduction to the application deployed by the chart with link to the project homepage_
|
|
|
|
> **Sample**
|
|
>
|
|
> [MediaWiki](https://www.mediawiki.org) is an extremely powerful, scalable software and a feature-rich wiki implementation that uses PHP to process and display data stored in a database, such as MySQL.
|
|
|
|
## TL;DR;
|
|
|
|
- _List the `helm install` command required to deployed the chart_
|
|
|
|
> **Sample**
|
|
>
|
|
> ```bash
|
|
> $ helm install my-release stable/mediawiki
|
|
> ```
|
|
|
|
## Introduction
|
|
|
|
- _A brief introduction to the chart and the chart(s) it depends upon._
|
|
|
|
> **Sample**
|
|
>
|
|
> This chart bootstraps a MediaWiki deployment on a [Kubernetes](http://kubernetes.io) cluster using the [Helm](https://helm.sh) package manager. The chart depends upon the [MariaDB chart](https://github.com/helm/charts/tree/master/stable/mariadb) for the database requirements of MediaWiki.
|
|
>
|
|
> The chart uses the [Bitnami MediaWiki Docker Image](https://hub.docker.com/r/bitnami/mediawiki) for setting up the MediaWiki deployment and is developed, contributed and maintained by [Bitnami](https://bitnami.com).
|
|
|
|
## Prerequisites
|
|
|
|
_List the cluster requirements for a successful deployment of the chart_
|
|
|
|
> **Sample**
|
|
>
|
|
> - Kubernetes 1.4+ with Beta APIs enabled
|
|
> - PV provisioner support in the underlying infrastructure
|
|
|
|
## Installing
|
|
|
|
- _Provide chart deployment instructions. This may include steps to pull chart dependencies and so on._
|
|
- _Use a release name in the `helm install` commands and refer to it in the upgrading and uninstalling sections._
|
|
- _Link to the configuration section for customizing a chart deployment._
|
|
|
|
|
|
> **Sample**
|
|
>
|
|
> Install the chart using:
|
|
>
|
|
> ```bash
|
|
> $ helm install my-release stable/mediawiki
|
|
> ```
|
|
>
|
|
> The command deploys MediaWiki on the Kubernetes cluster in the default configuration and with the release name `my-release`. The deployment configuration can be customized by specifying the customization parameters with the `helm install` command using the `--values` or `--set` arguments. Find more information in the [configuration section](#configuration) of this document.
|
|
|
|
## Upgrading
|
|
|
|
- _Provide instructions to upgrade a chart deployment using the `helm upgrade` commands_
|
|
|
|
> **Sample**
|
|
>
|
|
> Upgrade the chart deployment using:
|
|
>
|
|
> ```bash
|
|
> $ helm upgrade my-release stable/mediawiki
|
|
> ```
|
|
>
|
|
> The command upgrades the existing `my-release` deployment with the most latest release of the chart.
|
|
>
|
|
> **TIP**: Use `helm repo update` to update information on available charts in the chart repositories.
|
|
|
|
## Uninstalling
|
|
|
|
- _Provide instructions to uninstall a chart deployment from the cluster_
|
|
|
|
> **Sample**
|
|
>
|
|
> Uninstall the `my-release` deployment using:
|
|
>
|
|
> ```bash
|
|
> $ helm delete my-release
|
|
> ```
|
|
>
|
|
> The command deletes the release named `my-release` and frees all the kubernetes resources associated with the release.
|
|
>
|
|
> **TIP**: _Specify the `--purge`_ argument to the above command to remove the release from the store and make its name free for later use.
|
|
|
|
## Configuration
|
|
|
|
- _Insert a table listing all the configurations that can be customized via the `values.yaml` file._
|
|
- _**TIP**: The `Table Editor` plugin for SublimeText is useful for creating and updating this table_
|
|
- _Provide information on how to specify these parameters, ie. using a `myvals.yml` file or using the `--set` option and possibly an example_
|
|
|
|
> **Sample**
|
|
>
|
|
> The following table lists all the configurable parameters expose by the MediaWiki chart and their default values.
|
|
>
|
|
> | Name | Decription | Default |
|
|
> |-------------------------------|------------------------------|------------------------------------------|
|
|
> | `mediawikiUser` | Admin user name | `user` |
|
|
> | `mediawikiPassword` | Admin user password | _randomly generated alphanumeric string_ |
|
|
> | `mediawikiEmail` | Admin user email | `user@example.com` |
|
|
> | `mariadb.mariadbRootPassword` | MariaDB admin password | _no password_ |
|
|
> | `persistence.enabled` | Enable persistence using PVC | `true` |
|
|
>
|
|
> Specify the parameters you which to customize using the `--set` argument to the `helm install` command. For instance,
|
|
>
|
|
> ```bash
|
|
> $ helm install my-release \
|
|
> --set mediawikiUser=admin,mediawikiPassword=password stable/mediawiki
|
|
> ```
|
|
>
|
|
> The above command sets the MediaWiki administrator account username and password to `admin` and `password` respectively.
|
|
>
|
|
> Alternatively, a YAML file that specifies the values for the above parameters can be provided while installing the chart. For example,
|
|
>
|
|
> ```bash
|
|
> $ helm install my-release \
|
|
> --values values.yaml stable/mediawiki
|
|
> ```
|
|
>
|
|
> **Tip**: You can use the default [values.yaml](values.yaml).
|
|
|
|
## Persistence
|
|
|
|
- _Describe how the chart handles persistence and the options to enable/disable persistence_
|
|
|
|
> **Sample**
|
|
>
|
|
> The [Bitnami MediaWiki Docker Image](https://hub.docker.com/r/bitnami/mediawiki) saves persistent data in the `/bitnami/mediawiki` and `/bitnami/apache` paths of the container. The chart makes use of [Persistent Volumes Claims](http://kubernetes.io/docs/user-guide/persistent-volumes/#persistentvolumeclaims) to set up data persistence across chart upgrades and is known to work in GKE, AWS and Minikube Kubernetes cluster setups.
|
|
>
|
|
> See the [configuration section](#configuration) to configure the PVC or to disable persistence.
|