Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/networktocode/netscaler-ansible

Ansible Modules to manage Citrix Netscaler devices
https://github.com/networktocode/netscaler-ansible

Last synced: about 2 months ago
JSON representation

Ansible Modules to manage Citrix Netscaler devices

Host: GitHub
URL: https://github.com/networktocode/netscaler-ansible
Owner: networktocode
Created: 2017-05-12T21:32:22.000Z (over 7 years ago)
Default Branch: master
Last Pushed: 2018-12-20T20:59:32.000Z (about 6 years ago)
Last Synced: 2024-05-30T01:17:50.557Z (7 months ago)
Language: Python
Size: 184 KB
Stars: 11
Watchers: 16
Forks: 9
Open Issues: 0
Metadata Files:
- Readme: README.md
- Contributing: contributing.md

Awesome Lists containing this project

README

# Ansible Modules for Netscaler Nitro API

* [Introduction](#introduction)
* [Module Summary](#modules)
* [Installation](#installation)
* [Detailed Module Documentation](#full-module-documentation)
* [Module Examples](#examples)
* [Contributing](#contributing)

# Introduction

This repository includes a number of Ansible modules to automate Citrix Netscaler devices using the Nitro API.

# Modules

Here is a brief overview of all modules included in this repository.

* **netscaler_server**
+ Used to create, update, and delete server objects.
+ Returns the existing configuration for the server object and the configuration sent to the Netscaler API.
* **netscaler_servicegroup**
+ Used to create, update, and delete service group objects.
+ Returns the existing configuration for the service group and the configuration sent to the Netscaler API.
* **netscaler_lbvserver**
+ Used to create, update, and delete lb vserver objects.
+ Returns the existing configuration for the lb vserver and the configuration sent to the Netscaler API.
* **netscaler_lbmonitor**
+ Used to create, update, and delete lb monitor objects.
+ Returns the existing configuration for the lb monitor and the configuration sent to the Netscaler API.
* **netscaler_servicegroup_server**
+ Used to create and delete service group to server bindings.
+ Returns all existing server objects bound to the service group, the existing configuration for the particular service group to server pair, and the configuration sent to the Netscaler API.
* **netscaler_servicegroup_monitor**
+ Used to create and delete service group to lb monitor bindings.
+ Returns all existing lb monitors bound to the service group, the existing configuration for the particular service group to lb monitor pair, and the configuration sent to the Netscaler API.
* **netscaler_lbvserver_servicegroup**
+ Used to create and delete lb vserver to service group bindings.
+ Returns all existing service groups bound to the lb vserver, the existing configuration for the particular lb vserver to service group pair, and the configuration sent to the Netscaler API.
* **netscaler_lbvserver_certkey**
+ Used to create, update, and delete lb vserver to SSl cert key bindings.
+ Returns all existing SSl cert keys bound to the lb vserver, the existing configuration for the particular lb vserver to SSL cert key pair, and the configuration sent to the Netscaler API.
* **netscaler_facts**
+ Used to gather facts about the Netscaler system and configuration.
+ Returns system and hardware info, cli configuration, and json configurations for servers, service groups, lb vservers, and lb monitors.
* **netscaler_save_config**
+ Used to save the running configuration on the Netscaler to the device.
+ Returns the status code of the API request to save the configuration.

# Installation

You need to perform **two** steps to start using these modules.

1. Ensure this repository is in your Ansible module search path.
2. Install Dependencies.

### Locate your search path
Here is how you can locate your search path:
```
$ ansible --version
ansible 2.1.1.0
config file = /etc/ansible/ansible.cfg
configured module search path = ???
```

If you already have a search path configured, clone the repo (see options below) while you are in your search path.

If you have a "default" or No search path shown, open the config file that is shown in the output above, here that is `/etc/ansible/ansible.cfg`. In that file, you'll see these first few lines:
```
[defaults]

# some basic default values...

inventory = /etc/ansible/hosts
library = /home/ntc/projects/
```

Add a path for `library` that exists in this repository - this will become your search path. Validate it with `ansible --version` after you make the change.

### Clone the repo in your search path
Once you have located your search path; browse to that directory and clone the netscaler-ansible repo:
```
$ cd /home/ntc/projects
$ git clone https://github.com/networktocode/netscaler-ansible.git
```

As a quick test and sanity-check use `ansible-doc` on one of the modules before trying to use them in a playbook. For example, try this:
```
$ ansible-doc netscaler_save_config
```

If that works, Ansible can find the modules and you can proceed to installing the dependencies below.

## Install Dependencies
All of the dependencies can be installed using the requirements.txt file that comes with the modules. Move to the new netscaler-ansible directory and use pip to install them.
```
$ cd netscaler-ansible
$ pip install -r requirements.txt
```

# Full Module Documentation

The following docs are the same type of docs you'd find on docs.ansible.com for modules that are found in Ansible core:

See [Module Documentation](Module_Docs/netscaler_module_docs.md)

# Examples
See [Examples](examples.md)

# Contributing
See [Contributing](contributing.md)