Project

General

Profile

How to install Redmine on IBM Cloud kubernetes cluster » History » Version 9

Oliver Pinter, 2020-10-26 15:25

1 2 Oliver Pinter
h1. Get Redmine on IBM Cloud
2
3 8 Oliver Pinter
You should have an IBM Cloud account, otherwise you can "register here":http://cloud.ibm.com/registration .
4
At the end of the tutorial you will have a cluster with  Redmine up and running.
5 2 Oliver Pinter
6
1. We will provision a new Kubernetes Cluster for you if, you already have one skip to step **2**
7
2. We will deploy  the IBM Cloud Block Storage plug-in, if already have it skip to step **3**
8 8 Oliver Pinter
3. Redmine deployment
9 2 Oliver Pinter
10
h2. Step 1 provision Kubernetes Cluster
11
12
* Click the **Catalog** button on the top 
13
* Select **Service** from the catalog
14
* Search for **Kubernetes Service** and click on it
15 4 Oliver Pinter
!kubernetes-select.png!
16 2 Oliver Pinter
* You are now at the Kubernetes deployment page, you need to specify some details about the cluster 
17
* 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 
18
  * To upgrade to a Pay-As-You-Go account, complete the following steps:
19
20
  * In the console, go to Manage > Account.
21
  * Select Account settings, and click Add credit card.
22
  * Enter your payment information, click Next, and submit your information
23 8 Oliver Pinter
* Choose **classic** or **VPC**, read the "docs":https://cloud.ibm.com/docs/containers?topic=containers-infrastructure_providers and choose the most suitable type for yourself 
24 4 Oliver Pinter
 !infra-select.png!
25 8 Oliver Pinter
* Now choose your location settings, for more information please visit "Locations":https://cloud.ibm.com/docs/containers?topic=containers-regions-and-zones#zones
26 2 Oliver Pinter
  * Choose **Geography** (continent)
27 4 Oliver Pinter
!location-geo.png!
28 5 Oliver Pinter
  * 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 unforeseen zone failure 
29 4 Oliver Pinter
!location-avail.png!
30 2 Oliver Pinter
  * Choose a **Worker Zone** if using Single zones or **Metro** if Multizone
31 4 Oliver Pinter
 !location-worker.png!
32 8 Oliver Pinter
    * If you wish to use Multizone please set up your account with "VRF":https://cloud.ibm.com/docs/dl?topic=dl-overview-of-virtual-routing-and-forwarding-vrf-on-ibm-cloud or "enable Vlan spanning":https://cloud.ibm.com/docs/vlans?topic=vlans-vlan-spanning#vlan-spanning
33 2 Oliver Pinter
    * If at your current location selection, there is no available Virtual LAN, a new Vlan will be created for you 
34
 
35
* Choose a **Worker node setup** or use the preselected one, set **Worker node amount per zone**
36 4 Oliver Pinter
!worker-pool.png!
37 8 Oliver Pinter
* 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":https://cloud.ibm.com/docs/account?topic=account-service-endpoints-overview .
38 4 Oliver Pinter
!endpoints.png
39 2 Oliver Pinter
* Give cluster a **name**
40
41 4 Oliver Pinter
!name-new.png!
42 8 Oliver Pinter
* Give desired **tags** to your cluster, for more information visit "tags":https://cloud.ibm.com/docs/account?topic=account-tag
43 2 Oliver Pinter
44 4 Oliver Pinter
!tasg-new.png
45 2 Oliver Pinter
* Click **create**
46 4 Oliver Pinter
!create-new.png!
47 2 Oliver Pinter
48
* Wait for you cluster to be provisioned 
49 4 Oliver Pinter
!cluster-prepare.png!
50 2 Oliver Pinter
* Your cluster is ready for usage 
51
52 4 Oliver Pinter
!cluster-done.png!
53 2 Oliver Pinter
54 3 Oliver Pinter
h2. Step 2 deploy IBM Cloud Block Storage plug-in
55 6 Oliver Pinter
56 2 Oliver Pinter
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).
57
 
58
* Click the **Catalog** button on the top 
59
* Select **Software** from the catalog
60
* Search for **IBM Cloud Block Storage plug-in** and click on it
61 9 Oliver Pinter
!block-search.png!
62 2 Oliver Pinter
63 8 Oliver Pinter
* On the application page Click in the dot next to the cluster, you wish to use
64 2 Oliver Pinter
* 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)
65 4 Oliver Pinter
!block-cluster.png!
66 2 Oliver Pinter
* Give a **name** to this workspace 
67
* Click **install** and wait for the deployment
68 4 Oliver Pinter
!block-storage-create.png!
69 2 Oliver Pinter
 
