Merge pull request #549 from agrare/update_openshift_dev_guide

Update openshift developer setup guide

Author: Fryguy

providers/openshift.md

@@ -5,7 +5,7 @@ provider for ManageIQ:
 
 - using [openshift-ansible](https://github.com/openshift/openshift-ansible) to
   deploy RPM packages on a cluster
-- using [minishift](https://github.com/minishift/minishift) to deploy
+- using [CodeReady Containers](https://github.com/crc-org/crc) to deploy
   openshift source to a vm
 
 You can also use `oc cluster up` and configure it yourself (instructions not
@@ -38,14 +38,14 @@ example file for a cluster composed of two machines (Master and Node):
 [OSEv3:children]
 masters
 nodes
- 
+
 [OSEv3:vars]
 ansible_ssh_user=root
 deployment_type=origin
- 
+
 [masters]
 master_hostname openshift_scheduleable=True
- 
+
 [nodes]
 master_hostname
 node_hostname
@@ -61,82 +61,6 @@ logging use `openshift_hosted_metrics_deploy=True` and
 $ ansible-playbook playbooks/byo/config.yml -i path/to/inventory/file
 ```
 
-
-### Running with minishift
-
-
-For a simple single host setup for working with the openshift provider locally,
-you can use [`minishift`](https://github.com/minishift/minishift) to run a
-local openshift 3.x instance.
-
-
-#### Requirements
-
-* [`minishift`](https://github.com/minishift/minishift) >= 1.0.0.rc1 ([Installation Instructions](https://docs.openshift.org/latest/minishift/getting-started/installing.html#installing-instructions))
-* Virtualization host of your choice (see supported hypervisors [here](https://docs.openshift.org/latest/minishift/getting-started/installing.html#install-prerequisites))
-
-
-#### Quickstart
-
-Since VirtualBox is a consistent hypervisor across all platforms, this guide
-will assume that is being used, and updates to some commands might be
-necessary (most commands should be virtualization software agnostic and work
-regardless of the hypervisor).
-
-1. Download and enable the manageiq addon for minishift:
-  
-   ```console
-   $ mkdir -p ~/minishift/addons
-   $ git clone https://gist.github.com/e2fac8be87ea0e9f429b6f5d75e02176 ~/minishift/addons/manageiq
-   $ minishift addons install --force ~/minishift/addons/manageiq
-   $ minishift addons enable manageiq
-   ```
-   
-2. Start minishift:
-   
-   ```console
-   $ minishift start --vm-driver virtualbox --openshift-version "v3.6.1"
-   ```
-   
-   You might want to add `--metrics --memory 5G`.  As of this writing that only supports hawkular and doesn't work on 3.7.0.
-    
-   See https://hub.docker.com/r/openshift/origin/tags/ for possible versions.
-   
-3. Grab the minishift IP:
-   
-   ```console
-   $ minishift ip
-   ```
-   
-4. Add `oc` and/or `docker` to your PATH, configured to the cluster (auto-detects correct shell):
-   
-   ```console
-   $ eval $(minishift oc-env)
-   $ eval $(minishift docker-env)
-   ```
-   
-5. Grab the token to access openshift through `manageiq`:
-   
-   ```console
-   $ oc login -u system:admin
-   $ oc sa get-token -n management-infra management-admin
-   ```
-   
-6. Configure a provider in ManageIQ, filling in your token and IP where
-   appropriate:
-   
-   ```console
-   $ bin/rails c
-   irb> token = '<<YOUR_TOKEN_FROM_ABOVE_HERE>>'
-   irb> host  = '<<YOUR_IP_FROM_ABOVE_HERE>>'
-   irb> os = ManageIQ::Providers::Openshift::ContainerManager
-   irb> os.create(:name => "Minishift", :hostname => host, :port => 8443, :ipaddress => host, :zone => Zone.first, :storage_profiles => [], :security_protocol => "ssl-without-validation")
-   irb> os.last.update_authentication(:bearer => {:auth_key => token, :save => true})
-   ```
-   
-   Or through the UI if you prefer.
-
-
 ### Running with CodeReady Containers
 
 
@@ -147,20 +71,20 @@ vm openshift on your development machine) but is an OpenShift v4 cluster.
 
 #### Requirements
 
-* [`CodeReady Containers`](https://github.com/code-ready/crc) ([Installation Instructions](https://code-ready.github.io/crc/#installation_gsg))
-* A compatible [Operating System](https://code-ready.github.io/crc/#minimum-system-requirements-operating-system_gsg) and the [Required software packages](https://code-ready.github.io/crc/#required-software-packages_gsg)
+* [`CodeReady Containers`](https://github.com/crc-org/crc) ([Installation Instructions](https://crc.dev/crc/getting_started/getting_started/installing/))
+* A compatible [Operating System](https://crc.dev/crc/getting_started/getting_started/installing/#_operating_system_requirements)
 
 #### Quickstart
 
-1. [Download](https://cloud.redhat.com/openshift/install/crc/installer-provisioned) ane extract the latest release of CRC
+1. [Download](https://console.redhat.com/openshift/create/local) ane extract the latest release of CRC
 
     ```console
     tar xfJ crc-linux-amd64.tar.xz
     ```
 2. Copy the crc binary to a location on your PATH
 
     ```console
-    sudo cp crc-linux-1.8.0-amd64/crc /usr/local/bin
+    sudo install crc-linux-2.39.0-amd64/crc /usr/local/bin/crc
     which crc
     /usr/local/bin/crc
     ```
@@ -184,31 +108,7 @@ vm openshift on your development machine) but is an OpenShift v4 cluster.
     oc login -u kubeadmin -p KUBEADMING_PASSWORD https://api.crc.testing:6443
     ```
 
-5. Now you can setup the management-infra/management-admin service account for use with ManageIQ
-    ```console
-    git clone https://gist.github.com/e2fac8be87ea0e9f429b6f5d75e02176 /tmp/manageiq_crc
-    oc adm new-project management-infra --description="Management-Infrastructure"
-    oc create serviceaccount management-admin -n management-infra
-    oc create -f /tmp/manageiq_crc/management-infra-admin-cluster-role.json
-    oc policy add-role-to-user -n management-infra admin -z management-admin
-    oc policy add-role-to-user -n management-infra management-infra-admin -z management-admin
-    oc adm policy add-cluster-role-to-user cluster-reader system:serviceaccount:management-infra:management-admin
-    oc adm policy add-scc-to-user privileged system:serviceaccount:management-infra:management-admin
-    oc adm policy add-cluster-role-to-user system:image-puller system:serviceaccount:management-infra:inspector-admin
-    oc adm policy add-scc-to-user privileged system:serviceaccount:management-infra:inspector-admin
-    oc adm policy add-cluster-role-to-user self-provisioner system:serviceaccount:management-infra:management-admin
-    ```
-
-6. Grab the console IP address and token to acess CRC through `ManageIQ`
-    ```console
-    cluster_ip=$(crc ip)
-    service_account_token=$(oc sa get-token -n management-infra management-admin)
-    ```
-
-7. Configure a provider in ManageIQ
-    ```console
-    rails r "ManageIQ::Providers::Openshift::ContainerManager.create!(:name => 'CRC', :hostname => '$cluster_ip', :port => 6443, :zone => Zone.visible.first, :security_protocol => 'ssl-without-validation').update_authentication(:bearer => {:auth_key => '$service_account_token'})"
-    ```
+5. Now you can setup the project and service account for use with ManageIQ by following the documentation: https://www.manageiq.org/docs/reference/latest/managing_providers/containers_providers/red_hat_openshift_providers.html
 
 ### Automated script to record new VCR