Skip to content

Latest commit

 

History

History
143 lines (97 loc) · 4.08 KB

openshift.md

File metadata and controls

143 lines (97 loc) · 4.08 KB
Raw

ManageIQ Openshift Container Provider

Two deployment options are suggested here to deploy an openshift origin provider for ManageIQ:

You can also use oc cluster up and configure it yourself (instructions not provided) as another alternative.

Deploying OpenShift With Ansible

Get openshift-ansible:

$ git clone https://github.com/openshift/openshift-ansible.git

Generate an ssh key if needed:

$ ssh-keygen

Configure ssh key authentication to all the machines:

$ ssh-copy-id root@hostname

The inventory file describes all the nodes and masters in the cluster. A simple 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

There are more like variables like use_metrics to enable other options in OpenShift. A more detailed example can be found in inventory/byo/hosts.origin.example. Specifically, to deploy metrics and logging use openshift_hosted_metrics_deploy=True and openshift_hosted_logging_deploy=True

$ 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 to run a local openshift instance.

Requirements

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 the manageiq.addon for minishift to a directory of your choosing:
$ git clone https://gist.github.com/e2fac8be87ea0e9f429b6f5d75e02176.git path/to/minishift-addons/manageiq

You can inspect the addon here:

https://gist.github.com/NickLaMuro/e2fac8be87ea0e9f429b6f5d75e02176

It is recommended to keep a directory of your addons in one place.

  1. Add and enable the manageiq addon to minishift:
$ minishift addons install --force path/to/minishift-addons/manageiq
$ minishift addons enable manageiq
  1. Start minishift:
$ minishift start --vm-driver virtualbox --openshift-version "v1.5.0-rc.0"
  1. Grab the minishift IP:
$ minishift ip
  1. Grab the token to access openshift through manageiq:
$ ~/.minishift/cache/oc/v1.5.0-rc.0/oc login -u system:admin
$ ~/.minishift/cache/oc/v1.5.0-rc.0/oc sa get-token -n management-infra management-admin

Or in a single command form:

$ (export PATH="~/.minishift/cache/oc/v1.5.0-rc.0/:$PATH"; oc login -u system:admin > /dev/null; oc sa get-token -n management-infra management-admin)
  1. Configure a provider in ManageIQ, filling in your token and IP where appropriate:
$ 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.