70
71 3 Oliver Pinter
h2. Step 3 deploy  Redmine
72 2 Oliver Pinter
  
73
We will deploy   Redmine on our cluster 
74
  
75
* Click the **Catalog** button on the top 
76
* Select **Software** from the catalog
77 1 Oliver Pinter
* Search for ** Redmine** and click on it
78 6 Oliver Pinter
!search.png!
79 2 Oliver Pinter
80
* Please select IBM Kubernetes Service
81 4 Oliver Pinter
!target-select.png!
82 2 Oliver Pinter
83
* On the application page Click in the _dot_ next to the cluster, you wish to use
84 4 Oliver Pinter
!cluster-select.png!
85 2 Oliver Pinter
* Click on  **Enter or Select Namespace** and choose the default Namespace or use a custom one 
86 4 Oliver Pinter
!details-namespace.png!
87 2 Oliver Pinter
* Give a unique **name** to workspace, which you can easily recognize
88 4 Oliver Pinter
!details-name.png!
89 8 Oliver Pinter
* Select which resource group you want to use, it's for access control and billing purposes. For more information please visit "resource groups":https://cloud.ibm.com/docs/account?topic=account-account_setup#bp_resourcegroups
90 2 Oliver Pinter
91 4 Oliver Pinter
!details-resource.png!
92 2 Oliver Pinter
93 8 Oliver Pinter
* Give **tags** to your  Redmine, for more information visit "tags":https://cloud.ibm.com/docs/account?topic=account-tag
94 2 Oliver Pinter
95 4 Oliver Pinter
!details-tags.png!
96 2 Oliver Pinter
97
* Click on **Parameters with default values**, You can set deployment values or use the default ones
98
99 4 Oliver Pinter
!parameters.png!
100 2 Oliver Pinter
101
* Please set the  Redmine password in the parameters
102 4 Oliver Pinter
!password.png!
103 2 Oliver Pinter
104
* After finishing everything, **tick** the box next to the agreements and click **install**
105
106 3 Oliver Pinter
!aggreement-create.png!
107 2 Oliver Pinter
108
* The  Redmine workspace will start installing, wait a couple of minutes 
109
110 4 Oliver Pinter
!in-progress.png!
111 2 Oliver Pinter
112
* Your   Redmine workspace has been successfully deployed
113
114 4 Oliver Pinter
!done.png!
115 2 Oliver Pinter
116 3 Oliver Pinter
h2. Verify  Redmine installation
117 2 Oliver Pinter
118 8 Oliver Pinter
* Go to "Resources":http://cloud.ibm.com/resources in your browser 
119 2 Oliver Pinter
* Click on **Clusters**
120
* Click on your Cluster
121 4 Oliver Pinter
!resource-select.png!
122 2 Oliver Pinter
123
* Now you are at you clusters overview, here Click on **Actions** and **Web terminal** from the dropdown menu
124
125
126 4 Oliver Pinter
!cluster-main.png!
127 2 Oliver Pinter
128
* Click **install** - wait couple of minutes 
129
130 4 Oliver Pinter
!terminal-install.jpg!
131 2 Oliver Pinter
132
* Click on **Actions**
133
* Click **Web terminal** --> a terminal will open up
134
135
* **Type** in the terminal, please change NAMESPACE to the namespace you choose at the deployment setup:
136
137 9 Oliver Pinter
<pre>
138 2 Oliver Pinter
$ kubectl get ns
139 9 Oliver Pinter
</pre>
140 4 Oliver Pinter
!get-ns.png!
141 2 Oliver Pinter
142
143 9 Oliver Pinter
<pre>
144 2 Oliver Pinter
$ kubectl get pod -n NAMESPACE -o wide 
145 9 Oliver Pinter
</pre>
146 2 Oliver Pinter
!get-pod.png!
147
148 9 Oliver Pinter
<pre>
149 2 Oliver Pinter
$ kubectl get service -n NAMESPACE
150 9 Oliver Pinter
</pre>
151 4 Oliver Pinter
!get-service.png!
152 2 Oliver Pinter
153
* Running Redmine service will be visible 
154
* Copy the **External ip**, you can access the website on this IP
155
* Paste it into your browser
156
* Redmine welcome message will be visible
157
158
!welcome.png!
159
160
* Enter you password/username which you entered in the deployment step (default username is user)
161
162
!login.png!
163
164
* You arrived at the main Redmine page
165
166
!logged-in.png!
167
168
 
169
You have succesfully deployed  Redmine IBM Cloud!