RH358访问基于块的网络存储–自动化配置iSCSI initiator
本章节介绍如何使用Ansible连接iSCSI存储和管理。
RH358专栏地址：https://blog.csdn.net/qq_41765918/category_11532281.html
1. 使用Ansible连接iSCSI Targets
使用Ansible open_iscsi模块发现并登录远程iSCSl target。该模块依赖于iscsiadm命令，该命令由iscsi-initiator-utils包提供。
下面的剧本演示了如何使用open_iscsi模块。
---
- name: Ensure logged in to iSCSI target on 192.168.0.10
hosts: host.example.com
become: true
tasks:
- name: the iscsi-initiator-utils package is installed
# 使用Ansible yum模块安装iscsi-initiator-utils包。
yum:
name: iscsi-initiator-utils
state: present
- name: the IQN is set for the initiator
# 使用copy或template模块在/etc/iscsi/ initiatorname.iscsi文件中设置启动器IQN。本例中的任务使用ansible_facts['hostname ']变量中的系统短主机名来设置IQN中的可选字符串。当IQN发生变化时，任务通知restart iscsid处理器重新启动iscsid服务
copy:
dest: /etc/iscsi/initiatorname.iscsi
content: "InitiatorName=iqn.2014-06.com.example:{
{ ansible_facts['hostname'] }}\n"
mode: '644'
owner: root
group: root
notify: restart iscsid
- meta: flush_handlers
# flush_handlers元任务强制通知的处理程序在该点运行。如果上述任务更改了IQN，则启动器登录目标器之前必须运行重启iscsid服务的处理程序。
- name: the iSCSI target is discovered and available
#使用 open_iscsi 模块来 discover 并 login 到指定的 target。discover: yes 选项执行发现，但是 target: iqn.2014-06.com.example:rack1 和 login: yes 执行登录特定的IQN（如果可用）。通过 register 指令记录输出，可在后续任务中引用这些设备
open_iscsi:
portal: 192.168.0.10
port: '3260'
target: iqn.2014-06.com.example:rack1
discover: yes
login: yes
register: target
- name: display the discovered devices
# debug任务显示目标变量的内容。这对play来说不是必要的，但是显示了open_iscsi模块可以通过注册变量提供的信息。
debug:
var: target
handlers:
- name: restart iscsid
service:
name: iscsid
state: restarted
下面的输出显示了剧本的执行。
[root@host ~]$ ansible-playbook playbook.yml
PLAY [Ensure the iSCSI target on host is discovered] *********************
TASK [Gathering Facts] ***************************************************
ok: [host.example.com]
TASK [the iscsi-initiator-utils package is installed] ********************
changed: [host.example.com]
TASK [the IQN is set for the initiator] **********************************
changed: [host.example.com]
RUNNING HANDLER [restart iscsid] *****************************************
changed: [host.example.com]
TASK [the iSCSI target is discovered and available] **********************
changed: [host.example.com]
TASK [display the discovered devices] ************************************
ok: [host.example.com] => {
"target": {
"automatic_changed": false,
"cache_updated": true,
"changed": true,
"connection_changed": true,
"devicenodes": [
"/dev/sdc",
"/dev/sde",
"/dev/sdd"
],
"failed": false
}
}
PLAY RECAP ******************************************************************
host.example.com : ok=6 changed=4 unreachable=0 failed=0 ...
target变量包含open_iscsi模块任务的注册输出的字典。在该字典中，devicenodes变量包含使用门户192.168.0.10:3260执行发现后创建的本地设备列表。您可以使用loop遍历target['devicenodes ']中的列表，或者尝试直接从列表中提取特定项。
例如，要获取列表中第一项的值，可以使用该变量目标器[‘devicenodes’][0]，值为/dev/sdc，第二个项目可以作为目标['devicenodes '][1]引用(在前面的例子中它的值是/dev/sdd)。很多时候，目标只提供一个LUN，您可以只引用列表中的第一项。
当目标提供多个设备时，例如在前面的输出中，没有简单的方法从列表中识别特定的设备。一种解决方案是在open_iscsi任务之后调用setup模块来刷新Ansible事实。ansible_facts[‘devices’]字典对系统上所有设备的信息进行分组，并提供关于新设备的详细信息。
[root@host ~]$ ansible host.example.com -m setup
...output omitted...
"ansible_devices": {
"sdc": {
"holders": [],
"host": "",
"links": {
"ids": [
"scsi-36001405b1c74dbfcce04ccda76f8c21f",
"wwn-0x6001405b1c74dbfcce04ccda76f8c21f"
],
"labels": [],
"masters": [],
"uuids": []
},
"model": "target.disk1",
"partitions": {
},
"removable": "0",
"rotational": "1",
"sas_address": null,
"sas_device_handle": null,
"scheduler_mode": "mq-deadline",
"sectors": "2097152",
"sectorsize": "512",
"size": "1.00 GB",
"support_discard": "0",
"vendor": "LIO-ORG",
"virtual": 1,
"wwn": "0x6001405b1c74dbfcce04ccda76f8c21f"
},
"sdd": {
"holders": [],
"host": "",
"links": {
"ids": [
"scsi-360014058f584b514fe943b59d9931965",
"wwn-0x60014058f584b514fe943b59d9931965"
],
...output omitted...
断开与 target 的连接
使用 open_iscsi 模块来从远程 iSCSI target 注销。将 discover、login 和 auto_node_startup 参数设置为 no。以下任务会将 initiator 从 iqn.2014-06.com.example:rack1 target 断开连接
- name: the iSCSI target is disconnected
open_iscsi:
portal: 192.168.0.10
port: '3260'
target: iqn.2014-06.com.example:rack1
discover: no
login: no
auto_node_startup: no
2. 格式化iSCSI设备
rhel-system-roles包提供了Ansible存储系统角色，可以使用该角色格式化和持久地挂载新设备。
该角色可以在未分区的磁盘上设置LVM，或者直接用文件系统格式化该磁盘。角色在整个磁盘上工作。它不能创建分区，也不能使用已经分区的磁盘。
下面的脚本使用存储系统角色将/dev/sdc磁盘格式化和持久挂载/data下。
---
- name: Ensure the device is formatted and mounted
hosts: host.example.com
become: true
roles:
- role: rhel-system-roles.storage
storage_volumes:
- name: datadisk
state: present
type: disk
# type参数指定角色是在磁盘(LVM)上设置LVM，还是直接格式化整个磁盘(disk)。
disks:
# disks参数列出了需要配置的设备。在配置LVM时，角色将这些磁盘作为物理卷使用。如果将type设置为disk，则只能在该列表中提供一个磁盘。
- sdc
mount_point: /data
# mount_point参数提供文件系统挂载点。如果目录不存在，角色将创建该目录。
fs_type: ext4
# 参数fs_type表示文件系统类型。
mount_options: '_netdev'
# mount_options参数提供了挂载选项。角色将这些选项添加到/etc/fstab
**警告：**如果修改角色以在fs_type参数中指定不同的格式，然后重新运行playbook，角色将用新的文件系统类型重新格式化设备。此操作将破坏旧文件系统上以前的所有数据。
擦除iSCSI设备
可以使用Ansible存储系统角色卸载和擦除文件系统。为此，将state参数设置为absent。
roles:
- role: rhel-system-roles.storage
storage_volumes:
- name: datadisk
state: absent
type: disk
disks:
- sdc
mount_point: /data
fs_type: ext4
mount_options: '_netdev'
警告：如果state设置为absent，存储系统角色将卸载文件系统，将其从/etc/fstab中删除，并销毁设备上的所有数据。要持久地卸载文件系统，但保留其数据，请使用state设置为absent的Ansible mount模块。下面的任务使用mount模块卸载/data，并从/etc/fstab中删除它的条目。
- name: the device is not mounted
mount:
path: /data
state: absent
3. 课本练习
[student@workstation ~]$ lab iscsi-automation start
在本练习中，您将使用Ansible在服务器上配置iSCS Iinitiator来访问服务器提供的target。将生成的块设备格式化并挂载到/data下。
1. 熟悉项目及其现状。
[student@workstation ~]$ cd /home/student/iscsi-automation
[student@workstation iscsi-automation]$ tree
.
├── ansible.cfg
├── cleanup.yml
├── inventory
├── playbook.yml
├── solution
│ └── playbook.yml
├── templates
│ └── initiatorname.iscsi.j2
└── unmount.yml
2 directories, 7 files
2. 回顾并完成playbook.yml Ansible剧本。
该脚本在服务器上配置iSCSI启动器，从服务器发现并登录iSCSI目标，然后将新的块设备格式化并挂载在/data下。
[student@workstation iscsi-automation]$ cat playbook.yml
---
- name: Ensure /data is mounted from serverd iSCSI target
hosts: initiators
become: true
tasks:
- name: the iscsi-initiator-utils package is installed
yum:
name: iscsi-initiator-utils
state: present
- name: the IQN is set for the initiator
template:
dest: /etc/iscsi/initiatorname.iscsi
src: templates/initiatorname.iscsi.j2
mode: '644'
owner: root
group: root
notify: restart iscsid
# Forces the handler to run so that the iscsid service is restarted
# and is aware of the new initiator IQN
- meta: flush_handlers
- name: the iSCSI target is discovered and available
open_iscsi:
portal: 172.25.250.13
port: '3260'
target: iqn.2014-06.com.example:serverd
discover: yes
login: yes
register: target
- name: display the discovered devices
debug:
var: target['devicenodes']
- name: the new device is formatted and mounted under /data
include_role:
name: rhel-system-roles.storage
vars:
storage_volumes:
- name: devdata
state: present
type: disk
disks:
- "{
{ target['devicenodes'][0] }}"
mount_point: /data
fs_type: xfs
mount_options: '_netdev'
handlers:
- name: restart iscsid
service:
name: iscsid
state: restarted
3. 验证剧本的语法并运行。
[student@workstation iscsi-automation]$ ansible-playbook playbook.yml --syntax-check
playbook: playbook.yml
[student@workstation iscsi-automation]$ ansible-playbook playbook.yml
4. 在servera上，检查/data下的文件系统是否可以访问。
在该目录中创建一个测试文件，以确认可以向文件系统写入数据。
[root@servera ~]# lsblk --fs
NAME FSTYPE LABEL UUID MOUNTPOINT
sda xfs e2afea80-317e-40f2-a3d3-d4168929795d /data
vda
└─vda1 xfs f7614c41-2835-4125-bb13-50772dc2f30c /
vdb
[root@servera ~]# echo Hello World > /data/test.txt
[root@servera ~]# cat /data/test.txt
Hello World
5. 在workstation上检查unmount.yml的剧本和运行它。
这个剧本卸载服务器上的数据，然后从iSCSI目标退出。
[student@workstation iscsi-automation]$ cat unmount.yml
---
- name: Ensure /data is not mounted
hosts: initiators
become: true
tasks:
- name: the new device is not mounted
mount:
path: /data
state: absent
- name: the iSCSI target is disconnected
open_iscsi:
portal: 172.25.250.13
port: '3260'
target: iqn.2014-06.com.example:serverd
discover: no
login: no
auto_node_startup: no
[student@workstation iscsi-automation]$ ansible-playbook unmount.yml
[root@servera ~]# lsblk --fs
NAME FSTYPE LABEL UUID MOUNTPOINT
vda
└─vda1 xfs f7614c41-2835-4125-bb13-50772dc2f30c /
vdb
6. 运行playbook.yml重新发现并再次登录目标。
Ansible存储系统角色检测到设备已经有一个文件系统，不会重新格式化它。
[student@workstation iscsi-automation]$ ansible-playbook playbook.yml
[root@servera ~]# lsblk --fs
NAME FSTYPE LABEL UUID MOUNTPOINT
sda xfs e2afea80-317e-40f2-a3d3-d4168929795d /data
vda
└─vda1 xfs f7614c41-2835-4125-bb13-50772dc2f30c /
vdb
[root@servera ~]# ls /data
test.txt
[root@servera ~]# cat /data/test.txt
Hello World
完成实验
[student@workstation ~]$ lab iscsi-automation finish
总结
- 介绍如何使用Ansible连接iSCSI Targets。
- 介绍如何使用Ansible断开和格式化iSCSI设备。
- 若喜欢金鱼哥的文章，顺手点个赞。也可点个关注，因为后续会不断上干货。
