Skip to content
Install Mobile Services on OpenShift
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
roles
scripts
.gitignore
LICENSE
README.md
ansible.cfg
apb-release.md
install-mobile-services.yml
release_process.md
versions.yml

README.md

Mobile Services Installer

This repo contains ansible playbook for installing Mobile Services into existing OpenShift 3.11 instance.

It also contains scripts for local development of Mobile Services (using Minishift or oc cluster up).

Prerequisites:

  • Ansible 2.7.6
  • Running instance of OpenShift 3.11 with Ansible Service Broker
  • Cluster-admin access to targeted OpenShift instance
  • oc client v3.11

Installation

  1. Make sure you are targeting OpenShift instance with installed Ansible Service Broker (run oc projects and search for openshift-automation-service-broker or openshift-ansible-service-broker)

  2. Run the installation playbook:

    If you want to use the community releases, run the following command:

    ansible-playbook install-mobile-services.yml
    

    If you want to use the productized releases from Red Hat Container Catalog, please make sure you first follow the instructions on this page to ensure that your OpenShift cluster is configured to be able to pull from registry.redhat.io.

    Additionally, create a secret that will store the credentials, as described here, and then use the following command:

    ansible-playbook install-mobile-services.yml -e "ansible_playbookbundle_registry_type=rhcc" -e "rhcc_registry_auth_name=<name of the secret>"
    
  3. It will take a few minutes to redeploy and load all Mobile Services to Service Catalog. If you want to force the service catalog to refresh, run the following command:

    oc get clusterservicebroker ansible-service-broker -o=json > broker.json
    oc delete clusterservicebroker ansible-service-broker
    oc create -f broker.json
    
  4. Verify that installation was successful by navigating to https://your-openshift-instance-url.com/console/catalog. A new tab Mobile should appear in the catalog.

Local development

By following next steps, you can spin up your local OpenShift instance with Mobile Services already installed.

🐧 Linux

You may need to configure your firewall first:

sudo firewall-cmd --permanent --add-port=8443/tcp
sudo firewall-cmd --permanent --add-port=8053/tcp
sudo firewall-cmd --permanent --add-port=53/udp
sudo firewall-cmd --permanent --add-port=443/tcp
sudo firewall-cmd --permanent --add-port=80/tcp
sudo firewall-cmd --reload

Download archive with oc client binary, extract it, add it to your $PATH and run:

./scripts/oc-cluster-up.sh

See OpenShift documentation for more details.

🍎 Mac

Since oc cluster up is causing problems for users using Mac OS (since OpenShift version 3.10), it is advised to use Minishift as an alternative.

To spin up OpenShift 3.11 cluster locally, run:

./scripts/minishift.sh

Once the setup is complete, it is possible to stop the cluster with minishift stop and then run it again with minishift start.

See Minishift documentation for more details.

You can’t perform that action at this time.