targetcli

Targetcli target iSCSI role which takes care of installing targetcli, enabling it on boot and configuring it based on the provided variable from ansible.

NOTE: Modules used by this module were separated into role OndrejHome.targetcli-modules

Requirements

This role is not creating any disks/partitions/LVs. It is expected that they are already present on machine or created by some other role.

Role Variables

To configure the iSCSI target, the following nested variable is used which defines how the configuration should look like.

iscsi_targets:
  - wwn: 'iqn.1994-05.com.redhat:target'
    disks:
      - path: '/dev/c7vg/LV1'
        name: 'test1'
        type: 'block'
      - path: '/dev/c7vg/LV2'
        name: 'test2'
        type: 'block'
    initiators:
      - 'iqn.1994-05.com.redhat:client1'
      - 'iqn.1994-05.com.redhat:client2'

Example Playbook

Install and configure targetcli server with 2 exported luns under one WWN for 2 specified initiators.

- hosts: servers
  roles:
    - { role: 'OndrejHome.targetcli' }
  vars:
    iscsi_targets:
      - wwn: 'iqn.1994-05.com.redhat:target'
        disks:
          - path: '/dev/c7vg/LV1'
            name: 'test1'
            type: 'block'
          - path: '/dev/c7vg/LV2'
            name: 'test2'
            type: 'block'
        initiators:
          - 'iqn.1994-05.com.redhat:client1'
          - 'iqn.1994-05.com.redhat:client2'

This role can be also used in combination with OndrejHome.iscsiadm that from v2 can install needed utilities and determine the initiator WWN that can be supplied for this role as shown below. Note that group containing the initiators in example below is named cluster and you should adjust it for your inventory.

- hosts: cluster
  roles:
    - { role: 'OndrejHome.iscsiadm' }

- hosts: storage
  roles:
    - { role: 'OndrejHome.targetcli' }
  vars:
    iscsi_targets:
      - wwn: 'iqn.1994-05.com.redhat:target'
        disks:
          - path: '/dev/c7vg/LV1'
            name: 'test1'
            type: 'block'
        initiators: "[ {% for host in groups['cluster'] %} '{{ hostvars[host][\"iscsi_initiator_name\"] }}', {% endfor %} ]"

You can even later instruct the nodes to connect to target created here.

- hosts: cluster
  roles:
    - { role: 'OndrejHome.iscsiadm', iscsi_target_ip: "{{ hostvars[groups['storage'][0]]['ansible_default_ipv4']['address'] }}" }

License

GPLv3

Author Information

To get in touch with author you can use email ondrej-xa2iel8u@famera.cz or create a issue on github when requesting some feature.