Added 'src/adv_network/platform_options/nxos.md'.

gnu4cn · gnu4cn · commit ac09bcdc4b51 · 2025-03-24T15:43:45.000+08:00
diff --git a/network_run/enable_nx-api.yml b/network_run/enable_nx-api.yml
@@ -0,0 +1,8 @@
+---
+- hosts: nxos-sw
+  gather_facts: no
+
+  tasks:
+    - name: Enable NX-API
+      cisco.nxos.nxos_nxapi:
+        enable_https: yes
diff --git a/src/SUMMARY.md b/src/SUMMARY.md
@@ -200,6 +200,9 @@
         - [IOS 平台选项](adv_network/platform_options/icx.md)
         - [IronWare 平台选项](adv_network/platform_options/ironware.md)
         - [Junos OS 平台选项](adv_network/platform_options/junos.md)
+        - [Meraki 平台选项](adv_network/platform_options/meraki.md)
+        - [Pluribus NETVISOR 平台选项](adv_network/platform_options/meraki.md)
+        - [NOS 平台选项](adv_network/platform_options/nos.md)
 
 ---
 
diff --git a/src/adv_network/platform_options/junos.md b/src/adv_network/platform_options/junos.md
@@ -13,7 +13,86 @@
 | 间接访问 | 使用堡垒机（跳转主机） | 使用堡垒机（跳转主机） |
 | 连接设置 | `ansible_connection: ansible.netcommon.network_cli` | `ansible_connection: ansible.netcommon.netconf` |
 | `enable` 模式（权限提升） | 不受 Junos OS 支持 | 不受 Junos OS 支持 |
-| 返回数据格式 | `stdout[0].` | <li>json: <code>result[0]['software-information'][0]['host-name'][0]['data'] foo lo0</code></li><li>text: <code>result[1].software-information[0].physical-interface[0].name[0].data foo lo0</code></li><li>xml: <code>result[1].rpc-reply.interface-information[0].physical-interface[0].name[0].data foo lo0</code></li>
+| 返回数据格式 | `stdout[0].` | <li>json: <code>result[0]['software-information'][0]['host-name'][0]['data'] foo lo0</code></li><li>text: <code>result[1].interface-information[0].physical-interface[0].name[0].data foo lo0</code></li><li>xml: <code>result[1].rpc-reply.interface-information[0].physical-interface[0].name[0].data foo lo0</code></li>
 
 
 `ansible_connection: local` 已被弃用。请使用 `ansible_connection: ansible.netcommon.netconf` 或 `ansible_connection=ansible.netcommon.network_cli` 代替。
