Skip to content

Commit db948ec

Browse files
author
Sean Sundberg
authored
Adds guide to install the toolkit (#273)
Signed-off-by: Sean Sundberg <[email protected]>
1 parent 375b7ec commit db948ec

File tree

2 files changed

+56
-1
lines changed

2 files changed

+56
-1
lines changed

docs/developer-intermediate/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -124,7 +124,7 @@ The learning tasks help you understand the Developer Experience with IBM RedHat
124124
| [Inventory BFF](inventory-bff/) | Creating the Inventory BFF with GraphQL | | 25 mins | |
125125
| [Inventory UI](inventory-ui/) | Creating the UI microservice | | 25 mins | |
126126
| [Inventory Backend with Cloudant](../developer-advanced-1/database-with-cloudant/)| Cloudant Database integration | | 30 mins | |
127-
127+
| [Install the toolkit](../guides/toolkit-install/)| Install the Cloud-Native Toolkit in your cluster | | 30 mins | |
128128

129129
!!! success
130130

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
---
2+
title: Cloud-Native Toolkit installation
3+
---
4+
5+
The Cloud-Native Toolkit is available as a simple installation on top of an OpenShift cluster.
6+
7+
### 1. Provision the infrastructure
8+
9+
There are several options for getting the infrastructure
10+
11+
#### TechZone infrastructure
12+
13+
IBM TechZone provides infrastructure for education or demonstration purposes.
14+
Several managed environments are available. For IBM Cloud OpenShift, use this
15+
collection: https://techzone.ibm.com/collection/roks-basics-lab#tab-1
16+
17+
#### Provisioned infrastructure
18+
19+
The Cloud-Native Toolkit provides automation solutions to provision
20+
infrastructure on IBM Cloud, AWS, or Azure. Each option requires a cloud account
21+
with necessary permissions in order to run. Follow the instructions in the
22+
repository to provision the environment.
23+
24+
- https://github.com/IBM/automation-ibmcloud-infra-openshift
25+
- https://github.com/IBM/automation-azure-infra-openshift
26+
- https://github.com/IBM/automation-aws-infra-openshift
27+
28+
#### Bring your own cluster
29+
30+
If you have an existing cluster that was provisioned manually or through some other means, you can use it to install the Toolkit. Make sure you have the server url and the credentials for a user that has sufficient permissions to create namespaces and RBAC rules in the cluster.
31+
32+
### 2. Install the Toolkit into the cluster
33+
34+
To install the toolkit perform the following steps:
35+
36+
1. In a command or terminal window ensure you are logged onto your cluster (oc login or kubectl login) with an admin account with the ability to create new namespaces/projects on the cluster and setup RBAC security.
37+
38+
2. Run the following command (choose your operating system):
39+
40+
**For Linux / MacOS**
41+
42+
```
43+
curl -sfL get.cloudnativetoolkit.dev | sh -
44+
```
45+
46+
**For Windows**
47+
48+
```
49+
oc create -f https://raw.githubusercontent.com/cloud-native-toolkit/ibm-garage-iteration-zero/master/install/install-ibm-toolkit.yaml
50+
sleep 5
51+
oc wait pod -l job-name=ibm-toolkit --for=condition=Ready -n default
52+
oc logs job/ibm-toolkit -f -n default
53+
```
54+
55+
3. Wait for the automation scripts to complete the installation of the toolkit - this can take several minutes

0 commit comments

Comments
 (0)