Skip to content

Commit 35512b2

Browse files
committed
Initial commit based on the collection migration available at "ansible-collection-migration/cisco.aci" which contains the ACI module from Ansible Core
0 parents  commit 35512b2

File tree

204 files changed

+35813
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

204 files changed

+35813
-0
lines changed

COPYING

Lines changed: 675 additions & 0 deletions
Large diffs are not rendered by default.

README.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
# ansible-aci
2+
3+
The ansible-aci project provides an Ansible collection for managing and automating your Cisco ACI environment. It consists of a set of modules and roles for performing tasks related to ACI.
4+
5+
*Note: This collection is not compatible with versions of Ansible before v2.8.*
6+
7+
## Requirements
8+
Ansible v2.8 or newer
9+
10+
## Install
11+
Ansible must be installed
12+
```
13+
sudo pip install ansible
14+
```
15+
16+
## Use
17+
Once the collection is installed, you can use it in a playbook by specifying the full namespace path to the module, plugin and/or role.
18+
19+
```
20+
- hosts: aci
21+
gather_facts: no
22+
23+
tasks:
24+
- name: Add a new EPG
25+
cisco.aci.aci_epg:
26+
hostname: apic
27+
username: admin
28+
password: SomeSecretPassword
29+
tenant: production
30+
ap: intranet
31+
epg: web_epg
32+
description: Web Intranet EPG
33+
bd: prod_bd
34+
delegate_to: localhost
35+
```

plugins/doc_fragments/__init__.py

Whitespace-only changes.

plugins/doc_fragments/aci.py

Lines changed: 88 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,88 @@
1+
# -*- coding: utf-8 -*-
2+
3+
# Copyright: (c) 2017, Dag Wieers (@dagwieers) <[email protected]>
4+
# Copyright: (c) 2017, Swetha Chunduri (@schunduri)
5+
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
6+
7+
from __future__ import (absolute_import, division, print_function)
8+
__metaclass__ = type
9+
10+
11+
class ModuleDocFragment(object):
12+
# Standard files documentation fragment
13+
DOCUMENTATION = r'''
14+
options:
15+
host:
16+
description:
17+
- IP Address or hostname of APIC resolvable by Ansible control host.
18+
type: str
19+
required: yes
20+
aliases: [ hostname ]
21+
port:
22+
description:
23+
- Port number to be used for REST connection.
24+
- The default value depends on parameter C(use_ssl).
25+
type: int
26+
username:
27+
description:
28+
- The username to use for authentication.
29+
type: str
30+
default: admin
31+
aliases: [ user ]
32+
password:
33+
description:
34+
- The password to use for authentication.
35+
- This option is mutual exclusive with C(private_key). If C(private_key) is provided too, it will be used instead.
36+
type: str
37+
required: yes
38+
private_key:
39+
description:
40+
- Either a PEM-formatted private key file or the private key content used for signature-based authentication.
41+
- This value also influences the default C(certificate_name) that is used.
42+
- This option is mutual exclusive with C(password). If C(password) is provided too, it will be ignored.
43+
type: str
44+
required: yes
45+
aliases: [ cert_key ]
46+
certificate_name:
47+
description:
48+
- The X.509 certificate name attached to the APIC AAA user used for signature-based authentication.
49+
- If a C(private_key) filename was provided, this defaults to the C(private_key) basename, without extension.
50+
- If PEM-formatted content was provided for C(private_key), this defaults to the C(username) value.
51+
type: str
52+
aliases: [ cert_name ]
53+
output_level:
54+
description:
55+
- Influence the output of this ACI module.
56+
- C(normal) means the standard output, incl. C(current) dict
57+
- C(info) adds informational output, incl. C(previous), C(proposed) and C(sent) dicts
58+
- C(debug) adds debugging output, incl. C(filter_string), C(method), C(response), C(status) and C(url) information
59+
type: str
60+
choices: [ debug, info, normal ]
61+
default: normal
62+
timeout:
63+
description:
64+
- The socket level timeout in seconds.
65+
type: int
66+
default: 30
67+
use_proxy:
68+
description:
69+
- If C(no), it will not use a proxy, even if one is defined in an environment variable on the target hosts.
70+
type: bool
71+
default: yes
72+
use_ssl:
73+
description:
74+
- If C(no), an HTTP connection will be used instead of the default HTTPS connection.
75+
type: bool
76+
default: yes
77+
validate_certs:
78+
description:
79+
- If C(no), SSL certificates will not be validated.
80+
- This should only set to C(no) when used on personally controlled sites using self-signed certificates.
81+
type: bool
82+
default: yes
83+
seealso:
84+
- ref: aci_guide
85+
description: Detailed information on how to manage your ACI infrastructure using Ansible.
86+
- ref: aci_dev_guide
87+
description: Detailed guide on how to write your own Cisco ACI modules to contribute.
88+
'''

plugins/module_utils/__init__.py

Whitespace-only changes.

plugins/module_utils/network/aci/__init__.py

Whitespace-only changes.

0 commit comments

Comments
 (0)