Deze repository bevat een Proof of Concept inventory plugin voor Ansible. Deze plugin zorgt ervoor dat TOPdesk Asset Management als bron kan worden gebruikt voor het genereren van een inventory voor Ansible.

Installatie

Zorg ervoor dat je Ansible geïnstalleerd hebt.
Maak in je projectfolder een bestand requirements.yaml als je dat nog niet hebt. In dit bestand kun je collections zetten die je gebruikt (zie de documentatie)
Zorg ervoor dat je deze collection opneemt als requirement. Zoals hieronder
Voer ansible-galaxy collection install -r requirements.yaml uit om alle requirements te installeren.

collections:
  - name: https://git.remmen.net/Thesis/kembit.topdesk
    version: v1.0
    type: git

Gebruik

Je kunt nu de inventory plugin gebruiken in een inventory bestand. Maak een nieuw bestand aan genaamd inventory.yaml die er bijvoorbeeld als volgt uitziet:

plugin: kembit.topdesk.topdesk_am

url: <url van de TOPdesk installatie (zonder slash op het einde)>
username: <gebruikersnaam (met rechten tot asset management)>
application_key: <een applicatie key (zie https://developers.topdesk.com/tutorial.html)>

fields:
  - name
  - type
  - merk
  - serienummer
  - lokaal-ipadres
  - status
  - beheer-ipadres
  - contract

names:
  - KMB-SW300
  - KMB-SW191
  - KMB-SW318

ansible_host: beheer-ipadres