https://github.com/nibalizer/ibmcloud-ansible
Ansible scripts, playbooks, and plugins for use with the ibmcloud
https://github.com/nibalizer/ibmcloud-ansible
ansible bluemix ibm ibm-cloud ibmcloud
Last synced: 5 days ago
JSON representation
Ansible scripts, playbooks, and plugins for use with the ibmcloud
- Host: GitHub
- URL: https://github.com/nibalizer/ibmcloud-ansible
- Owner: nibalizer
- License: apache-2.0
- Created: 2017-08-06T18:17:48.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2020-07-16T18:25:25.000Z (almost 5 years ago)
- Last Synced: 2025-03-29T21:32:10.950Z (30 days ago)
- Topics: ansible, bluemix, ibm, ibm-cloud, ibmcloud
- Language: Python
- Homepage: https://www.ibm.com/cloud/vpc
- Size: 27.3 KB
- Stars: 7
- Watchers: 2
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
- License: LICENSE
Awesome Lists containing this project
README
ibmcloud-ansible
--------------
Ansible playbooks and utilities for working with the [IBM Cloud](https://cloud.ibm.com). Also see the [ansible-collection-ibm](https://github.com/IBM-Cloud/ansible-collection-ibm).
Most require an ansible inventory file. You can create one easily as below or we provide a [dynamic inventory script](https://github.com/nibalizer/ibmcloud-ansible#dynamic-inventory) for IBM Cloud VPC. You can also integrate [IBM Cloud Schematics Terraform](https://cloud.ibm.com/docs/terraform?topic=terraform-ansible#import_from_terraform) for inventory.
Inventory:
```shell
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:
```bash
./bootstrap_python.sh
```
## `first-config.yml`
Description: This playbook will do first-run configuration for IBM Cloud VMs including securing ssh, installing basic packages, etc.
Usage:
```bash
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.
```shell
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:
```shell
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`)
1. Set up `ansible.cfg` (add the following)
```
[inventory]
enable_plugins = auto
```
1. Set up `ibmcloud.yaml`
```
plugin: ibmcloud.ibmcollection.vpcinventory
```
1. Export or set your [IBM Cloud API Key](https://cloud.ibm.com/docs/iam?topic=iam-userapikey#create_user_key)
```bash
export IBMCLOUD_API_KEY='93nift8rl1h8f93tl3itn3GGGST83n382921n11n"
```
1. Test using `ansible-inventory`
```bash
$ ansible-inventory -i ibmcloud.yaml --list all
```
```json
{
"_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:
```shell
cat inventory
[hosts]
192.168.0.5 ansible_ssh_user=ubuntu
```
Usage:
```shell
./run_all.sh
```
or
```shell
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
```