How to install Redmine on IBM Cloud kubernetes cluster » History » Revision 3
Revision 2 (Oliver Pinter, 2020-10-26 14:47) → Revision 3/9 (Oliver Pinter, 2020-10-26 14:57)
h1. Get Redmine on IBM Cloud You should have an IBM Cloud account, otherwise you can [register here]. At the end of the tutorial you will have a cluster with Redmine up and runnning. 1. We will provision a new Kubernetes Cluster for you if, you already have one skip to step **2** 2. We will deploy the IBM Cloud Block Storage plug-in, if already have it skip to step **3** 3. Redmine deployment h2. Step 1 provision Kubernetes Cluster * Click the **Catalog** button on the top * Select **Service** from the catalog * Search for **Kubernetes Service** and click on it ![Kubernetes](/kubernetes-select.png) * You are now at the Kubernetes deployment page, you need to specify some details about the cluster * Choose a plan **standard** or **free**, the free plan only has one worker node and no subnet, to provision a standard cluster, you will need to upgrade you account to Pay-As-You-Go * To upgrade to a Pay-As-You-Go account, complete the following steps: * In the console, go to Manage > Account. * Select Account settings, and click Add credit card. * Enter your payment information, click Next, and submit your information * Choose **classic** or **VPC**, read the [docs] and choose the most suitable type for yourself ![VPC](/infra-select.png) * Now choose your location settings, for more information please visit [Locations] * Choose **Geography** (continent) ![continent](/location-geo.png) * Choose **Single** or **Multizone**, in single zone your data is only kept in on datacenter, on the other hand with Multizone it is distributed to multiple zones, thus safer in an unforseen zone failure ![avail](/location-avail.png) * Choose a **Worker Zone** if using Single zones or **Metro** if Multizone ![worker](/location-worker.png) * If you wish to use Multizone please set up your account with [VRF] or [enable Vlan spanning] * If at your current location selection, there is no available Virtual LAN, a new Vlan will be created for you * Choose a **Worker node setup** or use the preselected one, set **Worker node amount per zone** ![worker-pool](/worker-pool.png) * Choose **Master Service Endpoint**, In VRF-enabled accounts, you can choose private-only to make your master accessible on the private network or via VPN tunnel. Choose public-only to make your master publicly accessible. When you have a VRF-enabled account, your cluster is set up by default to use both private and public endpoints. For more information visit [endpoints]. ![endpoints](/endpoints.png) * Give cluster a **name** ![name-new](/name-new.png) * Give desired **tags** to your cluster, for more information visit [tags] ![tags-new](/tasg-new.png) * Click **create** ![create-new](/create-new.png) * Wait for you cluster to be provisioned ![cluster-prepare](/cluster-prepare.png) * Your cluster is ready for usage ![cluster-ready](/cluster-done.png) h2. ## Step 2 deploy IBM Cloud Block Storage plug-in The Block Storage plug-in is a persistent, high-performance iSCSI storage that you can add to your apps by using Kubernetes Persistent Volumes (PVs). * Click the **Catalog** button on the top * Select **Software** from the catalog * Search for **IBM Cloud Block Storage plug-in** and click on it ![Block](/block-search.png) * On the application page Click in the _dot_ next to the cluster, you wish to use * Click on **Enter or Select Namespace** and choose the default Namespace or use a custom one (if you get error please wait 30 minutes for the cluster to finalize) ![block-c](/block-cluster.png) * Give a **name** to this workspace * Click **install** and wait for the deployment ![block-create](/block-storage-create.png) h2. ## Step 3 deploy Redmine We will deploy Redmine on our cluster * Click the **Catalog** button on the top * Select **Software** from the catalog * Search for ** Redmine** and click on it ![postg](/search.png) * Please select IBM Kubernetes Service ![target](/target-select.png) * On the application page Click in the _dot_ next to the cluster, you wish to use ![Cluster](/cluster-select.png) * Click on **Enter or Select Namespace** and choose the default Namespace or use a custom one ![Namespace](/details-namespace.png) * Give a unique **name** to workspace, which you can easily recognize ![Name](/details-name.png) * Select which resource group you want to use, it's for access controll and billing purposes. For more information please visit [resource groups] ![dr-resource](/details-resource.png) * Give **tags** to your Redmine, for more information visit [tags] ![redmine-tags](/details-tags.png) * Click on **Parameters with default values**, You can set deployment values or use the default ones ![def-val](/parameters.png) * Please set the Redmine password in the parameters ![pass](/password.png) * After finishing everything, **tick** the box next to the agreements and click **install** !aggreement-create.png! ![Install](/aggreement-create.png) * The Redmine workspace will start installing, wait a couple of minutes ![ Redmine-install](/in-progress.png) * Your Redmine workspace has been successfully deployed ![Redmine-finsihed](/done.png) h2. ## Verify Redmine installation * Go to [Resources] in your browser * Click on **Clusters** * Click on your Cluster ![Resourcelect](/resource-select.png) * Now you are at you clusters overview, here Click on **Actions** and **Web terminal** from the dropdown menu ![Actions](/cluster-main.png) * Click **install** - wait couple of minutes ![terminal-install](/terminal-install.jpg) * Click on **Actions** * Click **Web terminal** --> a terminal will open up * **Type** in the terminal, please change NAMESPACE to the namespace you choose at the deployment setup: ```sh $ kubectl get ns ``` ![get-ns](/get-ns.png) ```sh $ kubectl get pod -n NAMESPACE -o wide ``` ![get-pod](/get-pod.png) ```sh $ kubectl get service -n NAMESPACE ``` ![get-service](/get-service.png) * Running Redmine service will be visible * Copy the **External ip**, you can access the website on this IP * Paste it into your browser * Redmine welcome message will be visible ![works](/welcome.png) * Enter you password/username which you entered in the deployment step (default username is user) ![login](/login.png) * You arrived at the main Redmine page ![in](/logged-in.png) You have succesfully deployed Redmine IBM Cloud! [IBM Cloud]: <http://cloud.ibm.com> [Resources]: <http://cloud.ibm.com/resources> [Register Here]: <http://cloud.ibm.com/registration> [docs]: <https://cloud.ibm.com/docs/containers?topic=containers-infrastructure_providers> [Locations]: <https://cloud.ibm.com/docs/containers?topic=containers-regions-and-zones#zones> [VRF]: <https://cloud.ibm.com/docs/dl?topic=dl-overview-of-virtual-routing-and-forwarding-vrf-on-ibm-cloud> [enable Vlan spanning]: <https://cloud.ibm.com/docs/vlans?topic=vlans-vlan-spanning#vlan-spanning> [endpoints]: <https://cloud.ibm.com/docs/account?topic=account-service-endpoints-overview> [tags]: <https://cloud.ibm.com/docs/account?topic=account-tag>