Skip to content

Commit

Permalink
Drop minishift and update CRC links
Browse files Browse the repository at this point in the history
  • Loading branch information
agrare committed Jul 18, 2024
1 parent 50482b4 commit 4741647
Showing 1 changed file with 8 additions and 84 deletions.
92 changes: 8 additions & 84 deletions providers/openshift.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand All @@ -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


Expand All @@ -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
```
Expand Down

0 comments on commit 4741647

Please sign in to comment.