ibmcloud-ansible

Ansible playbooks and utilities for working with the IBM Cloud. Also see the ansible-collection-ibm.

Most require an ansible inventory file. You can create one easily as below or we provide a dynamic inventory script for IBM Cloud VPC. You can also integrate IBM Cloud Schematics Terraform for inventory.

Inventory:

cat inventory
[hosts]
192.168.0.5 ansible_ssh_user=ubuntu

bootstrap_python.sh

Description: This script will install python on ubuntu hosts, needed for other playbooks.

Usage:

./bootstrap_python.sh <ip>

first-config.yml

Description: This playbook will do first-run configuration for IBM Cloud VMs including securing ssh, installing basic packages, etc.

Usage:

ansible-playbook -i inventory first-config.yml

ibmcloud-client.yml

Description: This playbook will install the ibmcloud cli tool and several common plugins. User to install with is customizable.

ansible-playbook -i inventory ibmcloud-client.yml

Note: ibmcloud plugins are installed per-user. If you want to install under your user do an override like this:

ansible-playbook -i inventory ibmcloud-client.yml --extra-vars "ibmcloud_unix_user=ubuntu"

Dynamic Inventory

IBM Cloud has a dynamic inventory plugin for ansible. It can detect your vpc gen 1 and gen 2 instances so you don't have to keep static inventory files around.

Set up dynamic inventory

1. Install python dependencies for inventory (plugins/inventory/requirements.txt)

2. Set up ansible.cfg (add the following)

   [inventory]
   enable_plugins = auto
   

3. Set up ibmcloud.yaml

plugin: ibmcloud.ibmcollection.vpcinventory

1. Export or set your IBM Cloud API Key

export IBMCLOUD_API_KEY='93nift8rl1h8f93tl3itn3GGGST83n382921n11n"

1. Test using ansible-inventory

$ ansible-inventory -i ibmcloud.yaml --list all

{
    "_meta": {
        "hostvars": {
            "marty-vm1": {
                "ansible_host": "10.240.0.4",
                "vpc_name": "marty-vpc"
            },
            "nibz-falco-2": {
                "ansible_host": "10.240.0.11",
                "vpc_name": "nibz"
            },
            "svergara-vpc-vm1-ubu": {
                "ansible_host": "10.240.128.4",
                "vpc_name": "svergara-vpc"
            },
            "svergara-vpc-vm1-win": {
                "ansible_host": "10.240.128.36",
                "vpc_name": "svergara-vpc"
            },
            "testinstance": {
                "ansible_host": "10.240.0.4",
                "vpc_name": "nibz"
            }
        }
    },
    "all": {
        "children": [
            "ungrouped"
        ]
    },
    "ungrouped": {
        "hosts": [
            "marty-vm1",
            "nibz-falco-2",
            "svergara-vpc-vm1-ubu",
            "svergara-vpc-vm1-win",
            "testinstance"
        ]
    }
}

Developer Utilities

Ansible playbooks to install basic developer utilities for working with bluemix: bx, kubectl, docker, cf, etc. This solves the problem of collecting and installing the client utilities which are typically distributed as binaries in tarballs available over https.

Software	Org	command(s)	version
IBMCloud CLI	IBM	ibmcloud	latest
Kubernetes	CNCF	kubectl	latest
Helm	CNCF	helm	latest
Cloud Foundry	Cloud Foundry	cf	latest
Moby	Moby	docker	latest
Packer	Hashicorp	packer	1.0.3
Terraform	Hashicorp	terraform	0.10.0

This requires an ansible inventory file.

Inventory:

cat inventory
[hosts]
192.168.0.5 ansible_ssh_user=ubuntu

Usage:

./run_all.sh

or

ansible-playbook -i inventory k8s-client.yml
ansible-playbook -i inventory ibmcloud-client.yml
ansible-playbook -i inventory cf-client.yml
ansible-playbook -i inventory docker.yml
ansible-playbook -i inventory hashicorp.yml
ansible-playbook -i inventory istio.yml
ansible-playbook -i inventory git-repos.yml