InfraCLI

https://fatihsolen.com https://www.linkedin.com/in/fatihsolen/

InfraCLI is a unified command-line tool for managing Microsoft DNS Server records, VMware, Harvester and Cloud Stack virtual machines (VMs) and PureStorage FLashArray// storage arrays. It provides functionalities to add, delete, list and modify DNS records, as well as to create, delete, list, snapshot and modify VMs and manage storage arrays for daily tasks.

Notes

• Added PHPIPAM integration for getting next available IP, Subnet, Route and DNS information.
• Openshift Virtualization (Kubevirt) (Harvester HCI works well but Openshift Virtualization not tested yet)
• Apache Cloud Stack support added (Not fully tested)

Planned

• Vault integration to secure authentication tokens

Not Planned

• Proxmox support

Do not use in production yet!

Installation

1. Clone the repository:

   git clone https://github.com/fsolen/infracli.git
   cd infracli

2. Install the required dependencies:

   pip install -r requirements.txt

3. Run the CLI:

   python fscli.py --help

4. Shorten Command (Optional)

   bash setup_fscli.sh

Configuration

The configuration for sites and services is stored in configs/sites.yaml. Each site can have multiple hypervisors, storage systems and DNS servers.

sites:
  istanbul:
    hypervisors:
      - type: vmware
        host: ivcenter01.fatihsolen.local
      - type: vmware
        host: ivcenter02.fatihsolen.local
      - type: harvester
        host: iharvester01.fatihsolen.local
      - type: harvester
        host: iharvester02.fatihsolen.local
      - type: cloudstack
        host: icloudstack01.fatihsolen.local/client/api
      - type: cloudstack
        host: icloudstack02.fatihsolen.local/client/api
    storage:
      - type: purefa
        host: ipurefa01.fatihsolen.local
      - type: purefa
        host: ipurefa02.fatihsolen.local
    dns:
      - type: msdns
        host: msdns.fatihsolen.local
    ipam:
      - type: phpipam
        host: iipam.fatihsolen.local
    vault:
      - type: openbao
        host: vault.fatihsolen.local
  ankara:
    hypervisors:
      - type: vmware
        host: avcenter01.fatihsolen.local
      - type: vmware
        host: avcenter02.fatihsolen.local
      - type: harvester
        host: aharvester01.fatihsolen.local
      - type: harvester
        host: aharvester02.fatihsolen.local
      - type: cloudstack
        host: acloudstack01.fatihsolen.local/client/api
      - type: cloudstack
        host: acloudstack02.fatihsolen.local/client/api
    storage:
      - type: purefa
        host: apurefa01.fatihsolen.local
      - type: purefa
        host: apurefa02.fatihsolen.local
    dns:
      - type: msdns
        host: msdns.fatihsolen.local
    ipam:
      - type: phpipam
        host: aipam.fatihsolen.local
    vault:
      - type: openbao
        host: vault.fatihsolen.local

VM Host Group Profiles

Create VM profile files in the "vm_profiles" directory. Each file should be named after the profile and have the following format:

# Example profile manifest
hostname_pattern: ipa-{index}
template_name: opensuse-leap-15-v1
networks:
  - name: "net1"
    vlan: "vlan101"
  - name: "net2"
    vlan: "vlan102"
cpu: 4
memory: 8192
disks:
  - name: "disk1"
    size_gb: 50
  - name: "disk2"
    size_gb: 100

Usage Examples

DNS Management

Get DNS Record

python fscli.py dns get <site> <server> <dns-record-type> <dns-record> <dns-server-name>
python fscli.py dns get istanbul msdns A example.fatihsolen.com fatihsolen_com
python fscli.py dns get istanbul msdns alias.fatihsolen.com fatihsolen_com
python fscli.py dns get istanbul msdns PTR 123.123.123.123 fatihsolen_com
python fscli.py dns get istanbul msdns TXT example.fatihsolen.com fatihsolen_com
python fscli.py dns get ankara msdns MX example.fatihsolen.com fatihsolen_com

Add DNS Record (PTR records are created automatically)

python fscli.py dns add <site> <dns_name> <dns-record-type> <dns-record> <record-value> [ttl-value] [priority(only for MX records)] <dns-server-name>
python fscli.py dns add istanbul msdns A example.fatihsolen.com 192.168.1.1 --ttl 3600 fatihsolen_com
python fscli.py dns add istanbul msdns CNAME alias.fatihsolen.com example.fatihsolen.com --ttl 3600 fatihsolen_com
python fscli.py dns add istanbul msdns TXT example.fatihsolen.com "v=spf1 include:fatihsolen.com ~all" --ttl 3600 fatihsolen_com
python fscli.py dns add istanbul msdns MX example.fatihsolen.com mail.example.com --ttl 3600 --priority 10 fatihsolen_com

Delete DNS Record

python fscli.py dns del <site> <dns_name> <dns-record-type> <dns-record> <record-value> <dns-server-name>
python fscli.py dns del istanbul msdns A example.fatihsolen.com 192.168.1.1 fatihsolen_com
python fscli.py dns del istanbul msdns CNAME alias.fatihsolen.com example.fatihsolen.com fatihsolen_com
python fscli.py dns del istanbul msdns TXT example.fatihsolen.com "v=spf1 include:example.com ~all" fatihsolen_com
python fscli.py dns del istanbul msdns MX example.fatihsolen.com mail.example.com fatihsolen_com

List DNS Records

python fscli.py dns list <site> <dns_name> <dns-server-name>
python fscli.py dns list istanbul msdns fatihsolen.com

VM Management

For all hypervisors

Create VM

python fscli.py vm create <profile_name> <site> <hypervisor_name>

Delete VM

python fscli.py vm delete <vm_name> <site> <hypervisor_name>

List VMs

python fscli.py vm list <site> <hypervisor_name>

Create VM Snapshot

python fscli.py vm snapshot <vm_name> <site> <hypervisor_name>

Modify VM

python fscli.py vm modify <vm_name> <profile_name> <site> <hypervisor_name>

Pure FlashArray Management

Create LUN

python fscli.py storage create_lun <site> <array_name> <volume_name> <size>

Create Host

python fscli.py storage create_host <site> <array_name> <host_name> --iqn <iqn> --wwns <wwn1> <wwn2>

Add Initiator to Host

python fscli.py storage add_initiator <site> <array_name> <host_name> <initiator_name> <initiator_type>

Map Volume to Host

python fscli.py storage map_volume <site> <array_name> <volume-name> <host_name>

Take Snapshot of LUN

python fscli.py storage snapshot_lun <site> <array_name> <volume-name> <snapshot-name>

List All Hosts

python fscli.py storage list_hosts <site> <array_name>

List All LUNs

python fscli.py storage list_luns <site> <array_name>

List Host and LUN Mappings

python fscli.py storage list_host_lun_mappings <site> <array_name>