適用於思科建模實驗室的SD-WAN實驗室部署工具

簡介

本文描述如何在Cisco Modeling Labs(CML)中使用開源實驗室部署工具以自動方式建立Catalyst SD-WAN交換矩陣。

背景資訊

SD-WAN Lab Deployment Tool可自動在CML中建立SD-WAN交換矩陣，並大大簡化許多步驟，包括將SD-WAN邊緣路由器新增到交換矩陣、證書安裝和其他自註冊任務。

在SD-WAN Lab Tool之前，使用者必須在CML中手動部署SD-WAN控制器和邊緣路由器 — 有關詳細資訊，請參閱。

現在，整個過程完全自動化，需要幾分鐘而不是幾小時。請參見此YouTube影片中的Lab Tool簡短演示。

實驗室部署工具的主要優勢

• 完全自動建立SD-WAN控制器
• 在一項自動任務中新增多個具有SD-WAN邊緣路由器的分支
• 兩個SD-WAN傳輸：網際網路和MPLS
• 能夠將延遲引入為WAN鏈路模擬
• 備份和還原功能
• GitHub上的開源回購
• Cisco內部版本SD-WAN Lab工具自建立以來已在不同組織(包括銷售、CX（TAC和PS）和BU)中使用了900多次。請參閱思科內部版本的詳細資訊。

SD-WAN使用案例的CML要求

• CML可以在內部伺服器（裸機或ESXi上的虛擬機器）或AWS上部署。
• 支援群集以增加容量。
• 對於思科內部使用者：可獲取許可證。
• 對於外部客戶：此處提供不同的許可級別。
• 安裝指南（適用於內部和外部使用者）如下。
• SD-WAN模擬的推薦選項：具有少量伺服器的本地CML群集。

SD-WAN實驗室部署工具詳情

• 該工具目前在Linux/MacOS系統上受支援，因為依賴程式包(pyats)僅對這些系統可用。
• 要在Windows上運行該工具，您需要一個Linux VM/容器，或在Windows上使用WSL運行Linux。您可以在檔案中找到所有依賴pyproject.toml項：https://github.com/cisco-open/sdwan-lab-deployment-tool/blob/main/pyproject.toml
• 請參閱GitHub上的所有安裝步驟、使用示例和原始碼。
• 確保運行實驗工具的主機與CML伺服器/群集之間的網路連線速度足夠快。這在SD-WAN控制器的SW映像上傳期間很有幫助。
• 有關於SD-WAN實驗室部署工具的問題嗎？傳送電子郵件至cml-sdwan-lab-tool@external.cisco.com

疑難排解

Python版本不匹配

截至2024年4月底，實驗室工具要求使用Python 3.9版。如果您有更新的Python版本，安裝可能會失敗。請注意，Python 3.12支援即將推出。

由於Python版本錯誤而導致安裝失敗的示例：

(venv) [csdwan] $ pip install --upgrade catalyst-sdwan-lab
Collecting catalyst-sdwan-lab
  Downloading catalyst_sdwan_lab-2.0.9-py3-none-any.whl.metadata (20 kB)
...
  Downloading catalyst_sdwan_lab-2.0.6-py3-none-any.whl.metadata (20 kB)
ERROR: Cannot install catalyst-sdwan-lab==2.0.6, catalyst-sdwan-lab==2.0.7, catalyst-sdwan-lab==2.0.8 and catalyst-sdwan-lab==2.0.9 because these package versions have conflicting dependencies.

The conflict is caused by:
    catalyst-sdwan-lab 2.0.9 depends on pyats<24.0 and >=23.1
    catalyst-sdwan-lab 2.0.8 depends on pyats<24.0 and >=23.1
    catalyst-sdwan-lab 2.0.7 depends on pyats<24.0 and >=23.1
    catalyst-sdwan-lab 2.0.6 depends on pyats<24.0 and >=23.1

To fix this you could try to:
1. loosen the range of package versions you've specified
2. remove package versions to allow pip attempt to solve the dependency conflict

ERROR: ResolutionImpossible: for help visit https://pip.pypa.io/en/latest/topics/dependency-resolution/#dealing-with-dependency-conflicts
(venv) [csdwan] $  

要解決此問題，您可以在環境變數中將Python 3.9放在3.12前面，使用在不同版本(「pyenv global 3.9」)之間切換pyenv，或從3.12降級到3.9。