+
+
+## 在 Ansible 中使用 CLI
+
+### 示例 CLI 仓库变量 `[junos:vars]`
+
+
+```ini
+[junos:vars]
+ansible_connection=ansible.netcommon.network_cli
+ansible_network_os=junipernetworks.junos.junos
+ansible_user=myuser
+ansible_password=!vault...
+ansible_ssh_common_args='-o ProxyCommand="ssh -W %h:%p -q bastion01"'
+```
+
+
+{{#include ./ce.md:43:45}}
+
+
+### 示例 CLI 任务
+
+
+```yaml
+- name: Retrieve Junos OS version
+  junipernetworks.junos.junos_command:
+    commands: show version
+  when: ansible_network_os == 'junipernetworks.junos.junos'
+```
+
+
+## 在 Ansible 中使用 NETCONF
+
+### 启用 NETCONF
+
+
+在咱们可以使用 NETCONF 连接交换机前，咱们必须：
+
+- 使用 `pip install ncclient`（`python -m pip install ncclient`）命令，在控制节点上安装 `ncclient` 这个 python 软件包；
+- 在 Junos OS 设备上启用 NETCONF。
+
+
+要经由 Ansible 在新交换机上启用 NETCONF，就要通过 CLI 连接使用 `junipernetworks.junos.junos_netconf` 这个模组。像上面的 CLI 示例中一样，设置咱们平台级变量，然后运行一个如下的 playbook 任务：
+
+
+```yaml
+- name: Enable NETCONF
+  connection: ansible.netcommon.network_cli
+  junipernetworks.junos.junos_netconf:
+  when: ansible_network_os == 'junipernetworks.junos.junos'
+```
+
+启用 NETCONF 后，就要修改咱们的变量，以使用 NETCONF 连接。
+
+
+### 示例 NETCONF 仓库的 `[junos:vars]`
+
+
+```ini
+[junos:vars]
+ansible_connection=ansible.netcommon.netconf
+ansible_network_os=junipernetworks.junos.junos
+ansible_user=myuser
+ansible_password=!vault |
+ansible_ssh_common_args='-o ProxyCommand="ssh -W %h:%p -q bastion01"'
+```
+
+
+### 示例 NETCONF 任务
+
+```yaml
+- name: Backup current switch config (junos)
+  junipernetworks.junos.junos_config:
+    backup: yes
+  register: backup_junos_location
+  when: ansible_network_os == 'junipernetworks.junos.junos'
+```
+
+{{#include ./ce.md:193:}}
diff --git a/src/adv_network/platform_options/meraki.md b/src/adv_network/platform_options/meraki.md
@@ -0,0 +1,34 @@
+# Meraki 平台选项
+
+[`cisco.meraki`](https://galaxy.ansible.com/ui/repo/published/cisco/meraki) 专辑目前只支持 `local` 的连接类型。
+
+> **译注**：Cisco Meraki 是一家云管理 IT 公司，总部位于加利福尼亚州旧金山。其产品包括无线、交换、安全、企业移动管理，enterprise mobility management, EMM，及安全摄像头，所有产品均可通过网络集中管理。Meraki 于 2012 年 12 月被思科系统公司收购，成为其的一家子公司。
+>
+>
+> 参考:
+>
+> - [Cisco Meraki](https://en.wikipedia.org/wiki/Cisco_Meraki)
+
+## 可用连接
+
+
+|  | 仪表板 Dashboard API |
+| 协议 | HTTPS |
+| 凭据 | 使用仪表板中的 API 密钥 |
+| 连接设置 | `ansible_connection: local` |
+| 返回数据格式 | `data.` |
+
+
+## 示例 Meraki 任务
+
+```yaml
+cisco.meraki.meraki_organization:
+  auth_key: abc12345
+  org_name: YourOrg
+  state: present
+delegate_to: localhost
+```
+
+（End）
+
+
diff --git a/src/adv_network/platform_options/netvisor.md b/src/adv_network/platform_options/netvisor.md
@@ -0,0 +1,64 @@
+# Pluribus NETVISOR 平台选项
+
+
+Pluribus NETVISOR Ansible 是 [`community.network`](https://galaxy.ansible.com/ui/repo/published/community/network) 专辑的一部分，目前仅支持 CLI 连接。未来可能会添加 `httpapi` 模组。本页提供了有关如何在 Ansible 中于 NETVISOR 上使用 `ansible.netcommon.network_cli` 的详细介绍。
+
+
+> **译注**：Pluribus 网络技术已被 Arista 于 2022 年 8 月收购。Pluribus NetVisor 操作系统、UNUM（管理）软件、Pluribus Freedom 9000 系列 10G、25G 及 100G 开放网络交换机家族等都已停售、停止支持，生命周期结束。
+>
+>
+> 参考：
+>
+> - [Networking/ONIE/NOS Status](https://www.opencompute.org/wiki/Networking/ONIE/NOS_Status)
+>
+> - [Arista Networks](https://en.wikipedia.org/wiki/Arista_Networks)
+>
+> - [Pluribus Networks Resources](https://www.arista.com/en/support/pluribus-resources)
+
+
+## 可用连接
+
+|  | `CLI` |
+| :-- | :-- |
+| 协议 | SSH |
+| 凭据 | 在存在 SSH 密钥/ `ssh-agent` 时使用 SSH 密钥/`ssh-agent`，在使用密码时接受 `-u my_user -k` 参数 |
+| 间接访问 | 通过堡垒机（跳转主机） |
+| 连接设置 | `ansible_connection: ansible.netcommon.network_cli` |
+| `enable` 模式（权限提升） | 不受 NETVISOR 支持 |
+| 返回数据格式 | `stdout[0].` |
+
+Pluribus NETVISOR 不支持 `ansible_connection: local`。咱们必须使用 `ansible_connection: ansible.netcommon.network_cli`。
+
+
+## 在 Ansible 中使用 CLI
+
+
+### 示例 CLI `group_vars/netvisor.yml`
+
+
+```yaml
+ansible_connection: ansible.netcommon.network_cli
+ansible_network_os: community.netcommon.netvisor
+ansible_user: myuser
+ansible_password: !vault...
+ansible_ssh_common_args: '-o ProxyCommand="ssh -W %h:%p -q bastion01"'
+```
+
+{{#include ./ce.md:43:45}}
+
+
+### 示例 CLI 任务
+
+```yaml
+- name: Create access list
+  community.network.pn_access_list:
+    pn_name: "foo"
+    pn_scope: "local"
+    state: "present"
+  register: acc_list
+  when: ansible_network_os == 'community.network.netvisor'
+```
+
+
+
+{{#include ./ce.md:193:}}
diff --git a/src/adv_network/platform_options/nos.md b/src/adv_network/platform_options/nos.md
@@ -0,0 +1,57 @@
+# NOS 平台选项
+
+
+Extreme NOS 是 `community.network` 专辑的一部分，目前仅支持 CLI 连接。未来可能会添加 `httpapi` 模组。本页详细提供了关于如何在 Ansible 中于 NOS 上使用 `ansible.netcommon.network_cli` 的详细介绍。
+
+> **译注**：Extreme NOS 是 [Extreme Networks](https://www.extremenetworks.com/) 公司搭载于其生产设备上的网络操作系统。
+>
+> 参考：
+>
+> - [Network OS (software)](https://supportdocs.extremenetworks.com/support/documentation/network-os-software-7-3-0/)
+
+
+## 可用连接
+
+
+|  | `CLI` |
+| :-- | :-- |
+| 协议 | SSH |
+| 凭据 | 在存在 SSH 密钥/ `ssh-agent` 时使用 SSH 密钥/`ssh-agent`，在使用密码时接受 `-u my_user -k` 参数 |
+| 间接访问 | 通过堡垒机（跳转主机） |
+| 连接设置 | `ansible_connection: ansible.netcommon.network_cli` |
+| `enable` 模式（权限提升） | 不受 NOS 支持 |
+| 返回数据格式 | `stdout[0].` |
+
+
+NOS 不支持 `ansible_connection: local`。咱们必须使用 `ansible_connection: ansible.netcommon.network_cli`。
+
+
+## 在 Ansible 中使用 CLI
+
+
+### 示例 CLI `group_vars/nos.yml`
+
+```yaml
+ansible_connection: ansible.netcommon.network_cli
+ansible_network_os: community.network.nos
+ansible_user: myuser
+ansible_password: !vault...
+ansible_ssh_common_args: '-o ProxyCommand="ssh -W %h:%p -q bastion01"'
+```
+
+{{#include ./ce.md:43:45}}
+
+
+### 示例 CLI 任务
+
+```yaml
+- name: Get version information (nos)
+  community.network.nos_command:
+    commands: "show version"
+  register: show_ver
+  when: ansible_network_os == 'community.network.nos'
+```
+
+
+
+{{#include ./ce.md:193:}}
diff --git a/src/adv_network/platform_options/nxos.md b/src/adv_network/platform_options/nxos.md
