Chapter 1. Installing and preparing the OpenStack Operator

Procedure

1. Log in to the RHOCP web console as a user with cluster-admin permissions.
2. Select Operators OperatorHub.
3. In the Filter by keyword field, type OpenStack.
4. Click the OpenStack Operator tile with the Red Hat source label.
5. Read the information about the Operator and click Install.
6. On the Install Operator page, select "Operator recommended Namespace: openstack-operators" from the Installed Namespace list.
7. On the Install Operator page, select "Manual" from the Update approval list. For information about how to manually approve a pending Operator update, see Manually approving a pending Operator update in the RHOCP Operators guide.
8. Click Install to make the Operator available to the openstack-operators namespace. The OpenStack Operator is installed when the Status is Succeeded.
9. Click Create OpenStack to open the Create OpenStack page.
10. On the Create OpenStack page, click Create to create an instance of the OpenStack Operator initialization resource. The OpenStack Operator is ready to use when the Status of the openstack instance is Conditions: Ready.

Procedure

1. Create the openstack-operators namespace for the RHOSP operators:

   $ cat << EOF | oc apply -f -
   apiVersion: v1
   kind: Namespace
   metadata:
     name: openstack-operators
   spec:
     finalizers:
     - kubernetes
   EOF

2. Create the OperatorGroup CR in the openstack-operators namespace:

   $ cat << EOF | oc apply -f -
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: openstack
     namespace: openstack-operators
   EOF

3. Create the Subscription CR that subscribes to openstack-operator:

   $ cat << EOF| oc apply -f -
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: openstack-operator
     namespace: openstack-operators
   spec:
     name: openstack-operator
     channel: stable-v1.0
     source: redhat-operators
     sourceNamespace: openshift-marketplace
     installPlanApproval: Manual
   EOF

4. Wait for the install plan to be created:

   $ oc get installplan -n openstack-operators -o json | jq -r '.items[] | select(.spec.approval=="Manual" and .spec.approved==false) | .metadata.name' | head -n1

5. Approve the install plan:

   $ oc patch installplan <install_plan_name> -n openstack-operators --type merge -p '{"spec":{"approved":true}}'

6. Verify that the OpenStack Operator is installed:

   $ oc wait csv -n openstack-operators \
    -l operators.coreos.com/openstack-operator.openstack-operators="" \
    --for jsonpath='{.status.phase}'=Succeeded

7. Create an instance of the openstack-operator:

   $ cat << EOF | oc apply -f -
   apiVersion: operator.openstack.org/v1beta1
   kind: OpenStack
   metadata:
     name: openstack
     namespace: openstack-operators
   EOF

8. Confirm that the Openstack Operator is deployed:

   $ oc wait openstack/openstack -n openstack-operators --for condition=Ready --timeout=500s