How to install Redmine on IBM Cloud kubernetes cluster » History » Version 3
Oliver Pinter, 2020-10-26 14:57
1 | 2 | Oliver Pinter | h1. Get Redmine on IBM Cloud |
---|---|---|---|
2 | |||
3 | You should have an IBM Cloud account, otherwise you can [register here]. |
||
4 | At the end of the tutorial you will have a cluster with Redmine up and runnning. |
||
5 | |||
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 | 3. Redmine deployment |
||
9 | |||
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 |  |
||
16 | * 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 | * Choose **classic** or **VPC**, read the [docs] and choose the most suitable type for yourself |
||
24 |  |
||
25 | * Now choose your location settings, for more information please visit [Locations] |
||
26 | * Choose **Geography** (continent) |
||
27 |  |
||
28 | * 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 |
||
29 |  |
||
30 | * Choose a **Worker Zone** if using Single zones or **Metro** if Multizone |
||
31 |  |
||
32 | * If you wish to use Multizone please set up your account with [VRF] or [enable Vlan spanning] |
||
33 | * 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 |  |
||
37 | * 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]. |
||
38 |  |
||
39 | * Give cluster a **name** |
||
40 | |||
41 |  |
||
42 | * Give desired **tags** to your cluster, for more information visit [tags] |
||
43 | |||
44 |  |
||
45 | * Click **create** |
||
46 |  |
||
47 | |||
48 | * Wait for you cluster to be provisioned |
||
49 |  |
||
50 | * Your cluster is ready for usage |
||
51 | |||
52 |  |
||
53 | |||
54 | 3 | Oliver Pinter | h2. Step 2 deploy IBM Cloud Block Storage plug-in |
55 | 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). |
56 | |||
57 | * Click the **Catalog** button on the top |
||
58 | * Select **Software** from the catalog |
||
59 | * Search for **IBM Cloud Block Storage plug-in** and click on it |
||
60 |  |
||
61 | |||
62 | * On the application page Click in the _dot_ next to the cluster, you wish to use |
||
63 | * 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) |
||
64 |  |
||
65 | * Give a **name** to this workspace |
||
66 | * Click **install** and wait for the deployment |
||
67 |  |
||
68 | |||
69 | |||
70 | 3 | Oliver Pinter | h2. Step 3 deploy Redmine |
71 | 2 | Oliver Pinter | |
72 | We will deploy Redmine on our cluster |
||
73 | |||
74 | * Click the **Catalog** button on the top |
||
75 | * Select **Software** from the catalog |
||
76 | * Search for ** Redmine** and click on it |
||
77 |  |
||
78 | |||
79 | * Please select IBM Kubernetes Service |
||
80 |  |
||
81 | |||
82 | * On the application page Click in the _dot_ next to the cluster, you wish to use |
||
83 |  |
||
84 | * Click on **Enter or Select Namespace** and choose the default Namespace or use a custom one |
||
85 |  |
||
86 | * Give a unique **name** to workspace, which you can easily recognize |
||
87 |  |
||
88 | * Select which resource group you want to use, it's for access controll and billing purposes. For more information please visit [resource groups] |
||
89 | |||
90 |  |
||
91 | |||
92 | * Give **tags** to your Redmine, for more information visit [tags] |
||
93 | |||
94 |  |
||
95 | |||
96 | * Click on **Parameters with default values**, You can set deployment values or use the default ones |
||
97 | |||
98 |  |
||
99 | |||
100 | * Please set the Redmine password in the parameters |
||
101 |  |
||
102 | |||
103 | * After finishing everything, **tick** the box next to the agreements and click **install** |
||
104 | |||
105 | 3 | Oliver Pinter | !aggreement-create.png! |
106 | 2 | Oliver Pinter | |
107 | * The Redmine workspace will start installing, wait a couple of minutes |
||
108 | |||
109 |  |
||
110 | |||
111 | * Your Redmine workspace has been successfully deployed |
||
112 | |||
113 |  |
||
114 | |||
115 | 3 | Oliver Pinter | h2. Verify Redmine installation |
116 | 2 | Oliver Pinter | |
117 | * Go to [Resources] in your browser |
||
118 | * Click on **Clusters** |
||
119 | * Click on your Cluster |
||
120 |  |
||
121 | |||
122 | * Now you are at you clusters overview, here Click on **Actions** and **Web terminal** from the dropdown menu |
||
123 | |||
124 | |||
125 |  |
||
126 | |||
127 | * Click **install** - wait couple of minutes |
||
128 | |||
129 |  |
||
130 | |||
131 | * Click on **Actions** |
||
132 | * Click **Web terminal** --> a terminal will open up |
||
133 | |||
134 | * **Type** in the terminal, please change NAMESPACE to the namespace you choose at the deployment setup: |
||
135 | |||
136 | ```sh |
||
137 | $ kubectl get ns |
||
138 | ``` |
||
139 |  |
||
140 | |||
141 | |||
142 | ```sh |
||
143 | $ kubectl get pod -n NAMESPACE -o wide |
||
144 | ``` |
||
145 |  |
||
146 | |||
147 | |||
148 | ```sh |
||
149 | $ kubectl get service -n NAMESPACE |
||
150 | ``` |
||
151 |  |
||
152 | |||
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 |  |
||
159 | |||
160 | * Enter you password/username which you entered in the deployment step (default username is user) |
||
161 | |||
162 |  |
||
163 | |||
164 | * You arrived at the main Redmine page |
||
165 | |||
166 |  |
||
167 | |||
168 | |||
169 | You have succesfully deployed Redmine IBM Cloud! |
||
170 | |||
171 | |||
172 | |||
173 | |||
174 | [IBM Cloud]: <http://cloud.ibm.com> |
||
175 | [Resources]: <http://cloud.ibm.com/resources> |
||
176 | [Register Here]: <http://cloud.ibm.com/registration> |
||
177 | [docs]: <https://cloud.ibm.com/docs/containers?topic=containers-infrastructure_providers> |
||
178 | [Locations]: <https://cloud.ibm.com/docs/containers?topic=containers-regions-and-zones#zones> |
||
179 | [VRF]: <https://cloud.ibm.com/docs/dl?topic=dl-overview-of-virtual-routing-and-forwarding-vrf-on-ibm-cloud> |
||
180 | [enable Vlan spanning]: <https://cloud.ibm.com/docs/vlans?topic=vlans-vlan-spanning#vlan-spanning> |
||
181 | [endpoints]: <https://cloud.ibm.com/docs/account?topic=account-service-endpoints-overview> |
||
182 | [tags]: <https://cloud.ibm.com/docs/account?topic=account-tag> |