Skip to content

Commit

Permalink
Merge pull request #78 from stakater/installation-update
Browse files Browse the repository at this point in the history
Updates installation guide
  • Loading branch information
Bharath Nallapeta authored Dec 7, 2023
2 parents 9a38516 + 6eca3c7 commit 5bbe00b
Show file tree
Hide file tree
Showing 5 changed files with 31 additions and 54 deletions.
Binary file added content/images/manual-approve-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added content/images/manual-approve-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added content/images/manual-approve-3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added content/images/manual-approve-4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
85 changes: 31 additions & 54 deletions content/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,11 +6,13 @@ This document contains instructions on installing, uninstalling and configuring

1. [CLI/GitOps](#installing-via-cli-or-gitops)

1. [Enabling Console](#enabling-console)

1. [Uninstall](#uninstall-via-operatorhub-ui)

## Requirements

* An **OpenShift** cluster [v4.7 - v4.12]
* An **OpenShift** cluster [v4.8 - v4.13]

## Installing via OperatorHub UI

Expand Down Expand Up @@ -42,34 +44,6 @@ This document contains instructions on installing, uninstalling and configuring

> Note: MTO will be installed in `multi-tenant-operator` namespace.
### Configuring IntegrationConfig

IntegrationConfig is required to configure the settings of multi-tenancy for MTO.

* We recommend using the following IntegrationConfig as a starting point

```yaml
apiVersion: tenantoperator.stakater.com/v1alpha1
kind: IntegrationConfig
metadata:
name: tenant-operator-config
namespace: multi-tenant-operator
spec:
openshift:
privilegedNamespaces:
- default
- ^openshift-*
- ^kube-*
- ^redhat-*
privilegedServiceAccounts:
- ^system:serviceaccount:default-*
- ^system:serviceaccount:openshift-*
- ^system:serviceaccount:kube-*
- ^system:serviceaccount:redhat-*
```
For more details and configurations check out [IntegrationConfig](./integration-config.md).
## Installing via CLI OR GitOps

* Create namespace `multi-tenant-operator`
Expand Down Expand Up @@ -107,11 +81,7 @@ spec:
name: tenant-operator
source: certified-operators
sourceNamespace: openshift-marketplace
startingCSV: tenant-operator.v0.9.1
config:
env:
- name: ENABLE_CONSOLE
value: 'true'
startingCSV: tenant-operator.v0.10.0
EOF
subscription.operators.coreos.com/tenant-operator created
```
Expand All @@ -134,33 +104,40 @@ subscription.operators.coreos.com/tenant-operator created

![image](./images/to_installed_successful_pod.png)

### Configuring IntegrationConfig
For more details and configurations check out [IntegrationConfig](./integration-config.md).

IntegrationConfig is required to configure the settings of multi-tenancy for MTO.
## Enabling Console

* We recommend using the following IntegrationConfig as a starting point:
To enable console GUI for MTO, go to `Search` -> `IntegrationConfig` -> `tenant-operator-config` and make sure the following fields are set to `true`:

```yaml
apiVersion: tenantoperator.stakater.com/v1alpha1
kind: IntegrationConfig
metadata:
name: tenant-operator-config
namespace: multi-tenant-operator
spec:
openshift:
privilegedNamespaces:
- default
- ^openshift-*
- ^kube-*
- ^redhat-*
privilegedServiceAccounts:
- ^system:serviceaccount:default-*
- ^system:serviceaccount:openshift-*
- ^system:serviceaccount:kube-*
- ^system:serviceaccount:redhat-*
provision:
console: true
showback: true
```
For more details and configurations check out [IntegrationConfig](./integration-config.md).
> Note: If your `InstallPlan` approval is set to `Manual` then you will have to manually approve the `InstallPlan` for MTO console components to be installed.

### Manual Approval

* Open OpenShift console and click on `Operators`, followed by `Installed Operators` from the side menu.

![image](./images/manual-approve-1.png)

* Now click on `Upgrade available` in front of `mto-opencost` or `mto-prometheus`.

![image](./images/manual-approve-2.png)

* Now click on `Preview InstallPlan` on top.

![image](./images/manual-approve-3.png)

* Now click on `Approve` button.

![image](./images/manual-approve-4.png)

* Now the `InstallPlan` will be approved, and MTO console components will be installed.

## Uninstall via OperatorHub UI

Expand Down

0 comments on commit 5bbe00b

Please sign in to comment.