blob: 354f4647607c80b05d2daa49b09081b1d73de94e (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
# Ansible Collection - cisco.ucs
Ansible collection for managing and automing Cisco UCS Manager envrionments. Modules and roles are provided for common Cisco UCS Manager tasks.
* Note: This collection is not compatible with versions of Ansible before v2.8.
## Requirements
- Ansible v2.8 or newer
- UCSM Python SDK (ucsmsdk)
## Install
- ansible must be installed
```
sudo pip install ansible
```
- ucsmsdk must be installed
```
sudo pip install ucsmsdk
```
We recommend verifying the ucsmsdk can connect to the domains you want to manage with Ansible. Here is an example connection test using python:
```
# python
Python 2.7.14 (default, Apr 27 2018, 14:31:56)
[GCC 4.8.5 20150623 (Red Hat 4.8.5-11)] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> from ucsmsdk import ucshandle
>>> handle = ucshandle.UcsHandle(ip='172.22.250.236', username='admin', password='password')
>>> handle.login()
True
```
## Usage
Once Ansible is installed you can create inventory files and playbooks to manage your UCS domains. Each module supports ansible-doc which includes example usage:
```
# ansible-doc cisco.ucs.ucs_vlans
<snip>
EXAMPLES:
- name: Configure VLAN
cisco.ucs.ucs_vlans:
hostname: 172.16.143.150
username: admin
password: password
name: vlan2
id: '2'
native: 'yes'
```
This repository includes a playbooks directory with examples including an inventory file that can be edited with information for the UCSM domain you want to configure:
```
# vi inventory
[ucs]
13.58.22.56
[ucs:vars]
username=admin
password=password
```
An example_playbook.yml playbook is included to test VLAN configuration on the UCSM domain given in the inventory file:
```
# vi example_playbook.yml
---
# Example Playbook: VLAN configuration using the [ucs] hosts group
- hosts: ucs
connection: local
collections:
- cisco.ucs
gather_facts: false
tasks:
- name: Configure VLAN
ucs_vlans:
hostname: "{{ inventory_hostname }}"
username: "{{ username | default(omit) }}"
password: "{{ password }}"
state: "{{ state | default(omit) }}"
name: vlan2
id: '2'
native: 'no'
delegate_to: localhost
```
Ansible will use data from the inventory file for the hostname and other variables above. Multiple UCSM domains can be listed in the inventory file and Ansible will configure all the listed domains in parallel using host specific data.
The ansible-playbook command can be used to run the above playbook and inventory file:
```
# ansible-playbook -i inventory example_playbook.yml
PLAY [ucs] *********************************************************************
TASK [Configure VLAN] **********************************************************
ok: [13.58.22.56 -> localhost]
PLAY RECAP *********************************************************************
13.58.22.56 : ok=1 changed=0 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
```
A more detailed configuration example is provided in the server_deploy.yml playbook.
# Community:
* We are on Slack (https://ciscoucs.slack.com/) - Slack requires registration, but the ucspython team is open invitation to
anyone. Click [here](https://ucspython.herokuapp.com) to register.
|
