diff --git a/CVP_GUIDE.md b/CVP_GUIDE.md index ef76b93d5..c9ca2fb34 100644 --- a/CVP_GUIDE.md +++ b/CVP_GUIDE.md @@ -133,7 +133,7 @@ export CATALYST_CENTER_PASSWORD='' > All `ansible-playbook` examples below assume this inventory exists at > `inventory/hosts.yml`. Per-CVP README files (e.g. -> [cvp/swim/README.md](cvp/swim/README.md)) use the same pattern. +> [cvp/swim/README.md](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/swim/README.md)) use the same pattern. --- @@ -256,7 +256,7 @@ separate play that inherits the imported playbook's `hosts:` (here: `catalyst_center_hosts`), so the inventory must define that group. Per-CVP inputs are passed via the `vars:` block as `VARS_FILE_PATH`, resolved **relative to the imported playbook's directory** (see VARS_FILE_PATH note -in any per-CVP README, e.g. [cvp/swim/README.md](cvp/swim/README.md)). +in any per-CVP README, e.g. [cvp/swim/README.md](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/swim/README.md)). ```yaml # deploy-all.yml @@ -286,6 +286,8 @@ ansible-playbook -i inventory/hosts.yml deploy-all.yml ## 🔄 CI/CD Integration +For Red Hat certified deployments, run these examples inside an Ansible Execution Environment or runner image that already includes `ansible-core >= 2.16` with Python `3.12`. The examples below only install the Cisco Catalyst Center Python SDK with `pip`. + ### GitHub Actions ```yaml @@ -308,11 +310,11 @@ jobs: - name: Set up Python uses: actions/setup-python@v4 with: - python-version: '3.11' + python-version: '3.12' - name: Install dependencies run: | - pip install ansible catalystcentersdk + pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter - name: Copy CVPs @@ -358,12 +360,12 @@ variables: CVP_VERSION: "2.7.0" .install_ansible: &install_ansible - - pip install ansible catalystcentersdk + - pip install catalystcentersdk - ansible-galaxy collection install cisco.catalystcenter:${CVP_VERSION} prepare: stage: prepare - image: python:3.11 + image: python:3.12 script: - *install_ansible - mkdir -p cvp @@ -375,7 +377,7 @@ prepare: validate: stage: validate - image: python:3.11 + image: python:3.12 dependencies: - prepare script: @@ -385,7 +387,7 @@ validate: deploy: stage: deploy - image: python:3.11 + image: python:3.12 dependencies: - prepare script: @@ -427,7 +429,7 @@ pipeline { sh ''' python3 -m venv venv . venv/bin/activate - pip install ansible catalystcentersdk + pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter ''' } @@ -494,9 +496,9 @@ Establish foundational access control and integrate with external systems. | CVP | Description | README | |-----|-------------|--------| -| **users_and_roles** | Role Based Access Control and Users Management | [📖 Guide](cvp/users_and_roles/README.md) | -| **ise_radius_integration** | ISE and AAA Servers Integration | [📖 Guide](cvp/ise_radius_integration/README.md) | -| **ansible_vault_update** | Update Ansible Vault encrypted credentials | [📖 Guide](cvp/ansible_vault_update/README.md) | +| **users_and_roles** | Role Based Access Control and Users Management | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/users_and_roles/README.md) | +| **ise_radius_integration** | ISE and AAA Servers Integration | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/ise_radius_integration/README.md) | +| **ansible_vault_update** | Update Ansible Vault encrypted credentials | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/ansible_vault_update/README.md) | --- @@ -506,19 +508,19 @@ Design your network hierarchy, configure settings, and discover devices. | CVP | Description | README | |-----|-------------|--------| -| **site_hierarchy** | Site Hierarchy and Floor Maps design | [📖 Guide](cvp/site_hierarchy/README.md) ⭐ | -| **device_credentials** | Device Credentials configurations and assignment | [📖 Guide](cvp/device_credentials/README.md) | -| **network_settings** | Network Settings (Servers, Banners, TZ, SNMP, Logging, Telemetry) | [📖 Guide](cvp/network_settings/README.md) | -| **wireless_design** | Wireless Design Management | [📖 Guide](cvp/wireless_design/README.md) | -| **network_profile_wireless** | Wireless Network Profile Management | [📖 Guide](cvp/network_profile_wireless/README.md) | -| **network_profile_switching** | Network Profile Switching Management | [📖 Guide](cvp/network_profile_switching/README.md) | -| **device_discovery** | Devices Discovery | [📖 Guide](cvp/device_discovery/README.md) ⭐ | -| **inventory** | Device Inventory and device management | [📖 Guide](cvp/inventory/README.md) | -| **plug_and_play** | Plug and Play Device Onboarding | [📖 Guide](cvp/plug_and_play/README.md) | -| **provision** | Device Provisioning and Re-Provisioning Management | [📖 Guide](cvp/provision/README.md) | -| **device_templates** | Design and Deploy Device Templates | [📖 Guide](cvp/device_templates/README.md) | -| **tags_manager** | Tags Management | [📖 Guide](cvp/tags_manager/README.md) | -| **access_point_location** | Access Point location management on floor maps | [📖 Guide](cvp/access_point_location/README.md) | +| **site_hierarchy** | Site Hierarchy and Floor Maps design | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/site_hierarchy/README.md) ⭐ | +| **device_credentials** | Device Credentials configurations and assignment | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/device_credentials/README.md) | +| **network_settings** | Network Settings (Servers, Banners, TZ, SNMP, Logging, Telemetry) | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/network_settings/README.md) | +| **wireless_design** | Wireless Design Management | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/wireless_design/README.md) | +| **network_profile_wireless** | Wireless Network Profile Management | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/network_profile_wireless/README.md) | +| **network_profile_switching** | Network Profile Switching Management | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/network_profile_switching/README.md) | +| **device_discovery** | Devices Discovery | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/device_discovery/README.md) ⭐ | +| **inventory** | Device Inventory and device management | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/inventory/README.md) | +| **plug_and_play** | Plug and Play Device Onboarding | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/plug_and_play/README.md) | +| **provision** | Device Provisioning and Re-Provisioning Management | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/provision/README.md) | +| **device_templates** | Design and Deploy Device Templates | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/device_templates/README.md) | +| **tags_manager** | Tags Management | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/tags_manager/README.md) | +| **access_point_location** | Access Point location management on floor maps | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/access_point_location/README.md) | --- @@ -528,16 +530,16 @@ Configure underlay automation and SD-Access fabric. | CVP | Description | README | |-----|-------------|--------| -| **lan_automation** | Underlay Automation (LAN Automation) Management | [📖 Guide](cvp/lan_automation/README.md) | -| **sda_fabric_sites_zones** | SDA Fabric Site and Fabric Zones | [📖 Guide](cvp/sda_fabric_sites_zones/README.md) ⭐ | -| **sda_fabric_transits** | SDA Fabric Transits (IP transit and SDA Transit) Management | [📖 Guide](cvp/sda_fabric_transits/README.md) | -| **sda_virtual_networks_l2l3_gateways** | Virtual Networks and L3 Anycast Gateways and L2 VLANs Management | [📖 Guide](cvp/sda_virtual_networks_l2l3_gateways/README.md) | -| **sda_fabric_device_roles** | SDA Fabric Device assignment to fabric sites and zones | [📖 Guide](cvp/sda_fabric_device_roles/README.md) | -| **sda_hostonboarding** | SDA Fabric Devices and Host Onboarding | [📖 Guide](cvp/sda_hostonboarding/README.md) | -| **sda_fabric_discover_and_onboard_fabric_devices** | Discover and onboard devices into the SDA fabric | [📖 Guide](cvp/sda_fabric_discover_and_onboard_fabric_devices/README.md) | -| **sda_fabric_extranet_policy** | SDA Extranet Policies Management | [📖 Guide](cvp/sda_fabric_extranet_policy/README.md) | -| **sda_fabric_multicast** | SDA Fabric Multicast Management | [📖 Guide](cvp/sda_fabric_multicast/README.md) | -| **application_policy** | Application Policy Management | [📖 Guide](cvp/application_policy/README.md) | +| **lan_automation** | Underlay Automation (LAN Automation) Management | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/lan_automation/README.md) | +| **sda_fabric_sites_zones** | SDA Fabric Site and Fabric Zones | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/sda_fabric_sites_zones/README.md) ⭐ | +| **sda_fabric_transits** | SDA Fabric Transits (IP transit and SDA Transit) Management | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/sda_fabric_transits/README.md) | +| **sda_virtual_networks_l2l3_gateways** | Virtual Networks and L3 Anycast Gateways and L2 VLANs Management | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/sda_virtual_networks_l2l3_gateways/README.md) | +| **sda_fabric_device_roles** | SDA Fabric Device assignment to fabric sites and zones | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/sda_fabric_device_roles/README.md) | +| **sda_hostonboarding** | SDA Fabric Devices and Host Onboarding | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/sda_hostonboarding/README.md) | +| **sda_fabric_discover_and_onboard_fabric_devices** | Discover and onboard devices into the SDA fabric | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/sda_fabric_discover_and_onboard_fabric_devices/README.md) | +| **sda_fabric_extranet_policy** | SDA Extranet Policies Management | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/sda_fabric_extranet_policy/README.md) | +| **sda_fabric_multicast** | SDA Fabric Multicast Management | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/sda_fabric_multicast/README.md) | +| **application_policy** | Application Policy Management | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/application_policy/README.md) | --- @@ -547,20 +549,20 @@ Ongoing operations including software upgrades, compliance, backups, and assuran | CVP | Description | README | |-----|-------------|--------| -| **swim** | Devices Software image management (SWIM) | [📖 Guide](cvp/swim/README.md) | -| **network_compliance** | Device compliance and remediation management | [📖 Guide](cvp/network_compliance/README.md) | -| **events_and_notifications** | Notification Destination and Events Subscription | [📖 Guide](cvp/events_and_notifications/README.md) | -| **device_replacement_rma** | Devices Replacement Management | [📖 Guide](cvp/device_replacement_rma/README.md) | -| **accesspoints_configuration_provisioning** | Access Point Provisioning and Configuration Management | [📖 Guide](cvp/accesspoints_configuration_provisioning/README.md) | -| **device_config_backup** | Managed network devices configurations backup management | [📖 Guide](cvp/device_config_backup/README.md) | -| **assurance_health_score_settings** | Assurance Health Score KPIs settings and thresholds management | [📖 Guide](cvp/assurance_health_score_settings/README.md) | -| **assurance_pathtrace** | Assurance Path Trace Management | [📖 Guide](cvp/assurance_pathtrace/README.md) | -| **assurance_issues_management** | Assurance issues and events management | [📖 Guide](cvp/assurance_issues_management/README.md) | -| **assurance_intelligent_capture** | Assurance ICAP Management | [📖 Guide](cvp/assurance_intelligent_capture/README.md) | -| **fabric_devices_info** | SDA Fabric Devices Information and Inventory Management | [📖 Guide](cvp/fabric_devices_info/README.md) | -| **network_devices_info** | Network Devices Information and Inventory Management | [📖 Guide](cvp/network_devices_info/README.md) | -| **backup_and_restore** | Configuration Backup and Restore Management | [📖 Guide](cvp/backup_and_restore/README.md) | -| **reports** | Reports Management and Scheduling | [📖 Guide](cvp/reports/README.md) | +| **swim** | Devices Software image management (SWIM) | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/swim/README.md) | +| **network_compliance** | Device compliance and remediation management | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/network_compliance/README.md) | +| **events_and_notifications** | Notification Destination and Events Subscription | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/events_and_notifications/README.md) | +| **device_replacement_rma** | Devices Replacement Management | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/device_replacement_rma/README.md) | +| **accesspoints_configuration_provisioning** | Access Point Provisioning and Configuration Management | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/accesspoints_configuration_provisioning/README.md) | +| **device_config_backup** | Managed network devices configurations backup management | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/device_config_backup/README.md) | +| **assurance_health_score_settings** | Assurance Health Score KPIs settings and thresholds management | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/assurance_health_score_settings/README.md) | +| **assurance_pathtrace** | Assurance Path Trace Management | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/assurance_pathtrace/README.md) | +| **assurance_issues_management** | Assurance issues and events management | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/assurance_issues_management/README.md) | +| **assurance_intelligent_capture** | Assurance ICAP Management | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/assurance_intelligent_capture/README.md) | +| **fabric_devices_info** | SDA Fabric Devices Information and Inventory Management | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/fabric_devices_info/README.md) | +| **network_devices_info** | Network Devices Information and Inventory Management | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/network_devices_info/README.md) | +| **backup_and_restore** | Configuration Backup and Restore Management | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/backup_and_restore/README.md) | +| **reports** | Reports Management and Scheduling | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/reports/README.md) | --- @@ -570,8 +572,8 @@ Specialized workflows for migration scenarios. | CVP | Description | README | |-----|-------------|--------| -| **sda_port_assignment_migration** | SDA Port Assignment Migration | [📖 Guide](cvp/sda_port_assignment_migration/README.md) | -| **sda_device_removal_and_unprovision** | SDA Device Removal and Unprovision | [📖 Guide](cvp/sda_device_removal_and_unprovision/README.md) | +| **sda_port_assignment_migration** | SDA Port Assignment Migration | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/sda_port_assignment_migration/README.md) | +| **sda_device_removal_and_unprovision** | SDA Device Removal and Unprovision | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/sda_device_removal_and_unprovision/README.md) | --- @@ -581,35 +583,35 @@ Extract current configurations for documentation or migration purposes. | CVP | Description | README | |-----|-------------|--------| -| **accesspoint_config_generator** | Access Point Config Generator | [📖 Guide](cvp/accesspoint_config_generator/README.md) | -| **accesspoint_location_config_generator** | Access Point Location Config Generator | [📖 Guide](cvp/accesspoint_location_config_generator/README.md) | -| **application_policy_config_generator** | Application Policy Config Generator | [📖 Guide](cvp/application_policy_config_generator/README.md) | -| **assurance_device_health_score_settings_config_generator** | Assurance Device Health Score Settings Config Generator | [📖 Guide](cvp/assurance_device_health_score_settings_config_generator/README.md) | -| **assurance_issue_config_generator** | Assurance Issue Config Generator | [📖 Guide](cvp/assurance_issue_config_generator/README.md) | -| **backup_and_restore_config_generator** | Backup and Restore Config Generator | [📖 Guide](cvp/backup_and_restore_config_generator/README.md) | -| **device_credential_config_generator** | Device Credential Config Generator | [📖 Guide](cvp/device_credential_config_generator/README.md) | -| **discovery_config_generator** | Discovery Config Generator | [📖 Guide](cvp/discovery_config_generator/README.md) | -| **events_and_notifications_config_generator** | Events and Notifications Config Generator | [📖 Guide](cvp/events_and_notifications_config_generator/README.md) | -| **inventory_config_generator** | Inventory Config Generator | [📖 Guide](cvp/inventory_config_generator/README.md) | -| **ise_radius_integration_config_generator** | ISE Radius Integration Config Generator | [📖 Guide](cvp/ise_radius_integration_config_generator/README.md) | -| **network_profile_switching_config_generator** | Network Profile Switching Config Generator | [📖 Guide](cvp/network_profile_switching_config_generator/README.md) | -| **network_profile_wireless_config_generator** | Network Profile Wireless Config Generator | [📖 Guide](cvp/network_profile_wireless_config_generator/README.md) | -| **network_settings_config_generator** | Network Settings Config Generator | [📖 Guide](cvp/network_settings_config_generator/README.md) | -| **pnp_config_generator** | PnP Config Generator | [📖 Guide](cvp/pnp_config_generator/README.md) | -| **provision_config_generator** | Provision Config Generator | [📖 Guide](cvp/provision_config_generator/README.md) | -| **sda_extranet_policies_config_generator** | SDA Extranet Policies Config Generator | [📖 Guide](cvp/sda_extranet_policies_config_generator/README.md) | -| **sda_fabric_devices_config_generator** | SDA Fabric Devices Config Generator | [📖 Guide](cvp/sda_fabric_devices_config_generator/README.md) | -| **sda_fabric_multicast_config_generator** | SDA Fabric Multicast Config Generator | [📖 Guide](cvp/sda_fabric_multicast_config_generator/README.md) | -| **sda_fabric_sites_zones_config_generator** | SDA Fabric Sites Zones Config Generator | [📖 Guide](cvp/sda_fabric_sites_zones_config_generator/README.md) | -| **sda_fabric_transits_config_generator** | SDA Fabric Transits Config Generator | [📖 Guide](cvp/sda_fabric_transits_config_generator/README.md) | -| **sda_fabric_virtual_networks_config_generator** | SDA Fabric Virtual Networks Config Generator | [📖 Guide](cvp/sda_fabric_virtual_networks_config_generator/README.md) | -| **sda_host_port_onboarding_config_generator** | SDA Host Port Onboarding Config Generator | [📖 Guide](cvp/sda_host_port_onboarding_config_generator/README.md) | -| **site_config_generator** | Site Config Generator | [📖 Guide](cvp/site_config_generator/README.md) | -| **tags_config_generator** | Tags Config Generator | [📖 Guide](cvp/tags_config_generator/README.md) | -| **template_config_generator** | Template Config Generator | [📖 Guide](cvp/template_config_generator/README.md) | -| **user_role_config_generator** | User Role Config Generator | [📖 Guide](cvp/user_role_config_generator/README.md) | -| **wired_campus_automation_config_generator** | Wired Campus Automation Config Generator | [📖 Guide](cvp/wired_campus_automation_config_generator/README.md) | -| **wireless_design_config_generator** | Wireless Design Config Generator | [📖 Guide](cvp/wireless_design_config_generator/README.md) | +| **accesspoint_config_generator** | Access Point Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/accesspoint_config_generator/README.md) | +| **accesspoint_location_config_generator** | Access Point Location Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/accesspoint_location_config_generator/README.md) | +| **application_policy_config_generator** | Application Policy Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/application_policy_config_generator/README.md) | +| **assurance_device_health_score_settings_config_generator** | Assurance Device Health Score Settings Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/assurance_device_health_score_settings_config_generator/README.md) | +| **assurance_issue_config_generator** | Assurance Issue Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/assurance_issue_config_generator/README.md) | +| **backup_and_restore_config_generator** | Backup and Restore Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/backup_and_restore_config_generator/README.md) | +| **device_credential_config_generator** | Device Credential Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/device_credential_config_generator/README.md) | +| **discovery_config_generator** | Discovery Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/discovery_config_generator/README.md) | +| **events_and_notifications_config_generator** | Events and Notifications Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/events_and_notifications_config_generator/README.md) | +| **inventory_config_generator** | Inventory Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/inventory_config_generator/README.md) | +| **ise_radius_integration_config_generator** | ISE Radius Integration Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/ise_radius_integration_config_generator/README.md) | +| **network_profile_switching_config_generator** | Network Profile Switching Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/network_profile_switching_config_generator/README.md) | +| **network_profile_wireless_config_generator** | Network Profile Wireless Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/network_profile_wireless_config_generator/README.md) | +| **network_settings_config_generator** | Network Settings Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/network_settings_config_generator/README.md) | +| **pnp_config_generator** | PnP Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/pnp_config_generator/README.md) | +| **provision_config_generator** | Provision Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/provision_config_generator/README.md) | +| **sda_extranet_policies_config_generator** | SDA Extranet Policies Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/sda_extranet_policies_config_generator/README.md) | +| **sda_fabric_devices_config_generator** | SDA Fabric Devices Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/sda_fabric_devices_config_generator/README.md) | +| **sda_fabric_multicast_config_generator** | SDA Fabric Multicast Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/sda_fabric_multicast_config_generator/README.md) | +| **sda_fabric_sites_zones_config_generator** | SDA Fabric Sites Zones Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/sda_fabric_sites_zones_config_generator/README.md) | +| **sda_fabric_transits_config_generator** | SDA Fabric Transits Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/sda_fabric_transits_config_generator/README.md) | +| **sda_fabric_virtual_networks_config_generator** | SDA Fabric Virtual Networks Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/sda_fabric_virtual_networks_config_generator/README.md) | +| **sda_host_port_onboarding_config_generator** | SDA Host Port Onboarding Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/sda_host_port_onboarding_config_generator/README.md) | +| **site_config_generator** | Site Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/site_config_generator/README.md) | +| **tags_config_generator** | Tags Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/tags_config_generator/README.md) | +| **template_config_generator** | Template Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/template_config_generator/README.md) | +| **user_role_config_generator** | User Role Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/user_role_config_generator/README.md) | +| **wired_campus_automation_config_generator** | Wired Campus Automation Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/wired_campus_automation_config_generator/README.md) | +| **wireless_design_config_generator** | Wireless Design Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/wireless_design_config_generator/README.md) | > **Note**: ⭐ indicates the most commonly used CVPs for getting started. @@ -750,9 +752,10 @@ with `-i`. Setting `-e catalystcenter_host=...` alone will not fix this. ## 📞 Support +- **Automation Hub Support**: For certified content, use `Create issue` from the [Cisco Catalyst Center collection page on Red Hat Automation Hub](https://console.redhat.com/ansible/automation-hub/repo/published/cisco/catalystcenter/). - **Documentation**: [Collection Docs](https://cisco-en-programmability.github.io/catalystcenter-ansible/) -- **Issues**: [GitHub Issues](https://github.com/cisco-en-programmability/catalystcenter-ansible/issues) - **Community**: [Ansible Community](https://docs.ansible.com/ansible/latest/community/) +- **Community Issues**: [GitHub Issues](https://github.com/cisco-en-programmability/catalystcenter-ansible/issues) --- diff --git a/README.md b/README.md index d6162bb18..64792a921 100644 --- a/README.md +++ b/README.md @@ -192,7 +192,7 @@ Roles reduce boilerplate by providing sensible defaults for connection parameter **Config Generator Roles**: Add `_config_generator` suffix to any of the following: `accesspoint`, `accesspoint_location`, `application_policy`, `assurance_device_health_score_settings`, `assurance_issue`, `backup_and_restore`, `device_credential`, `discovery`, `events_and_notifications`, `inventory`, `ise_radius_integration`, `network_profile_switching`, `network_profile_wireless`, `network_settings`, `pnp`, `provision`, `rma`, `sda_extranet_policies`, `sda_fabric_devices`, `sda_fabric_multicast`, `sda_fabric_sites_zones`, `sda_fabric_transits`, `sda_fabric_virtual_networks`, `sda_host_port_onboarding`, `site`, `tags`, `template`, `user_role`, `wired_campus_automation`, `wireless_design` -For detailed role documentation, examples, and best practices, see [ROLES_GUIDE.md](ROLES_GUIDE.md) and the [example roles playbook](playbooks/example_roles_playbook.yml). +For detailed role documentation, examples, and best practices, see [ROLES_GUIDE.md](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/ROLES_GUIDE.md) and the [example roles playbook](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/playbooks/example_roles_playbook.yml). ## CVP - Cisco Validated Playbooks @@ -245,7 +245,7 @@ ansible-playbook playbook/site_hierarchy_playbook.yml | **Playbooks** | Quick examples | `playbooks/tag.yml` | | **CVP** | Production deployments | `cvp/site_hierarchy/` ⭐ | -For complete CVP documentation, catalog, and usage examples, see [CVP_GUIDE.md](CVP_GUIDE.md) and [cvp/README.md](cvp/README.md). +For complete CVP documentation, catalog, and usage examples, see [CVP_GUIDE.md](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/CVP_GUIDE.md) and [cvp/README.md](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/README.md). ## Use Cases @@ -288,7 +288,7 @@ Please read and familiarize yourself with this document. This collection is available on both Ansible Galaxy and Red Hat Automation Hub. -For certified content obtained from Red Hat Automation Hub, support is provided through Red Hat Ansible Automation Platform according to your subscription agreement. +For certified content obtained from Red Hat Automation Hub, open support requests from the collection page using `Create issue`: [Cisco Catalyst Center on Red Hat Automation Hub](https://console.redhat.com/ansible/automation-hub/repo/published/cisco/catalystcenter/). Support is provided through Red Hat Ansible Automation Platform according to your subscription agreement. For content obtained from Ansible Galaxy, community support may be available via: - [Ansible Forum](https://forum.ansible.com/) @@ -319,7 +319,7 @@ This collection follows [Semantic Versioning](https://semver.org/). For roadmap ## License -This collection is licensed under the Cisco Sample Code License. +This collection is licensed under the GNU General Public License v3.0 or later (GPL-3.0-or-later). The full license text is available in the [LICENSE](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/LICENSE) file. diff --git a/cvp/README.md b/cvp/README.md index 75a0a06d9..990fed9ce 100644 --- a/cvp/README.md +++ b/cvp/README.md @@ -404,6 +404,8 @@ yamale -s schema/sites_schema.yml vars/site_hierarchy_design_vars.yml ## 🚀 CI/CD Integration +For Red Hat certified deployments, use an Ansible Execution Environment or runner image that already includes `ansible-core >= 2.16` with Python `3.12`. The example below installs only the Cisco Catalyst Center Python SDK. + ### GitHub Actions ```yaml @@ -419,9 +421,9 @@ jobs: steps: - uses: actions/checkout@v3 - - name: Install Ansible + - name: Install Collection Dependencies run: | - pip install ansible catalystcentersdk + pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter - name: Copy CVP @@ -446,8 +448,9 @@ For issues or questions about CVPs: 1. **Check CVP README** - Each CVP has detailed documentation 2. **Review Examples** - Look at the vars/ directory for examples -3. **Open an Issue** - [GitHub Issues](https://github.com/cisco-en-programmability/catalystcenter-ansible/issues) +3. **Certified Support** - Use `Create issue` from the [Cisco Catalyst Center collection page on Red Hat Automation Hub](https://console.redhat.com/ansible/automation-hub/repo/published/cisco/catalystcenter/) 4. **Consult Documentation** - [Collection Documentation](https://cisco-en-programmability.github.io/catalystcenter-ansible/) +5. **Community Issues** - [GitHub Issues](https://github.com/cisco-en-programmability/catalystcenter-ansible/issues) --- diff --git a/cvp/access_point_location/README.md b/cvp/access_point_location/README.md index 6404b109c..c445c6955 100644 --- a/cvp/access_point_location/README.md +++ b/cvp/access_point_location/README.md @@ -188,7 +188,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -248,7 +248,7 @@ accesspoint_location_details: elevation: 30 ``` -![alt text](./images/image1.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/access_point_location/images/image1.png) ##### 2. **Update Planned Access Point Position** *Example*: Modify existing planned AP position and radio settings. @@ -289,7 +289,7 @@ accesspoint_location_details: elevation: 30 ``` -![alt text](./images/image2.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/access_point_location/images/image2.png) ##### 3. **Create Planned Position with Dual-Band Radio** *Example*: Configure an AP with a single dual-band radio. @@ -315,7 +315,7 @@ accesspoint_location_details: elevation: 20 ``` -![alt text](./images/image3.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/access_point_location/images/image3.png) ##### 3. **Assign Planned Access Point to Real Access Point** *Example*: Map a planned position to an actual physical AP. @@ -331,7 +331,7 @@ accesspoint_location_details: action: "assign_planned_ap" mac_address: "68:7d:b4:06:b0:a0" ``` -![alt text](./images/image4.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/access_point_location/images/image4.png) ##### 4. **Create Real AP Position** *Example*: Create a real AP position directly (without planned position). @@ -365,7 +365,7 @@ accesspoint_location_details: elevation: 30 ``` -![alt text](./images/image5.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/access_point_location/images/image5.png) ##### 6. **Update Real AP Position (Partial Update)** *Example*: Update only position and antenna settings for a real AP. @@ -400,7 +400,7 @@ accesspoint_location_details: azimuth: 20 elevation: 30 ``` -![alt text](./images/image6.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/access_point_location/images/image6.png) ##### 7. **Create Access Point with 6GHz Radio** @@ -426,7 +426,7 @@ accesspoint_location_details: azimuth: 90 elevation: 0 ``` -![alt text](./images/image7.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/access_point_location/images/image7.png) **Validate** @@ -608,7 +608,7 @@ accesspoint_location_details: access_points: - accesspoint_name: "AP687D.B402.1614-AP-location_Test2" ``` -![alt text](./images/image9.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/access_point_location/images/image9.png) ##### 2. **Delete real AP position from Planned Position** *Example*: Remove real AP from its assigned planned position. @@ -623,7 +623,7 @@ accesspoint_location_details: - accesspoint_name: "AP687D.B402.1614-AP-Test6" action: "manage_real_ap" ``` -![alt text](./images/image8.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/access_point_location/images/image8.png) --- ## Example Output 1.Delete Planned AP positions diff --git a/cvp/accesspoint_config_generator/README.md b/cvp/accesspoint_config_generator/README.md index 407c1d614..d398fbab5 100644 --- a/cvp/accesspoint_config_generator/README.md +++ b/cvp/accesspoint_config_generator/README.md @@ -125,7 +125,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/accesspoint_location_config_generator/README.md b/cvp/accesspoint_location_config_generator/README.md index 587886631..081d5f9fc 100644 --- a/cvp/accesspoint_location_config_generator/README.md +++ b/cvp/accesspoint_location_config_generator/README.md @@ -133,7 +133,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/accesspoints_configuration_provisioning/README.md b/cvp/accesspoints_configuration_provisioning/README.md index 1755bbc87..27d279537 100644 --- a/cvp/accesspoints_configuration_provisioning/README.md +++ b/cvp/accesspoints_configuration_provisioning/README.md @@ -276,7 +276,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -517,37 +517,37 @@ response: #### **b. Mapping config to UI Actions.** - Select Workflows to enter the workflows page -![alt text](./images/configuretion_ap_1.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/accesspoints_configuration_provisioning/images/configuretion_ap_1.png) - On the workflows page, search for "Configure Access Points" -> Select the task "Configure Access Points". -![alt text](./images/configuretion_ap_2.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/accesspoints_configuration_provisioning/images/configuretion_ap_2.png) - On the Get Started page, enter Task Name -> Next. -![alt text](./images/configuretion_ap_3.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/accesspoints_configuration_provisioning/images/configuretion_ap_3.png) - Perform some options for the Configurre Access Points section including Radio and Steps. -![alt text](./images/configuretion_ap_4.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/accesspoints_configuration_provisioning/images/configuretion_ap_4.png) - On the Selected Access Points page, select the Access Point you want to configure. -![alt text](./images/configuretion_ap_5.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/accesspoints_configuration_provisioning/images/configuretion_ap_5.png) - On the Selected Access Points page, select the Access Point you want to configure -> Next. -![alt text](./images/configuretion_ap_6.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/accesspoints_configuration_provisioning/images/configuretion_ap_6.png) - On the Configure AP Parameters page, perform the options you want to configure -> Next. -![alt text](./images/configuretion_ap_7.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/accesspoints_configuration_provisioning/images/configuretion_ap_7.png) - On the Configure 5 GHZ Radio Rarameters page, perform the options you want to configure (This page is only displayed if you select configure 5 GHz) -> Next. -![alt text](./images/configuretion_ap_8.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/accesspoints_configuration_provisioning/images/configuretion_ap_8.png) - On the Configure 2.4 GHZ Radio Rarameters page, perform the options you want to configure (This page is only displayed if you select configure 2.4 GHz) -> Next. Note, for Access Points that cannot configure 2.4 GHZ Radio Rarameters, this page is still displayed but you cannot configure. -![alt text](./images/configuretion_ap_9.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/accesspoints_configuration_provisioning/images/configuretion_ap_9.png) - On the Configure 6 GHZ Radio Rarameters page, perform the options you want to configure (This page is only displayed if you choose to configure 6 GHz) -> Next. Note, for Access Points that cannot configure 6 GHZ Radio Rarameters, this page is still displayed but you cannot configure. -![alt text](./images/configuretion_ap_10.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/accesspoints_configuration_provisioning/images/configuretion_ap_10.png) - On the Configure Dual-Band (XOR) Radio Rarameters page, perform the options you want to configure (This page is only displayed if you choose to configure Dual-Band (XOR) ) -> Next. -![alt text](./images/configuretion_ap_11.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/accesspoints_configuration_provisioning/images/configuretion_ap_11.png) - On the Configure Tri-Radio Rarameters page, perform the options you want to configure (This page is only displayed if you choose to configure Tri-Radio ) -> Next. -![alt text](./images/configuretion_ap_12.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/accesspoints_configuration_provisioning/images/configuretion_ap_12.png) - On the Save As Reusable Template page, enter Template Name -> Next to save the task name. -![alt text](./images/configuretion_ap_13.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/accesspoints_configuration_provisioning/images/configuretion_ap_13.png) - On the Summary page, check the selected parameters -> Next -![alt text](./images/configuretion_ap_14.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/accesspoints_configuration_provisioning/images/configuretion_ap_14.png) A- t the Provision Schedule, enter Task Name -> Configure. -![alt text](./images/configuretion_ap_15.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/accesspoints_configuration_provisioning/images/configuretion_ap_15.png) - Finally, check Preview Configuration -> Deploy. -![alt text](./images/configuretion_ap_16.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/accesspoints_configuration_provisioning/images/configuretion_ap_16.png) ### 2. Creating Bulk Accesspoint Configuration using JINJA template and using the playbook: #### a. JINJA Template diff --git a/cvp/ansible_vault_update/README.md b/cvp/ansible_vault_update/README.md index 618b21250..5da71a823 100644 --- a/cvp/ansible_vault_update/README.md +++ b/cvp/ansible_vault_update/README.md @@ -56,7 +56,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/application_policy/README.md b/cvp/application_policy/README.md index 9e6cc993f..b1a1270ef 100644 --- a/cvp/application_policy/README.md +++ b/cvp/application_policy/README.md @@ -38,7 +38,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -222,11 +222,11 @@ A. Create Queuing Profile (state: merged) Image with bandwidth_settings input on UI: -![alt text](images/create_queuing_profiles.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/application_policy/images/create_queuing_profiles.png) Image with dscp_settings input on UI: -![alt text](images/create_queuing_profiles_dscp.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/application_policy/images/create_queuing_profiles_dscp.png) This example defines two queuing profiles to classify and prioritize different types of network traffic: @@ -348,7 +348,7 @@ C. Create Application (state: merged): Image add Application on UI: -![alt text](images/create_application.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/application_policy/images/create_application.png) This example defines two applications for network traffic identification: @@ -438,7 +438,7 @@ E. Create Application Policy (state: merged): Image add Application Policy on UI: -![alt text](images/create_application_policy.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/application_policy/images/create_application_policy.png) This example creates two application policies: @@ -614,11 +614,11 @@ After executing the playbook, check the Catalyst Center UI to verify switch prof - Verify Queuing Profiles: - ![alt text](images/queuing_profiles.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/application_policy/images/queuing_profiles.png) - Verify Application Policy: -![alt text](images/application_policy1.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/application_policy/images/application_policy1.png) ## References diff --git a/cvp/application_policy_config_generator/README.md b/cvp/application_policy_config_generator/README.md index 65180ab68..555340808 100644 --- a/cvp/application_policy_config_generator/README.md +++ b/cvp/application_policy_config_generator/README.md @@ -121,7 +121,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/assurance_device_health_score_settings_config_generator/README.md b/cvp/assurance_device_health_score_settings_config_generator/README.md index 2f56df54c..743d94dbd 100644 --- a/cvp/assurance_device_health_score_settings_config_generator/README.md +++ b/cvp/assurance_device_health_score_settings_config_generator/README.md @@ -144,7 +144,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/assurance_health_score_settings/README.md b/cvp/assurance_health_score_settings/README.md index 53bbb52fd..ec1252e8d 100644 --- a/cvp/assurance_health_score_settings/README.md +++ b/cvp/assurance_health_score_settings/README.md @@ -57,7 +57,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -147,7 +147,7 @@ assurance_health_score_settings: synchronize_to_issue_threshold: false ``` mapping config to UI Actions: -![alt text](./images/Unified_AP_Custom1.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_health_score_settings/images/Unified_AP_Custom1.png) 2. **Health Score Custom Settings for device family wired client** configures custom Assurance Health Score thresholds for wired client in Cisco Catalyst Center. It allows tuning KPI thresholds and inclusion in overall health scoring. @@ -163,7 +163,7 @@ assurance_health_score_settings: synchronize_to_issue_threshold: false ``` mapping config to UI Actions: -![alt text](./images/wired_client_custom.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_health_score_settings/images/wired_client_custom.png) 3. **Health Score Custom Settings for device family wireless client** configures custom Assurance Health Score thresholds for wireless client in Cisco Catalyst Center. It allows tuning KPI thresholds and inclusion in overall health scoring. @@ -183,7 +183,7 @@ assurance_health_score_settings: synchronize_to_issue_threshold: true ``` mapping config to UI Actions: -![alt text](./images/wireless_client_custom.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_health_score_settings/images/wireless_client_custom.png) 4. **Health Score Custom Settings for device family wireless controler** configures assurance health score settings for WIRELESS_CONTROLLER device family in Cisco Catalyst Center. It defines KPIs with specific thresholds and whether they contribute to the overall health score. @@ -223,7 +223,7 @@ assurance_health_score_settings: include_for_overall_health: false ``` mapping config to UI Actions: -![alt text](./images/wireless_controller_custom.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_health_score_settings/images/wireless_controller_custom.png) 5. **Health Score Custom Setting for device family switches and hub** configures assurance health score settings for SWITCH_AND_HUB device family in Cisco Catalyst Center. It defines KPIs with specific thresholds and whether they contribute to the overall health score. @@ -252,7 +252,7 @@ assurance_health_score_settings: synchronize_to_issue_threshold: false ``` mapping config to UI Actions: -![alt text](./images/switches_and_hub_custom.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_health_score_settings/images/switches_and_hub_custom.png) 6. **Health Score Custom Setting for device family Router** configures assurance health score settings for ROUTER device family in Cisco Catalyst Center. It defines KPIs with specific thresholds and whether they contribute to the overall health score. @@ -278,7 +278,7 @@ assurance_health_score_settings: synchronize_to_issue_threshold: false ``` mapping config to UI Actions: -![alt text](./images/router_custom.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_health_score_settings/images/router_custom.png) 7. **Health Score Default Settings for device family Unified Access Point** configures Default Assurance Health Score thresholds for Unified Access Points in Cisco Catalyst Center. It allows tuning KPI thresholds and inclusion in overall health scoring. @@ -303,7 +303,7 @@ assurance_health_score_settings: synchronize_to_issue_threshold: false ``` mapping config to UI Actions: -![alt text](./images/Unified_AP_Default.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_health_score_settings/images/Unified_AP_Default.png) 8. **Health Score Default Settings for device family wired client** configures Default Assurance Health Score thresholds for WIRED_CLIENT in Cisco Catalyst Center. It allows tuning KPI thresholds and inclusion in overall health scoring. @@ -319,7 +319,7 @@ assurance_health_score_settings: synchronize_to_issue_threshold: false ``` mapping config to UI Actions: -![alt text](./images/wired_client_default.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_health_score_settings/images/wired_client_default.png) 9. **Health Score Default Setting for device family wireless client** configures Default Assurance Health Score thresholds for WIRELESS_CLIENT in Cisco Catalyst Center. It allows tuning KPI thresholds and inclusion in overall health scoring. @@ -339,7 +339,7 @@ assurance_health_score_settings: synchronize_to_issue_threshold: true ``` mapping config to UI Actions: -![alt text](./images/wireless_client_default.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_health_score_settings/images/wireless_client_default.png) 10. **Health Score Default Settings for device family wireless controller** configures Default Assurance Health Score thresholds for WIRELESS_CONTROLLER in Cisco Catalyst Center. It allows tuning KPI thresholds and inclusion in overall health scoring. @@ -379,7 +379,7 @@ assurance_health_score_settings: include_for_overall_health: true ``` mapping config to UI Actions: -![alt text](./images/wireless_controller_default.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_health_score_settings/images/wireless_controller_default.png) 11. **Health Score Default Setting for device family Switches and hub** configures Default Assurance Health Score thresholds for SWITCH_AND_HUB in Cisco Catalyst Center. It allows tuning KPI thresholds and inclusion in overall health scoring. @@ -401,7 +401,7 @@ assurance_health_score_settings: synchronize_to_issue_threshold: false ``` mapping config to UI Actions: -![alt text](./images/switches_and_hub_default.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_health_score_settings/images/switches_and_hub_default.png) 12. **Health Score Default Setting for device family Router** configures Default Assurance Health Score thresholds for ROUTER in Cisco Catalyst Center. It allows tuning KPI thresholds and inclusion in overall health scoring. @@ -423,9 +423,9 @@ assurance_health_score_settings: include_for_overall_health: true ``` mapping config to UI Actions: -![alt text](./images/router_default1.png) -![alt text](./images/router_default2.png) -![alt text](./images/router_default3.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_health_score_settings/images/router_default1.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_health_score_settings/images/router_default2.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_health_score_settings/images/router_default3.png) 2. **Validate Configuration:** diff --git a/cvp/assurance_intelligent_capture/README.md b/cvp/assurance_intelligent_capture/README.md index c39b62ac0..0c87b0a49 100644 --- a/cvp/assurance_intelligent_capture/README.md +++ b/cvp/assurance_intelligent_capture/README.md @@ -44,7 +44,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -148,11 +148,11 @@ Below are example input files for each `capture_type` supported by the ICAP work ``` Figure 1 Choose WLC and Client MAC Address in Catalyst Center. -![Alt text](./images/icap_onboarding_capture_page3.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_intelligent_capture/images/icap_onboarding_capture_page3.png) Figure 2 Check ICAP setting created. -![Alt text](./images/icap_onboarding_capture_page5.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_intelligent_capture/images/icap_onboarding_capture_page5.png) --- @@ -168,10 +168,10 @@ Figure 2 Check ICAP setting created. ``` Figure 1 Choose WLC and Client MAC Address in Catalyst Center. -![Alt text](./images/icap_full_capture_page2.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_intelligent_capture/images/icap_full_capture_page2.png) Figure 2 Configuration has been created. -![Alt text](./images/icap_full_capture_page4.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_intelligent_capture/images/icap_full_capture_page4.png) --- @@ -191,33 +191,33 @@ Figure 2 Configuration has been created. ``` Figure 1 Go to page Health in Catalyst Center to create ICAP settings. -![Alt text](./images/icap_ota_capture_page1.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_intelligent_capture/images/icap_ota_capture_page1.png) Figure 2 Go to Client page and Choose Wireless Client in Catalyst Center. -![Alt text](./images/icap_ota_capture_page2.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_intelligent_capture/images/icap_ota_capture_page2.png) Figure 3 Go to Intelligent Capture of Wireless Client in Catalyst Center. -![Alt text](./images/icap_ota_capture_page3.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_intelligent_capture/images/icap_ota_capture_page3.png) Figure 4 Run Packet Capture on Device in Catalyst Center. -![Alt text](./images/icap_ota_capture_page4.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_intelligent_capture/images/icap_ota_capture_page4.png) Figure 5 Choose OTA Sniffer type and choose AP in Catalyst Center. -![Alt text](./images/icap_ota_capture_page5.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_intelligent_capture/images/icap_ota_capture_page5.png) Figure 6 Enter parameters want configure and "Next" in Catalyst Center. -![Alt text](./images/icap_ota_capture_page6.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_intelligent_capture/images/icap_ota_capture_page6.png) Figure 7 Enter parameters want configure and "Next" in Catalyst Center. -![Alt text](./images/icap_ota_capture_page7.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_intelligent_capture/images/icap_ota_capture_page7.png) Figure 8 Apply and Deploy in Catalyst Center. -![Alt text](./images/icap_ota_capture_page8.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_intelligent_capture/images/icap_ota_capture_page8.png) --- @@ -232,7 +232,7 @@ Figure 8 Apply and Deploy in Catalyst Center. ``` Figure 1 Choose AP device want to enable RFSTATS and then click "Enable" -![Alt text](./images/assurance_intelligent_rfs_capture3.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_intelligent_capture/images/assurance_intelligent_rfs_capture3.png) --- **e. ANOMALY Capture (state: merged)** @@ -244,7 +244,7 @@ Figure 1 Choose AP device want to enable RFSTATS and then click "Enable" wlc_name: 98:76:54:32:10:FE ``` Figure 1 Go to Anomaly Capture page and then Enable AP Anomaly Capture in Catalyst Center. -![Alt text](./images/assurance_intelligent_capture2.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_intelligent_capture/images/assurance_intelligent_capture2.png) --- diff --git a/cvp/assurance_issue_config_generator/README.md b/cvp/assurance_issue_config_generator/README.md index f998e9e4e..7825297c0 100644 --- a/cvp/assurance_issue_config_generator/README.md +++ b/cvp/assurance_issue_config_generator/README.md @@ -139,7 +139,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/assurance_issues_management/README.md b/cvp/assurance_issues_management/README.md index 0da7659e8..a7eb5e992 100644 --- a/cvp/assurance_issues_management/README.md +++ b/cvp/assurance_issues_management/README.md @@ -37,7 +37,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -188,7 +188,7 @@ assurance_issues_settings: #### Upon successful completion, the issue will be created and you will see an output similar to the following: -![alt text](./images/User_def_issue_created.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_issues_management/images/User_def_issue_created.png) ```yaml "msg": { @@ -257,7 +257,7 @@ assurance_issues_settings: #### Upon successful completion, the issue details will be updated and you will see an output similar to the following: -![alt text](./images/User_def_issue_updated.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_issues_management/images/User_def_issue_updated.png) ```yaml "msg": { @@ -317,7 +317,7 @@ assurance_issues_settings: #### Upon successful completion, issue will be removed from Cisco Catalyst Center and you will see an output similar to the following: -![alt text](./images/User_def_issue_deleted.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_issues_management/images/User_def_issue_deleted.png) ```yaml "msg": { @@ -358,10 +358,10 @@ assurance_issues_settings: #### Upon successful completion, the issue will be updated in Cisco Catalyst Center and you will see an output similar to the following: #### Before Updating -![alt text](./images/system_def_issu_before_update.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_issues_management/images/system_def_issu_before_update.png) #### After Updating -![alt text](./images/System_def_issu_after_update.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_issues_management/images/System_def_issu_after_update.png) ```yaml "msg": { @@ -414,10 +414,10 @@ In this example, we are resolving the assurance issue named **"Fabric BGP sessio **Note**: You can view resolved issues in Cisco Catalyst Center by navigating to **Assurance > Dashboards > Issue and Events**. In the **Issues** dropdown, select the **Resolved** option to see all the resolved issues. Assurance issue Landing page: -![alt text](./images/Resolve_issue_landing_page.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_issues_management/images/Resolve_issue_landing_page.png) Assurance issue Resolved page for specific issue: -![alt text](./images/Resolved_issue_listing.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_issues_management/images/Resolved_issue_listing.png) ```yaml "msg": "Issue resolved successfully. '[{'successfulIssueIds': ['b357feeb-67ad-4f1b-9106-16627dd4004b']}]'.", @@ -483,10 +483,10 @@ In this example, we are ignoring the assurance issue named **"PKI - Non authorit #### Upon successful completion, the issue will be ignored in Cisco Catalyst Center and you will see an output similar to the following: Assurance ignore issue Landing page: -![alt text](./images/Ignore_issue_landing_page.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_issues_management/images/Ignore_issue_landing_page.png) Assurance ignore issue page for specific issue: -![alt text](./images/Ignore_issue_listing.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_issues_management/images/Ignore_issue_listing.png) ```yaml "msg": "Find the list of issue ids: [\n \"2764b515-c5d5-46bb-bcbf-74d49d6b6656\",\n \"1b4b0c4f-cc2e-4de4-aaab-f35ce4474cb9\",\n \"dcaf06e3-64aa-4cc8-a534-11a40e9538cd\"\n]Issue ignored successfully. '[{'successfulIssueIds': ['1b4b0c4f-cc2e-4de4-aaab-f35ce4474cb9', '2764b515-c5d5-46bb-bcbf-74d49d6b6656', 'dcaf06e3-64aa-4cc8-a534-11a40e9538cd']}]'.", diff --git a/cvp/assurance_pathtrace/README.md b/cvp/assurance_pathtrace/README.md index 64e41d904..9a3eb37eb 100644 --- a/cvp/assurance_pathtrace/README.md +++ b/cvp/assurance_pathtrace/README.md @@ -58,7 +58,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -223,7 +223,7 @@ pathtrace_details: ``` mapping config to UI Actions for Create path Trace: Note: There is no UI flow for retrieve and delete path trace. -![alt text](./images/create_path_trace.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/assurance_pathtrace/images/create_path_trace.png) 2. **Validate Configuration:** diff --git a/cvp/backup_and_restore/README.md b/cvp/backup_and_restore/README.md index 63971d945..ab822c9f9 100644 --- a/cvp/backup_and_restore/README.md +++ b/cvp/backup_and_restore/README.md @@ -159,7 +159,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -196,8 +196,8 @@ backup_restore_details: nfs_version: nfs4 nfs_portmapper_port: 111 ``` -![alt text](./images/image.png) -![alt text](./images/image-1.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/backup_and_restore/images/image.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/backup_and_restore/images/image-1.png) #### Backup Storage Configuration @@ -216,7 +216,7 @@ backup_restore_details: encryption_passphrase: "SecurePass123!" ``` -![alt text](./images/image-2.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/backup_and_restore/images/image-2.png) #### Create Backup @@ -232,7 +232,7 @@ backup_restore_details: generate_new_backup: true ``` -![alt text](./images/image-3.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/backup_and_restore/images/image-3.png) Result: `DAILY_BACKUP_20241230_143052` @@ -309,7 +309,7 @@ Terminal Return ``` -![alt text](./images/image-4.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/backup_and_restore/images/image-4.png) 2.Configure Backup Storage Settings @@ -320,7 +320,7 @@ Terminal Return response: Backup Configuration(s) '/home/nfsshare/backups/TB23' updated successfully in Cisco Catalyst Center. ``` -![alt text](./images/image-5.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/backup_and_restore/images/image-5.png) 3.Create Backup @@ -332,7 +332,7 @@ Terminal Return status: success ``` -![alt text](./images/image-7.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/backup_and_restore/images/image-7.png) 4.Restore Operation: @@ -448,7 +448,7 @@ Terminal Return status: success ``` -![alt text](./images/image-6.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/backup_and_restore/images/image-6.png) --- diff --git a/cvp/backup_and_restore_config_generator/README.md b/cvp/backup_and_restore_config_generator/README.md index 9be479c9d..a8527fa66 100644 --- a/cvp/backup_and_restore_config_generator/README.md +++ b/cvp/backup_and_restore_config_generator/README.md @@ -146,7 +146,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/device_config_backup/README.md b/cvp/device_config_backup/README.md index 868d66d4b..1d4fd78ad 100644 --- a/cvp/device_config_backup/README.md +++ b/cvp/device_config_backup/README.md @@ -106,9 +106,9 @@ ansible-playbook -i host_inventory_dnac1/hosts.yml cvp/device_config_backup/play #### **Mapping config to UI Actions** - The config parameter within this task corresponds to the Provision > Inventory > Actions > Export Inventory" action in the Cisco Catalyst Center UI. -![alt text](./images/hostname.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_config_backup/images/hostname.png) - Enter password and click Export -![alt text](./images/password.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_config_backup/images/password.png) #### **Example Input** @@ -142,11 +142,11 @@ device_configs_backup_details: - The config parameter within this task corresponds to the Provision > Inventory > Actions > Export Inventory" action in the Cisco Catalyst Center UI. -![alt text](./images/ipaddress1.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_config_backup/images/ipaddress1.png) - Enter password and click Export -![alt text](./images/ipaddress2.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_config_backup/images/ipaddress2.png) #### **Example Input ** ``` @@ -163,11 +163,11 @@ device_configs_backup_details: - The config parameter within this task corresponds to the Provision > Inventory > Actions > Export Inventory" action in the Cisco Catalyst Center UI. -![alt text](./images/managed.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_config_backup/images/managed.png) - Enter password and click Export -![alt text](./images/password.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_config_backup/images/password.png) #### **Example Input ** ``` @@ -184,11 +184,11 @@ device_configs_backup_details: - The config parameter within this task corresponds to the Provision > Inventory > Actions > Export Inventory" action in the Cisco Catalyst Center UI. -![alt text](./images/family.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_config_backup/images/family.png) - Enter password and click Export -![alt text](./images/password.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_config_backup/images/password.png) #### **Example Input ** ``` @@ -205,11 +205,11 @@ device_configs_backup_details: - The config parameter within this task corresponds to the Provision > Inventory > Actions > Export Inventory" action in the Cisco Catalyst Center UI. -![alt text](./images/macaddress.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_config_backup/images/macaddress.png) - Enter password and click Export -![alt text](./images/password.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_config_backup/images/password.png) #### **Example Input ** ``` @@ -225,11 +225,11 @@ device_configs_backup_details: - The config parameter within this task corresponds to the Provision > Inventory > Actions > Export Inventory" action in the Cisco Catalyst Center UI. -![alt text](./images/serial.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_config_backup/images/serial.png) - Enter password and click Export -![alt text](./images/password.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_config_backup/images/password.png) #### **Example Input ** ``` @@ -245,11 +245,11 @@ device_configs_backup_details: - The config parameter within this task corresponds to the Provision > Inventory > Actions > Export Inventory" action in the Cisco Catalyst Center UI. -![alt text](./images/series.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_config_backup/images/series.png) - Enter password and click Export -![alt text](./images/password.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_config_backup/images/password.png) #### **Example Input ** ``` @@ -265,11 +265,11 @@ device_configs_backup_details: - The config parameter within this task corresponds to the Provision > Inventory > Actions > Export Inventory" action in the Cisco Catalyst Center UI. -![alt text](./images/site.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_config_backup/images/site.png) - Enter password and click Export -![alt text](./images/password.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_config_backup/images/password.png) #### **Example Input ** ``` @@ -286,11 +286,11 @@ device_configs_backup_details: #### **Example Input ** - The config parameter within this task corresponds to the Provision > Inventory > Actions > Export Inventory" action in the Cisco Catalyst Center UI. -![alt text](./images/name_ip_manage.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_config_backup/images/name_ip_manage.png) - Enter password and click Export -![alt text](./images/password.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_config_backup/images/password.png) ``` device_configs_backup_details: - ip_address_list: [204.1192.3.40] @@ -338,7 +338,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/device_credential_config_generator/README.md b/cvp/device_credential_config_generator/README.md index 418a5c6c1..25b56bbb2 100644 --- a/cvp/device_credential_config_generator/README.md +++ b/cvp/device_credential_config_generator/README.md @@ -135,7 +135,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/device_credentials/README.md b/cvp/device_credentials/README.md index 03406ff90..63146ef1e 100644 --- a/cvp/device_credentials/README.md +++ b/cvp/device_credentials/README.md @@ -6,7 +6,7 @@ You can configure and manage credentials for network devices such as switches, r These workflows help you reduce risk and enhance security while managing your network. Below are the key elements and processes in Device Credential Workflow Manager. Device Credentials Figure: It consists of two parts: Network Hierarchy and Manage Credentials. -![Alt text](./images/credential.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_credentials/images/credential.png) Network Hierarchy: Specifies where the credential will be applied. Manage Credentials: @@ -109,12 +109,12 @@ catalyst_center_hosts: **Mapping to UI action**: - Design -> Network Settings -> Device Credentials -> Manage Credentials - ![Alt text](./images/manage_creden.png) + ![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_credentials/images/manage_creden.png) - Enter data to create new credential - ![Alt text](./images/create_cli.png) + ![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_credentials/images/create_cli.png) **Purpose**: - Create new device credentials. @@ -188,12 +188,12 @@ device_credentials: **Mapping to UI action**: - Design -> Network Settings -> Device Credentials -> Manage Credentials - ![Alt text](./images/manage_creden.png) + ![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_credentials/images/manage_creden.png) - Enter data to update existing credentials - ![Alt text](./images/create_cli.png) + ![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_credentials/images/create_cli.png) **Purpose**: - Modify existing credentials (e.g., change passwords). @@ -240,12 +240,12 @@ device_credentials: **Mapping to UI action**: - Design -> Network Settings -> Device Credentials -> Manage Credentials -> Focus -> System - ![Alt text](./images/system_creden.png) + ![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_credentials/images/system_creden.png) - Select The Credential To Delete -> Go To The Three Dots -> Select Delete - ![Alt text](./images/delete_creden.png) + ![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_credentials/images/delete_creden.png) **Purpose**: - Remove credentials from Catalyst Center. @@ -296,7 +296,7 @@ device_credentials: **Mapping to UI action**: - Design -> Network Settings -> Device Credentials -> Select Site -> Select Credential Type -> Save - ![Alt text](./images/assign_creden.png) + ![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_credentials/images/assign_creden.png) **Purpose**: - Assign credentials to sites. @@ -327,12 +327,12 @@ device_credentials: **Mapping to UI action**: - Design -> Network Settings -> Device Credentials -> Manage Credentials -> Focus -> Current site - ![Alt text](./images/manage_current.png) + ![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_credentials/images/manage_current.png) - Select The Credential To Apply -> Go To The Three Dots -> Select Apply - ![Alt text](./images/apply_creden.png) + ![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_credentials/images/apply_creden.png) **Purpose**: - Make updates to credentials, i.e., reset passwords, etc., and apply to applicable sites and all the devices on that site. @@ -922,7 +922,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/device_discovery/README.md b/cvp/device_discovery/README.md index 20da9bbec..67d70a0ea 100644 --- a/cvp/device_discovery/README.md +++ b/cvp/device_discovery/README.md @@ -69,7 +69,7 @@ You can save commonly used credentials in Catalyst Center for easier access acro ## Discovery single device -![Alt text](./images/discovery_2.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_discovery/images/discovery_2.png) #### Example input config: @@ -92,7 +92,7 @@ discovery_details: ## Discovery IP Address Range -![Alt text](./images/discovery_3.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_discovery/images/discovery_3.png) #### Example input config: @@ -108,7 +108,7 @@ discovery_details: ## Discovery Multiple IP Address Ranges -![Alt text](./images/discovery_4.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_discovery/images/discovery_4.png) #### Example input config: @@ -125,7 +125,7 @@ discovery_details: ## Discovery Devices from a CDP Seed -![Alt text](./images/discovery_5.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_discovery/images/discovery_5.png) #### Example input config: ```yaml @@ -142,7 +142,7 @@ discovery_details: ``` ## Discovery Devices from LLDP -![Alt text](./images/discovery_6.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_discovery/images/discovery_6.png) #### Example input config: ```yaml @@ -158,7 +158,7 @@ discovery_details: ``` ## Discovery Devices from CIDR -![Alt text](./images/discovery_7.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_discovery/images/discovery_7.png) #### Example input config: ```yaml @@ -231,7 +231,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/device_replacement_rma/README.md b/cvp/device_replacement_rma/README.md index 9ab1570c3..771a93928 100644 --- a/cvp/device_replacement_rma/README.md +++ b/cvp/device_replacement_rma/README.md @@ -57,7 +57,7 @@ catalyst_center_hosts: From the Actions drop-down list, choose Inventory > Device Replacement > Mark Device for Replacement. In the Mark for Replacement window, click Mark. Figure1: Mark Faulty Device for replacement UI - ![Alt text](./images/mark_device_replacement.png) + ![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_replacement_rma/images/mark_device_replacement.png) 2. To replace the device, do the following: Select the device that you want to replace and choose Actions > Replace Device. @@ -71,7 +71,7 @@ catalyst_center_hosts: In the Sync with Smart Account window, click Sync. The Automation does not support scheduling through Catalyst Center. User should schedule their script run from automation. - ![Alt text](./images/replacement.png) + ![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_replacement_rma/images/replacement.png) ## Inputs: ```yaml @@ -122,7 +122,7 @@ ansible-playbook -i host_inventory_dnac1 cvp/device_replacement_rma/playbook/del A list of devices that are marked for replacement is displayed. If you don't want to replace the device, select the device and choose Actions > Unmark for Replacement. Figure3: Mark Faulty Device for replacement UI - ![Alt text](./images/unmark_faulty_device.png) + ![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_replacement_rma/images/unmark_faulty_device.png) # Limitations of the RMA Workflow in Catalyst Center @@ -193,7 +193,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/device_templates/README.md b/cvp/device_templates/README.md index 76758d71a..43a2eb7bf 100644 --- a/cvp/device_templates/README.md +++ b/cvp/device_templates/README.md @@ -160,15 +160,15 @@ Validation success! 👍 - The config parameter within this task corresponds to the "Design > CLI Templates > Create Template" action in the Cisco Catalyst Center UI. -![alt text](./images/create0.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_templates/images/create0.png) - Enter the parameters of the template you want to create. -![alt text](./images/template1.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_templates/images/template1.png) - Enter content template -> Commit. -![alt text](./images/create2.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_templates/images/create2.png) - Enter commit note -> Commit. -![alt text](./images/create3.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_templates/images/create3.png) - Check template created. -![alt text](./images/create4.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_templates/images/create4.png) #### **Example Input File** @@ -206,11 +206,11 @@ template_details: #### **Mapping config to UI Actions** - Choose Template want to delete -> Delete. -![alt text](./images/delete1.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_templates/images/delete1.png) - Click "Yes" to confirm deleting the template. -![alt text](./images/delete2.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_templates/images/delete2.png) - Check Template deleted. -![alt text](./images/delete3.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_templates/images/delete3.png) #### **Example Input File** ```bash @@ -247,21 +247,21 @@ template_details: #### **Mapping config to UI Actions** - Attach Template to Network Profile: Choose Template -> Attach. -![alt text](./images/deploy1.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_templates/images/deploy1.png) - Choose the Network Profile to attach -> Save. -![alt text](./images/deploy2.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_templates/images/deploy2.png) - Verify that the template was successfully attached. -![alt text](./images/deploy3.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_templates/images/deploy3.png) - Choose Template deploy -> Provision Templates. -![alt text](./images/deploy4.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_templates/images/deploy4.png) - Click Next. -![alt text](./images/deploy5.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_templates/images/deploy5.png) - Choose device need deploy template. -![alt text](./images/deploy6.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_templates/images/deploy6.png) - Click Next. -![alt text](./images/deploy7.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_templates/images/deploy7.png) - Click Apply to deploy the template. -![alt text](./images/deploy8.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/device_templates/images/deploy8.png) #### **Example Input File** @@ -324,7 +324,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/discovery_config_generator/README.md b/cvp/discovery_config_generator/README.md index 311f38cea..8f7b93800 100644 --- a/cvp/discovery_config_generator/README.md +++ b/cvp/discovery_config_generator/README.md @@ -135,7 +135,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/events_and_notifications/README.md b/cvp/events_and_notifications/README.md index fb0333558..9c5c50068 100644 --- a/cvp/events_and_notifications/README.md +++ b/cvp/events_and_notifications/README.md @@ -95,7 +95,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -146,13 +146,13 @@ To ensure that syslog destination has been created or updated in Catalyst Center #### Refrence Screenshot: Syslog Creation Success -![alt text](images/Syslog_creation_successful.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/Syslog_creation_successful.png) #### Refrence Screenshot: Syslog Details Updated Note: Screenshot below indicates that the event description and hostname/IP for 'Syslog test 100' have been updated. -![alt text](images/Syslog_details_updated_successfully.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/Syslog_details_updated_successfully.png) ### Step 2: Verify the playbook output @@ -176,12 +176,12 @@ To ensure that syslog destination has been created or updated in Catalyst Center Refrence Screenshot: Syslog Creation Success -![alt text](images/Syslog_creation_successful.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/Syslog_creation_successful.png) Refrence Screenshot: Syslog Details Updated Note: Screenshot below indicates that the event description and hostname/IP for 'Syslog test 100' have been updated. -![alt text](images/Syslog_details_updated_successfully.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/Syslog_details_updated_successfully.png) ## 3. Create/Update Webhook destination in Catalyst Center @@ -234,13 +234,13 @@ To ensure that webhook destination has been created or updated in Catalyst Cente #### Refrence Screenshot: Webhook Creation Success -![alt text](images/Webhook_destination_created_successfully.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/Webhook_destination_created_successfully.png) #### Refrence Screenshot: Webhook Details Updated Note: Screenshot below indicates that the webhook description for 'webhook demo 110' and 'webhook demo 111' have been updated. -![alt text](images/Webhook_destination_updated_successfully.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/Webhook_destination_updated_successfully.png) ### Step 2: Verify the playbook output @@ -264,12 +264,12 @@ To ensure that webhook destination has been created or updated in Catalyst Cente Refrence Screenshot: Webhook Creation Success -![alt text](images/Webhook_destination_created_successfully.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/Webhook_destination_created_successfully.png) Refrence Screenshot: Webhook Details Updated Note: Screenshot below indicates that the webhook description for 'webhook demo 110' and 'webhook demo 111' have been updated. -![alt text](images/Webhook_destination_updated_successfully.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/Webhook_destination_updated_successfully.png) ## 4. Create/Update SNMP destination in Catalyst Center @@ -321,7 +321,7 @@ To ensure that SNMP destination has been created or updated in Catalyst Center, Note: Screenshot below indicates that the SNMP destination 'SNMP Testing' and 'Snmp test new' have been created. -![alt text](images/SNMP_event_created_successfully.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/SNMP_event_created_successfully.png) ### Step 2: Verify the playbook output @@ -346,7 +346,7 @@ To ensure that SNMP destination has been created or updated in Catalyst Center, Refrence Screenshot: SNMP Creation Success Note: Screenshot below indicates that the SNMP destination 'SNMP Testing' and 'Snmp test new' have been created. -![alt text](images/SNMP_event_created_successfully.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/SNMP_event_created_successfully.png) ## 5. Create/Update ITSM destination in Catalyst Center @@ -393,13 +393,13 @@ To ensure that ITSM destination has been created or updated in Catalyst Center, Note: Screenshot below indicates that the ITSM destination 'Playbook itsm demo 01' and 'ITSM_Demo_test 02' have been created. -![alt text](images/ITSM_Created_Successfully.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/ITSM_Created_Successfully.png) #### Refrence Screenshot: ITSM Details Updated Note: Screenshot below indicates that the ITSM destination description for 'Playbook itsm demo 01' and 'ITSM_Demo_test 02' have been updated. -![alt text](images/ITSM_Updated_Successfully.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/ITSM_Updated_Successfully.png) ### Step 2: Verify the playbook output @@ -424,12 +424,12 @@ To ensure that ITSM destination has been created or updated in Catalyst Center, Refrence Screenshot: ITSM Creation Success Note: Screenshot below indicates that the ITSM destination 'Playbook itsm demo 01' and 'ITSM_Demo_test 02' have been created. -![alt text](images/ITSM_Created_Successfully.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/ITSM_Created_Successfully.png) Refrence Screenshot: ITSM Details Updated Note: Screenshot below indicates that the ITSM destination description for 'Playbook itsm demo 01' and 'ITSM_Demo_test 02' have been updated. -![alt text](images/ITSM_Updated_Successfully.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/ITSM_Updated_Successfully.png) ## 6. Create/Update Email Event Subscription in Catalyst Center @@ -476,7 +476,7 @@ To ensure that Event subscription notification has been created or updated in Ca #### Reference Screenshot: -![alt text](images/Email_event_subscription_created.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/Email_event_subscription_created.png) ### Step 2: Verify the playbook output @@ -500,7 +500,7 @@ To ensure that Event subscription notification has been created or updated in Ca Reference Screenshot: -![alt text](images/Email_event_subscription_created.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/Email_event_subscription_created.png) ## 7. Create/Update Syslog Event Subscription in Catalyst Center @@ -543,7 +543,7 @@ To ensure that Syslog subscription notification has been created or updated in C #### Reference Screenshot: -![alt text](images/Syslog_even_subscription_created.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/Syslog_even_subscription_created.png) ### Step 2: Verify the playbook output @@ -567,7 +567,7 @@ To ensure that Syslog subscription notification has been created or updated in C Reference Screenshot: -![alt text](images/Syslog_even_subscription_created.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/Syslog_even_subscription_created.png) ## 8. Create/Update Webhook Event Subscription in Catalyst Center @@ -607,7 +607,7 @@ To ensure that Webhook subscription notification has been created or updated in #### Reference Screenshot: -![alt text](images/Webhook_event_subscription_created.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/Webhook_event_subscription_created.png) ### Step 2: Verify the playbook output @@ -631,7 +631,7 @@ To ensure that Webhook subscription notification has been created or updated in Reference Screenshot: -![alt text](images/Webhook_event_subscription_created.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/Webhook_event_subscription_created.png) ## 9. Delete Email Event Subscription in Catalyst Center @@ -682,11 +682,11 @@ To ensure that Email subscription notification has been deleted in Catalyst Cent Note: Note: Ensure that specific Email Subscription Event Notification presents in Catalyst Centert: -![alt text](images/Before_delete_email_event.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/Before_delete_email_event.png) Note: After executing the delete_events_and_notifications playbook, verify the deletion of the Email Event Subscription: -![alt text](images/After_delete_email_event.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/After_delete_email_event.png) ### Step 2: Verify the playbook output @@ -711,10 +711,10 @@ To ensure that Email subscription notification has been deleted in Catalyst Cent Reference Screenshot: Note: Note: Ensure that specific Email Subscription Event Notification presents in Catalyst Centert: -![alt text](images/Before_delete_email_event.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/Before_delete_email_event.png) Note: After executing the delete_events_and_notifications playbook, verify the deletion of the Email Event Subscription: -![alt text](images/After_delete_email_event.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/After_delete_email_event.png) ## 10. Delete Syslog Event Subscription in Catalyst Center @@ -761,11 +761,11 @@ To ensure that Syslog subscription notification has been deleted in Catalyst Cen Note: Note: Ensure that specific Syslog Subscription Event Notification presents in Catalyst Center -![alt text](images/Before_deleting_syslog_event.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/Before_deleting_syslog_event.png) Note: After executing the delete_events_and_notifications playbook, verify the deletion of the Email Event Subscription: -![alt text](images/After_deleting_syslog_event.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/After_deleting_syslog_event.png) ### Step 2: Verify the playbook output @@ -791,10 +791,10 @@ To ensure that Syslog subscription notification has been deleted in Catalyst Cen Reference Screenshot: Note: Note: Ensure that specific Syslog Subscription Event Notification presents in Catalyst Center -![alt text](images/Before_deleting_syslog_event.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/Before_deleting_syslog_event.png) Note: After executing the delete_events_and_notifications playbook, verify the deletion of the Email Event Subscription: -![alt text](images/After_deleting_syslog_event.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/After_deleting_syslog_event.png) ## 11. Delete Webhook Event Subscription in Catalyst Center @@ -838,11 +838,11 @@ To ensure that Webhook subscription notification has been deleted in Catalyst Ce Note: Ensure that specific Webhook Subscription Event Notification presents in Catalyst Center -![alt text](images/Before_deleting_webhook_event.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/Before_deleting_webhook_event.png) Note: After executing the delete_events_and_notifications playbook, verify the deletion of the Webhook Event Subscription: -![alt text](images/After_deleting_webhook_event.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/After_deleting_webhook_event.png) ### Step 2: Verify the playbook output @@ -905,11 +905,11 @@ To ensure that ITSM event destination has been deleted in Catalyst Center, follo Note: Ensure that specific ITSM Event Destination presents in Catalyst Center -![alt text](images/ITSM_Destination_Presents.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/ITSM_Destination_Presents.png) Note: After executing the delete_events_and_notifications playbook, verify the deletion of the ITSM Event Destination: -![alt text](images/ITSM_Destination_Deleted.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/events_and_notifications/images/ITSM_Destination_Deleted.png) ### Step 2: Verify the playbook output diff --git a/cvp/events_and_notifications_config_generator/README.md b/cvp/events_and_notifications_config_generator/README.md index 686d40793..970741508 100644 --- a/cvp/events_and_notifications_config_generator/README.md +++ b/cvp/events_and_notifications_config_generator/README.md @@ -137,7 +137,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/fabric_devices_info/README.md b/cvp/fabric_devices_info/README.md index 52bb69959..d2403689a 100644 --- a/cvp/fabric_devices_info/README.md +++ b/cvp/fabric_devices_info/README.md @@ -119,7 +119,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -137,7 +137,7 @@ ansible-playbook -i ./inventory/demo_lab/hosts.yaml ./cvp/fabric_devices_info/pl ## Usage Examples The UI display (example): - ![alt text](./images/example_fabric_device_info.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/fabric_devices_info/images/example_fabric_device_info.png) ### Example 1: Retrieve All Information in Fabric Site diff --git a/cvp/inventory/README.md b/cvp/inventory/README.md index 7379745b7..4cfaafe3f 100644 --- a/cvp/inventory/README.md +++ b/cvp/inventory/README.md @@ -44,7 +44,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -188,7 +188,7 @@ inventory_details: "device(s) 'XX.XX.XX.XX', 'XX.XX.XX.XX', 'XX.XX.XX.XX' added successfully in Cisco Catalyst Center." * verify the devices are successfully added to the inventory and present in the Cisco Catalyst Center. -![alt text](images/add_devices.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/inventory/images/add_devices.png) * Sample run line command to run the add devices Playbook: ```bash @@ -218,7 +218,7 @@ inventory_details: "device(s) 'XX.XX.XX.XX', 'XX.XX.XX.XX' provisioned successfully in Cisco Catalyst Center." * verify the devices provision status in the Cisco Catalyst Center and it will show provision status as success. Before provision it will show Not Provisioned. -![alt text](images/provision_device.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/inventory/images/provision_device.png) * Sample run line command for running the Provision Playbook: ```bash @@ -276,7 +276,7 @@ inventory_details: "msg": "Device(s) '['XX.XX.XX.XX', 'XX.XX.XX.XX']' role updated successfully to '['ACCESS', 'ACCESS']'" * Verify the device role in the cisco catalyst center. -![alt text](images/Device_role.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/inventory/images/Device_role.png) E. To execute the Ansible playbook for deleting devices: @@ -302,7 +302,7 @@ F. To execute the Ansible playbook for schedule the maintenance: * scheduled maintenance for device xx.xx.xx.xx at 2025-04-05 10:30:00 and ended at 2025-04-05 11:30:00 in Asia/Kolkata time zone -![alt text](images/schedule_maintenance.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/inventory/images/schedule_maintenance.png) ```bash catalystcenter_version: 2.3.7.6 @@ -318,7 +318,7 @@ catalystcenter_version: 2.3.7.6 * scheduled maintenance for device xx.xx.xx.xx at 2025-04-05 10:30:00, ending at 2025-04-05 11:30:00 Asia/Kolkata time zone and recurring time to re-execute is 2 days ending after scheduled maintenance at 2025-04-10 11:40:00 -![alt text](images/recurring.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/inventory/images/recurring.png) ```bash catalystcenter_version: 2.3.7.6 @@ -336,7 +336,7 @@ catalystcenter_version: 2.3.7.6 * scheduled maintenance for multiple devices at 10:30:00 on 04/05/2025 and ending at 11:30:00 on 04/05/2025 in Asia/Kolkata time zone -![alt text](images/bulk_schedule.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/inventory/images/bulk_schedule.png) ```bash catalystcenter_version: 2.3.7.6 diff --git a/cvp/inventory_config_generator/README.md b/cvp/inventory_config_generator/README.md index 733ab3dd3..c888b7917 100644 --- a/cvp/inventory_config_generator/README.md +++ b/cvp/inventory_config_generator/README.md @@ -118,7 +118,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/ise_radius_integration/README.md b/cvp/ise_radius_integration/README.md index 3b1d10a56..f4e6ebdef 100644 --- a/cvp/ise_radius_integration/README.md +++ b/cvp/ise_radius_integration/README.md @@ -67,7 +67,7 @@ ansible-playbook -i host_inventory_dnac1/hosts.yml cvp/ise_radius_integration/pl timeout: 4 ``` Mapping Config to UI Actions: - ![alt text](./images/aaa_full_config.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/ise_radius_integration/images/aaa_full_config.png) * It also can be add with minimal config, for example (default: authentication_port: 1812, accounting_port: 1813, retries: 3, timeout: 4): ```yaml @@ -89,7 +89,7 @@ ansible-playbook -i host_inventory_dnac1/hosts.yml cvp/ise_radius_integration/pl timeout: 4 ``` mapping config to UI Actions: - ![alt text](./images/edit_aaa.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/ise_radius_integration/images/edit_aaa.png) 2. ### Add/update ISE server Add ISE server with full config, for example input config: @@ -120,7 +120,7 @@ ansible-playbook -i host_inventory_dnac1/hosts.yml cvp/ise_radius_integration/pl ise_integration_wait_time: 60 ``` mapping config to UI Actions: - ![alt text](./images/add_ise.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/ise_radius_integration/images/add_ise.png) * It also can be add with minimal config, for example (default: authentication_port: 1812, accounting_port: 1813, retries: 3, timeout: 4, pxgrid_enabled: True, use_dnac_cert_for_pxgrid: False): ```yaml @@ -157,10 +157,10 @@ ansible-playbook -i host_inventory_dnac1/hosts.yml cvp/ise_radius_integration/pl ``` mapping config to UI Actions: - ![alt text](./images/edit_ise.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/ise_radius_integration/images/edit_ise.png) * If the provided credentials are invalid, ISE will return a Fail status. - ![alt text](./images/ise_fail.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/ise_radius_integration/images/ise_fail.png) 3. ### Add combined bulk ISE and AAA. Add combine the ISE and AAA server with a single input, for example input config. @@ -208,7 +208,7 @@ ansible-playbook -i host_inventory_dnac1/hosts.yml cvp/ise_radius_integration/pl ise_integration_wait_time: 60 ``` mapping config to UI Actions: - ![alt text](./images/add_combine_bulk_ise_aaa.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/ise_radius_integration/images/add_combine_bulk_ise_aaa.png) + Explain values: ```yaml @@ -236,7 +236,7 @@ ansible-playbook -i host_inventory_dnac1/hosts.yml cvp/ise_radius_integration/pl - server_ip_address: 172.23.241.229 # ISE ``` mapping config to UI Actions: - ![alt text](./images/delete_bulk_ise_aaa.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/ise_radius_integration/images/delete_bulk_ise_aaa.png) * If the ISE/AAA server has already been assigned to a previous task (such as being associated with Network Settings, etc.), it will return a failure accompanied by a detailed error message in playbook; if the Authentication and Policy Server does not exist, return "x.x.x.x: Authentication and Policy Server not found" @@ -346,7 +346,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/ise_radius_integration_config_generator/README.md b/cvp/ise_radius_integration_config_generator/README.md index 998c578b3..daa9c60df 100644 --- a/cvp/ise_radius_integration_config_generator/README.md +++ b/cvp/ise_radius_integration_config_generator/README.md @@ -142,7 +142,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/lan_automation/README.md b/cvp/lan_automation/README.md index e4ff7aaba..c023a9010 100644 --- a/cvp/lan_automation/README.md +++ b/cvp/lan_automation/README.md @@ -26,7 +26,7 @@ This module provides a comprehensive toolkit for automating LAN network operatio To initiate LAN automation, the following prerequisites in Catalyst Center must be met: -![LAN Automation Prerequisites](./images/LAN-Auto-Prereqs.png) +![LAN Automation Prerequisites](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/lan_automation/images/LAN-Auto-Prereqs.png) **Required Prerequisites:** 1. **Site Hierarchy**: Define site structure in Catalyst Center (Global/Area/Building/Floor) @@ -35,11 +35,6 @@ To initiate LAN automation, the following prerequisites in Catalyst Center must 4. **Device Discovery**: Ensure primary/seed device is already discovered in Catalyst Center 5. **Network Credentials**: Configure valid credentials for device access ---- - -## Demo Video - -[![LAN Automation Execution Demo](./images/Lan_Automation_demo.png)](http://3.136.0.140/iac_demos/lan_auto/LAN_Automation_Workflow_Manager_Demo.mp4) --- @@ -69,7 +64,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -213,7 +208,7 @@ Configuration parameters for creating, updating, and deleting Port Channels betw This example topology illustrates a setup with a primary (or seed) device and a peer device, both initially discovered in Catalyst Center. A LAN Automation session will be initiated to discover and onboard all specified devices within the topology, including transit, IM1, IM2, and four access devices. Devices are LAN automated up to the specified level below the primary seed device which in this case is 4. The default value for discovery depth is 2 and the maximum value is 5. -![LAN Automation Topology](./images/LAN-Auto-Topology.png) +![LAN Automation Topology](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/lan_automation/images/LAN-Auto-Topology.png) **Topology Components:** - **Primary Seed Device**: Starting point for LAN automation (91.1.1.6) @@ -324,7 +319,7 @@ ansible-playbook -i host_inventory_dnac1/hosts.yml cvp/lan_automation/playbook/l To verify the LAN Automation session was executed successfully, check Catalyst Center under **Provision > LAN Automation** tab. -![LAN Automation Verification](./images/LAN-Auto-Verify.png) +![LAN Automation Verification](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/lan_automation/images/LAN-Auto-Verify.png) **Verification Checklist:** - ✅ Session status shows "Completed" or "In Progress" @@ -595,9 +590,9 @@ You can create Port Channels between two LAN Automated devices using different d To create a Port Channel, provide device identifiers for both source and destination devices along with the list of physical interface links to aggregate. ##### Example 1: Create Port Channel using Management IP Addresses -![Alt text](./images/Create_port_channel01.png) -![Alt text](./images/Create_port_channel02.png) -![Alt text](./images/Create_port_channel03.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/lan_automation/images/Create_port_channel01.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/lan_automation/images/Create_port_channel02.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/lan_automation/images/Create_port_channel03.png) ```yaml --- @@ -712,9 +707,9 @@ You can add new links to or remove links from existing Port Channels. There are ##### Example 1: Update Port Channel by Providing Existing Link To add new links to an existing Port Channel, provide at least one existing link to identify the Port Channel, then specify the new links to add. -![Alt text](./images/Update_port_channel01.png) -![Alt text](./images/Update_port_channel02.png) -![Alt text](./images/Update_port_channel03.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/lan_automation/images/Update_port_channel01.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/lan_automation/images/Update_port_channel02.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/lan_automation/images/Update_port_channel03.png) ```yaml --- @@ -801,7 +796,7 @@ lan_automation_details: ##### Example 2: Delete Specific Port Channel by Number Target a specific Port Channel for deletion using its Port Channel number. -![Alt text](./images/Delete_link02.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/lan_automation/images/Delete_link02.png) ```yaml --- @@ -818,7 +813,7 @@ lan_automation_details: ##### Example 3: Delete Specific Link from Port Channel Remove a single link from a Port Channel. If this operation would result in fewer than 2 links remaining, the entire Port Channel will be automatically deleted. -![Alt text](./images/Delete_link01.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/lan_automation/images/Delete_link01.png) ```yaml --- diff --git a/cvp/network_compliance/README.md b/cvp/network_compliance/README.md index 88864e889..3b126accf 100644 --- a/cvp/network_compliance/README.md +++ b/cvp/network_compliance/README.md @@ -6,7 +6,7 @@ This Ansible playbook streamlines the management of device compliance within you * Perform full compliance checks or specific category checks on reachable device(s). * Sync device configuration on device(s), running_configuration with Startup_config, if they are out of sync. -![Alt text](./images/complian.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_compliance/images/complian.png) # Procedure 1. ## Prepare your Ansible environment: @@ -778,7 +778,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/network_devices_info/README.md b/cvp/network_devices_info/README.md index 5e4eba7d7..15496e6bf 100644 --- a/cvp/network_devices_info/README.md +++ b/cvp/network_devices_info/README.md @@ -154,7 +154,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -332,7 +332,7 @@ output_file_info: ## Usage Examples The UI display (example): -![alt text](./images/image.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_devices_info/images/image.png) ### Example 1: Query All Information for Specific Devices diff --git a/cvp/network_profile_switching/README.md b/cvp/network_profile_switching/README.md index ef1ba3a02..3882d233a 100644 --- a/cvp/network_profile_switching/README.md +++ b/cvp/network_profile_switching/README.md @@ -36,7 +36,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -115,7 +115,7 @@ This step involves preparing the input data for creating or managing network pro day_n_templates: - Ansible SW Net-Prof dayN ``` - ![alt text](images/Switch_Network_Profile.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_profile_switching/images/Switch_Network_Profile.png) 2. Update Switch Network Profile in Catalyst Center @@ -143,7 +143,7 @@ This step involves preparing the input data for creating or managing network pro network_profiles: - profile_name: "Switch Profile" ``` - ![alt text](images/delete_switch_profile.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_profile_switching/images/delete_switch_profile.png) --- ### Step 3: Deploy and Verify @@ -174,7 +174,7 @@ This is the final step where you deploy the configuration to Cisco Catalyst Cent 2. **Verify Deployment:** After executing the playbook, check the Catalyst Center UI to verify switch profile has been created. If *debug_log* is enabled, you can also review the logs for detailed information on operations performed and any updates made. - ![alt text](images/creation_assignment.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_profile_switching/images/creation_assignment.png) --- diff --git a/cvp/network_profile_switching_config_generator/README.md b/cvp/network_profile_switching_config_generator/README.md index 2f535c2bc..f35644cff 100644 --- a/cvp/network_profile_switching_config_generator/README.md +++ b/cvp/network_profile_switching_config_generator/README.md @@ -156,7 +156,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/network_profile_wireless/README.md b/cvp/network_profile_wireless/README.md index ca2fd2a49..b67827baa 100644 --- a/cvp/network_profile_wireless/README.md +++ b/cvp/network_profile_wireless/README.md @@ -60,7 +60,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -311,8 +311,8 @@ wireless_nw_profiles_details: status: success ``` + The UI display: -![alt text](./images/feature_template_with_AAA_configuration.png) -![alt text](./images/feature_template_with_AAA_configuration_2.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_profile_wireless/images/feature_template_with_AAA_configuration.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_profile_wireless/images/feature_template_with_AAA_configuration_2.png) b. *Example*: Configure wireless profile with multiple feature template designs (update) @@ -345,7 +345,7 @@ wireless_nw_profiles_details: status: success ``` + The UI display: -![alt text](./images/update_multiple_feature_template.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_profile_wireless/images/update_multiple_feature_template.png) c. *Example*: Update wireless profile to remove feature template designs (delete) @@ -369,7 +369,7 @@ wireless_nw_profiles_details: status: success ``` + The UI display: -![alt text](./images/delete_feature_template.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_profile_wireless/images/delete_feature_template.png) --- @@ -410,7 +410,7 @@ Run the following command to validate your input file against the schema: 2. **Verify Deployment**: After execution, verify the configuration in the *Cisco Catalyst Center* UI under the wireless design section. If `catalystcenter_debug` is enabled, review the logs for detailed operation information. - ![Wireless profile configuration in Cisco Catalyst Center UI](./images/wireless_profile_1.png) + ![Wireless profile configuration in Cisco Catalyst Center UI](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_profile_wireless/images/wireless_profile_1.png) **Figure 1**: *Wireless Profile Configuration in Cisco Catalyst Center* --- diff --git a/cvp/network_profile_wireless_config_generator/README.md b/cvp/network_profile_wireless_config_generator/README.md index 240677361..bd91794df 100644 --- a/cvp/network_profile_wireless_config_generator/README.md +++ b/cvp/network_profile_wireless_config_generator/README.md @@ -136,7 +136,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/network_settings/README.md b/cvp/network_settings/README.md index b9f6110c7..56058c16d 100644 --- a/cvp/network_settings/README.md +++ b/cvp/network_settings/README.md @@ -74,8 +74,8 @@ Validation success! 👍 server_type: AAA ``` mapping config to UI Actions: - ![AAA Config 1](./images/aaa_1.png) - ![AAA Config 1.1](./images/aaa_1.1.png) + ![AAA Config 1](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/aaa_1.png) + ![AAA Config 1.1](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/aaa_1.1.png) + Example input config (2): ```yaml @@ -95,8 +95,8 @@ Validation success! 👍 server_type: ISE ``` mapping config to UI Actions: - ![AAA Config 2](./images/aaa_2.png) - ![AAA Config 2.1](./images/aaa_2.1.png) + ![AAA Config 2](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/aaa_2.png) + ![AAA Config 2.1](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/aaa_2.1.png) #### b. DHCP Update the network server with only the DHCP field: @@ -111,7 +111,7 @@ Validation success! 👍 - 2004:192:3::40 ``` mapping config to UI Actions: - ![DHCP Config](./images/dhcp.png) + ![DHCP Config](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/dhcp.png) #### c. DNS Update the network server with only the DNS field: @@ -127,7 +127,7 @@ Validation success! 👍 secondary_ip_address: 2040:50:0::0 ``` mapping config to UI Actions: - ![DNS Config](./images/dns.png) + ![DNS Config](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/dns.png) + Example input config (2): ```yaml @@ -141,7 +141,7 @@ Validation success! 👍 secondary_ip_address: 2040:50:0::0 ``` mapping config to UI Actions: - ![DNS Config 1](./images/dns1.png) + ![DNS Config 1](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/dns1.png) #### d. NTP Update the network server with only the NTP field: @@ -156,7 +156,7 @@ Validation success! 👍 - 1.1.1.1 ``` mapping config to UI Actions: - ![NTP Config](./images/ntp.png) + ![NTP Config](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/ntp.png) #### e. Time Zone Update the network server with only the Time Zone field: @@ -169,7 +169,7 @@ Validation success! 👍 timezone: America/Los_Angeles ``` mapping config to UI Actions: - ![Time Zone Config](./images/timezone.png) + ![Time Zone Config](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/timezone.png) #### f. Message of the Day Update the network server with only the Message of the Day field: @@ -184,7 +184,7 @@ Validation success! 👍 retain_existing_banner: false ``` mapping config to UI Actions: - ![Banner Config 1](./images/banner1.png) + ![Banner Config 1](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/banner1.png) + Example input config (2): ```yaml @@ -197,7 +197,7 @@ Validation success! 👍 retain_existing_banner: false ``` mapping config to UI Actions: - ![Banner Config 2](./images/banner2.png) + ![Banner Config 2](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/banner2.png) #### g. SNMP Traps Update the network server with only the SNMP Traps field: @@ -214,7 +214,7 @@ Validation success! 👍 - 2.2.2.2 ``` mapping config to UI Actions: - ![SNMP Traps Config 1](./images/snmp_trap1.png) + ![SNMP Traps Config 1](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/snmp_trap1.png) + Example input config (2): ```yaml @@ -227,7 +227,7 @@ Validation success! 👍 - 80.80.80.80 ``` mapping config to UI Actions: - ![SNMP Traps Config 2](./images/snmp_trap2.png) + ![SNMP Traps Config 2](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/snmp_trap2.png) #### h. Syslogs Update the network server with only the Syslogs field: @@ -244,7 +244,7 @@ Validation success! 👍 - 3.3.3.3 ``` mapping config to UI Actions: - ![Syslogs Config 1](./images/syslogs1.png) + ![Syslogs Config 1](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/syslogs1.png) + Example input config (2): ```yaml @@ -257,7 +257,7 @@ Validation success! 👍 - 90.90.90.90 ``` mapping config to UI Actions: - ![Syslogs Config 2](./images/syslogs2.png) + ![Syslogs Config 2](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/syslogs2.png) #### i. Application Visibility Update the network server with only the Application Visibility field: @@ -274,7 +274,7 @@ Validation success! 👍 enable_on_wired_access_devices: true ``` mapping config to UI Actions: - ![Netflow Config 1](./images/netflow1.png) + ![Netflow Config 1](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/netflow1.png) + Example input config (2): ```yaml @@ -286,7 +286,7 @@ Validation success! 👍 collector_type: Builtin ``` mapping config to UI Actions: - ![Netflow Config 2](./images/netflow2.png) + ![Netflow Config 2](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/netflow2.png) #### j. Wired Endpoint Data Collection Update the network server with only the Wired Endpoint Data Collection field: @@ -300,7 +300,7 @@ Validation success! 👍 enable_wired_data_collection: true ``` mapping config to UI Actions: - ![Wired Endpoint Config](./images/wire_endpoint.png) + ![Wired Endpoint Config](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/wire_endpoint.png) #### k. Wireless Controller, Access Point, and Wireless Clients Health Update the network server with only the Wireless Controller, Access Point, and Wireless Clients Health field: @@ -314,10 +314,10 @@ Validation success! 👍 enable_wireless_telemetry: true ``` mapping config to UI Actions: - ![Wireless Endpoint Config](./images/wireless_endpoint.png) + ![Wireless Endpoint Config](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/wireless_endpoint.png) *Note:* If you have updated the network server at the Global site, then at other sites under Global, if they have not yet updated the network server, they will inherit the values from the Global site. -![Inheritance](./images/inherit.png) +![Inheritance](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/inherit.png) ### 2. Add/Update All Network Servers in a Single Input + Example input config: @@ -529,7 +529,7 @@ To run scale network settings, we need to create a scalable site first. ``` #### 1d. UI Action - ![Scale Site UI](./images/scale_site.png) + ![Scale Site UI](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/scale_site.png) ### 2. Create Scale Network Settings @@ -619,9 +619,9 @@ To run scale network settings, we need to create a scalable site first. ``` #### 2d. UI Action - ![Scale Network UI 1](./images/scale_nw1.png) - ![Scale Network UI 2](./images/scale_nw2.png) - ![Scale Network UI 3](./images/scale_nw3.png) + ![Scale Network UI 1](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/scale_nw1.png) + ![Scale Network UI 2](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/scale_nw2.png) + ![Scale Network UI 3](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/scale_nw3.png) ## Understanding the Configurations for IP Pool Tasks @@ -647,7 +647,7 @@ Manages IPv4 and IPv6 IP pools at the global level. ``` mapping config to UI Actions: - ![Add Global Pool](./images/add_global_pool.png) + ![Add Global Pool](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/add_global_pool.png) * Parameter Explanation: ```yaml @@ -662,7 +662,7 @@ Manages IPv4 and IPv6 IP pools at the global level. #### b. Edit IP Pool (Global Pool) We can only edit 'name', 'dhcp_server_ips', and 'dns_server_ips' in the global pool. - ![alt text](./images/edit_global_pool.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/edit_global_pool.png) + Example input config: ```yaml network_settings_details: @@ -701,7 +701,7 @@ Manages IPv4 and IPv6 IP pools at the global level. ``` mapping config to UI Actions: - ![Delete All Global Pool](./images/delete_all_global_pool.png) + ![Delete All Global Pool](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/delete_all_global_pool.png) - **Note:** If the IP pool has been reserved, it cannot be deleted. @@ -805,7 +805,7 @@ This task reserves sub-pools from a global IP address pool for specific sites in slaac_support: false ``` mapping config to UI Actions: - ![Add Sub Pool 1](./images/add_sub_pool_1.png) + ![Add Sub Pool 1](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/add_sub_pool_1.png) + Example input config (2): ```yaml @@ -824,7 +824,7 @@ This task reserves sub-pools from a global IP address pool for specific sites in slaac_support: false ``` mapping config to UI Actions: - ![Add Sub Pool 2](./images/add_sub_pool_2.png) + ![Add Sub Pool 2](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/add_sub_pool_2.png) * Parameter Explanation: ```yaml @@ -879,7 +879,7 @@ This task reserves sub-pools from a global IP address pool for specific sites in force_delete: true ``` mapping config to UI Actions: - ![Delete All Subpool](./images/delete_all_subpool.png) + ![Delete All Subpool](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/network_settings/images/delete_all_subpool.png) #### d. Add/Edit/Delete Bulk IP Subpool Configurations + Example Config Input for Adding Multiple IP Subpools (3 IP Subpools | 2 Fields: 1 IPv4, 1 Field: 1 IPv4 + 1 IPv6): @@ -1108,7 +1108,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/network_settings_config_generator/README.md b/cvp/network_settings_config_generator/README.md index d4de4633a..3af362819 100644 --- a/cvp/network_settings_config_generator/README.md +++ b/cvp/network_settings_config_generator/README.md @@ -135,7 +135,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/plug_and_play/README.md b/cvp/plug_and_play/README.md index 985bc7847..8420f018b 100644 --- a/cvp/plug_and_play/README.md +++ b/cvp/plug_and_play/README.md @@ -52,7 +52,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -149,7 +149,7 @@ The `device_info` list contains the specific identity of the physical devices. The Plug and Play (PnP) workflow module automates the complete device lifecycle management in Cisco Catalyst Center, from initial device discovery to full provisioning. It supports adding devices to the PnP database, authorizing pending devices, claiming devices to sites, applying configuration templates and software images, and removing devices when needed. -![Plug and Play UI Page](images/Device_added_successfully.png) +![Plug and Play UI Page](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/Device_added_successfully.png) Refer to the full workflow specification for detailed instructions on the available options and their structure: https://galaxy.ansible.com/ui/repo/published/cisco/catalystcenter/content/module/pnp_workflow_manager/ @@ -461,7 +461,7 @@ pnp_details: pid: C9800-40-K9 ``` -![alt text](images/Bulk_pnp_device_addition.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/Bulk_pnp_device_addition.png) #### b.Device Authorization for Bulk Onboarding (Optional) @@ -523,19 +523,19 @@ pnp_details: ``` Step 1: Ensure that the device exists in Plug and Play (PnP) before executing the playbook. -![alt text](images/Device_is_present.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/Device_is_present.png) Step 2: Execute the pnp playbook. Upon successful execution, the device will be deleted from PnP. -![alt text](images/Device_is_removed.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/Device_is_removed.png) Step 4: Verify that device is removed To ensure the device has been successfully removed, verify the PnP UI. -![alt text](images/verify_device_deletion.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/verify_device_deletion.png) #### d.Task: Bulk Device Deletion @@ -562,20 +562,20 @@ pnp_details: Step 1: Ensure that the device exists in Plug and Play (PnP) before trying to remove them. -![alt text](images/All_devices_present.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/All_devices_present.png) Step 2: Execute the PnP Playbook: Upon successful execution, the device will be deleted from PnP. -![alt text](images/Device_is_removed.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/Device_is_removed.png) Step 3: Verify that all devices is removed To ensure the devices has been successfully removed, verify the PnP UI. -![alt text](images/All_devices_get_removed.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/All_devices_get_removed.png) #### e. Claiming a Cisco Catalyst 9K Switch @@ -619,19 +619,19 @@ Step 3: Mapping Example to UI Actions #### The screenshots below demonstrate how to manually onboard and claim a device in the Cisco Catalyst Center UI: -![alt text](images/claim_switch_device_img1.png) -![alt text](images/claim_switch_device_img2.png) -![alt text](images/claim_switch_device_img3.png) -![alt text](images/claim_switch_device_img4.png) -![alt text](images/clain_switch_device_img5.png) -![alt text](images/claim_switch_device_img6.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/claim_switch_device_img1.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/claim_switch_device_img2.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/claim_switch_device_img3.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/claim_switch_device_img4.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/clain_switch_device_img5.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/claim_switch_device_img6.png) #### f. Claiming a Cisco Catalyst 9K Switch Stack Similar to the task for claiming a single switch, this task relies on a predefined configuration template in Cisco Catalyst Center. However, in this case, the **StackSwitch** option is selected in the UI to indicate that the device being onboarded is part of a switch stack. -![alt text](images/Claim_siwtch_stack_9k.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/Claim_siwtch_stack_9k.png) **Example: Input (YAML)** ```bash @@ -690,7 +690,7 @@ pnp_details: **Note:** - Ensure that the required configurations are in place before proceeding, including: Template, Image and Device ID Certificate which is compatible to router device -![alt text](images/Claim_router_device_img1.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/Claim_router_device_img1.png) #### h. Claiming a Cisco Embedded Wireless Controller (EWLC) @@ -729,11 +729,11 @@ pnp_details: **Mapping Example to UI Actions** ##### The screenshots below demonstrate how to manually onboard and claim a device in the Cisco Catalyst Center UI: -![alt text](images/Claim_ewlc_img1.png) -![alt text](images/Claim_ewlc_img2.png) -![alt text](images/Claim_ewlc_img3.png) -![alt text](images/Claim_ewlc_img4.png) -![alt text](images/Claim_ewlc_img5.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/Claim_ewlc_img1.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/Claim_ewlc_img2.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/Claim_ewlc_img3.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/Claim_ewlc_img4.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/Claim_ewlc_img5.png) #### i. Claiming Multiple EWLC Devices for High Availability (HA) @@ -784,20 +784,20 @@ pnp_details: **Step 1: Assign a site to each device** -![alt text](images/claim_multiple_ewlc_img2.png) -![alt text](images/claim_multiple_ewlc_img3.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/claim_multiple_ewlc_img2.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/claim_multiple_ewlc_img3.png) **Step 2: Assign Configuration for each device, Catalyst WLC Controller Setting is mandatory** -![alt text](images/claim_multiple_ewlc_img4.png) -![alt text](images/claim_multiple_ewlc_img6.png) -![alt text](images/claim_multiple_ewlc_img7.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/claim_multiple_ewlc_img4.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/claim_multiple_ewlc_img6.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/claim_multiple_ewlc_img7.png) **Step 3: Provision Templates, if there won't be any template configure there won't be any action required** -![alt text](images/claim_multiple_ewlc_img8.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/claim_multiple_ewlc_img8.png) **Step 4: Summary, can preview the device configuration details** -![alt text](images/claim_multiple_ewlc_img9.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/claim_multiple_ewlc_img9.png) #### k. Resetting an Error PnP Device (EWLC Type) @@ -826,7 +826,7 @@ pnp_details: - **Reset**: The playbook ensures that the device is reset and ready for another onboarding attempt. **Mapping Config to UI Actions** -![alt text](images/reset_error_ewlc_pnp.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/reset_error_ewlc_pnp.png) #### l. Claiming Access Points (APs) @@ -850,7 +850,7 @@ pnp_details: **Mapping Config to UI Actions** -![alt text](images/claim_ap_device_img1.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/claim_ap_device_img1.png) ##### Key Points: @@ -858,7 +858,7 @@ pnp_details: - **Access Point Details**: The serial number, hostname, and product ID (PID) are provided for identification. - **Important**: Ensure that the Wireless LAN Controller (WLC) is fully onboarded before claiming any Access Points; otherwise, you may encounter an error. -![alt text](images/ap_failure_img1.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/plug_and_play/images/ap_failure_img1.png) #### m. Add and Claim and Authorize a Device diff --git a/cvp/pnp_config_generator/README.md b/cvp/pnp_config_generator/README.md index 3ac529e58..fab3e53dc 100644 --- a/cvp/pnp_config_generator/README.md +++ b/cvp/pnp_config_generator/README.md @@ -146,7 +146,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/provision/README.md b/cvp/provision/README.md index 6aa4af437..321d93621 100644 --- a/cvp/provision/README.md +++ b/cvp/provision/README.md @@ -33,7 +33,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -151,7 +151,7 @@ provision_details: #### Upon successful completion, the device is assigned to a site and you will see an output similar to the following: -![alt text](images/site_assignment_successful.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/provision/images/site_assignment_successful.png) ```bash "response": [ @@ -180,7 +180,7 @@ provision_details: #### Upon successful completion the device is assigned and provisioned and you will see an output similar to the following: -![alt text](images/Device_provisioned.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/provision/images/Device_provisioned.png) ```yml "msg": "Provisioning of the device 'xx.xx.xx.xx' completed successfully.", @@ -205,7 +205,7 @@ provision_details: #### Upon successful completion the device is assigned and provisioned and you will see an output similar to the following: -![alt text](images/wlc_device_provisioned.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/provision/images/wlc_device_provisioned.png) ```yml "msg": "Provisioning of the device 'xx.xx.xx.xx' completed successfully.", @@ -234,7 +234,7 @@ provision_details: #### Upon a successful completion, the device is reprovisioned and you will see an output similar to the following: -![alt text](images/Re_provision_successful.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/provision/images/Re_provision_successful.png) ```yml "msg": "Re-Provision for device 'xx.xx.xx.xx' done successfully", @@ -263,7 +263,7 @@ provision_details: #### Upon a successful completion, the device is reprovisioned and you will see an output similar to the following: -![alt text](images/wlc_reprovision_successful.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/provision/images/wlc_reprovision_successful.png) ```yml "msg": "Wireless Device 'xx.xx.xx.xx' is already provisioned.", @@ -286,7 +286,7 @@ provision_details: #### Upon a successful completion, the device will be removed from the inventory and you will see an output similar to the following: -![alt text](images/Device_unprovisioned.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/provision/images/Device_unprovisioned.png) ```yml "msg": "Deletion done Successfully for the device 'xx.xx.xx.xx' ", @@ -318,7 +318,7 @@ provision_details: #### Upon a successful completion, application telemetry will be enabled and you will see an output similar to the following: -![alt text](images/telemetry_enabled.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/provision/images/telemetry_enabled.png) ```yml { @@ -359,7 +359,7 @@ provision_details: #### Upon a successful completion, application telemetry will be enabled and you will see an output similar to the following: -![alt text](images/telemetry_enable_successfully_wlc.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/provision/images/telemetry_enable_successfully_wlc.png) ```yml { @@ -401,7 +401,7 @@ provision_details: #### Upon a successful completion, app telemetry will be disabled and you will see an output similar to the following: -![alt text](images/telemetry_disabled_successfully_wired.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/provision/images/telemetry_disabled_successfully_wired.png) ```yml { @@ -431,7 +431,7 @@ provision_details: #### Upon a successful completion, app telemetry will be disabled and you will see an output similar to the following: -![alt text](images/disable_telem_wlc_successfully.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/provision/images/disable_telem_wlc_successfully.png) ```yml { @@ -449,8 +449,8 @@ provision_details: To provision a device (Wireless Controller) with a feature template, we first need to create Network Profiles with the Wireless type, assign the corresponding site to the site where we will provision the wireless device, and then attach the desired Feature Templates to apply to that network profile. For example, we will have a network profile attached with the feature template 'CleanAir Configuration'. -![alt text](./images/nw_profile.png) -![alt text](./images/nw_profile_feature_template.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/provision/images/nw_profile.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/provision/images/nw_profile_feature_template.png) #### Input (YAML) @@ -467,10 +467,10 @@ provision_details: force_provisioning: True ``` + The UI workflow: -![alt text](images/provision_feature_template.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/provision/images/provision_feature_template.png) #### Upon a successful completion, the configuration from the feature template is automatically pushed down to the device -![alt text](images/verify_provision_feature_template.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/provision/images/verify_provision_feature_template.png) + The playbook return: ```yml @@ -485,7 +485,7 @@ msg: ### **Notes**: When calling with the above input, not only is `App Name: Model Config Provisioning` provisioned successfully, but other provisioning configurations such as `App Name: Fabric Provisioning, Device Provisioning, AP Provisioning` are also successful. -![alt text](images/history_provision_feature_template.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/provision/images/history_provision_feature_template.png) #### If we want to skip AP provisioning during WLC provisioning, we need to provide the `skip_ap_provision` parameter with the value `True`. @@ -507,10 +507,10 @@ provision_details: + The UI workflow: -![alt text](images/skip_ap_provision.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/provision/images/skip_ap_provision.png) #### Upon successful completion, the configuration will be pushed to the device similar to the provisioning with the previous feature template; however, there will be no provisioning action for the AP (check `Last Provisioned`). -![alt text](images/verify_skip_ap_provision.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/provision/images/verify_skip_ap_provision.png) + The playbook return: ```yml @@ -526,7 +526,7 @@ msg: To configure a wireless controller with AP authorization policies while skipping immediate AP provisioning. -![alt text](./images/skip_ap_provision.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/provision/images/skip_ap_provision.png) #### Input (YAML) ```yml @@ -566,8 +566,8 @@ To provision both the wireless controller and all associated APs with authorizat **prerequisite**: AP authorization list must exist in Catalyst Center before provisioning.This list can be created under **Design > Network Settings > Wireless > Security Settings > AP Authorization List**. -![alt text](./images/Ap_authorization_list.png) -![alt text](./images/no_skip_provision.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/provision/images/Ap_authorization_list.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/provision/images/no_skip_provision.png) #### Input (YAML) ```yml @@ -609,7 +609,7 @@ Rolling AP upgrade allows you to upgrade Access Points in phases, minimizing net **prerequisite**: Wireless controller must be added to inventory and AP locations must be configured. -![alt text](./images/rolling_ap_upgrade.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/provision/images/rolling_ap_upgrade.png) #### Input (YAML) ```yml diff --git a/cvp/provision_config_generator/README.md b/cvp/provision_config_generator/README.md index f46f92520..031cb6a07 100644 --- a/cvp/provision_config_generator/README.md +++ b/cvp/provision_config_generator/README.md @@ -133,7 +133,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/reports/README.md b/cvp/reports/README.md index 9b0d3c577..73a747198 100644 --- a/cvp/reports/README.md +++ b/cvp/reports/README.md @@ -59,7 +59,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -1218,9 +1218,9 @@ reports_details: value: - value: "AREA" ``` -![alt text](./images/image1.png) -![alt text](./images/image.png) -![alt text](./images/image2.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/reports/images/image1.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/reports/images/image.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/reports/images/image2.png) ##### 2. **Schedule Report for Later Execution** *Example*: Schedule an Rogue aWIPs report for a specific date and time. @@ -1283,10 +1283,10 @@ reports_details: end_date_time: "2026-01-20 02:00 PM" time_zone: "Asia/Calcutta" ``` -![alt text](./images/image3.png) -![alt text](./images/image4.png) -![alt text](./images/image5.png) -![alt text](./images/image9.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/reports/images/image3.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/reports/images/image4.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/reports/images/image5.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/reports/images/image9.png) ##### 3. **Create Recurring Weekly Report** *Example*: Create a weekly security advisory report. @@ -1339,10 +1339,10 @@ reports_details: - value: "HIGH" - value: "CRITICAL" ``` -![alt text](./images/image6.png) -![alt text](./images/image7.png) -![alt text](./images/image8.png) -![alt text](./images/image9.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/reports/images/image6.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/reports/images/image7.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/reports/images/image8.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/reports/images/image9.png) ##### 4. **Create Monthly Recurring Report** *Example*: Create a Inventory (All Data) Report with monthly recursive Execution and webhook notification. @@ -1402,10 +1402,10 @@ reports_details: - value: "17.12.4" - value: "17.12.5" ``` -![alt text](./images/image10.png) -![alt text](./images/image11.png) -![alt text](./images/image12.png) -![alt text](./images/image13.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/reports/images/image10.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/reports/images/image11.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/reports/images/image12.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/reports/images/image13.png) ##### 5. **Create Monthly Recurring Report** *Example*: Create a Inventory (All data version 2.0) Report with Email Notification and generating report recursively on last day of month. @@ -1482,9 +1482,9 @@ reports_details: - value: "17.12.4" - value: "17.12.5" ``` -![alt text](./images/image14.png) -![alt text](./images/image15.png) -![alt text](./images/image9.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/reports/images/image14.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/reports/images/image15.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/reports/images/image9.png) ##### 6. **Delete Reports** *Example*: Delete one or more reports by specifying their names and view information. @@ -1505,8 +1505,8 @@ reports_details: view: view_name: "All Data Version 2.0" ``` -![alt text](./images/image16.png) -![alt text](./images/image17.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/reports/images/image16.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/reports/images/image17.png) --- diff --git a/cvp/sda_device_removal_and_unprovision/README.md b/cvp/sda_device_removal_and_unprovision/README.md index 775833675..d064113ec 100644 --- a/cvp/sda_device_removal_and_unprovision/README.md +++ b/cvp/sda_device_removal_and_unprovision/README.md @@ -73,7 +73,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -136,9 +136,9 @@ Validate the input file against the workflow schema before execution: ## References -- [SDA Host Onboarding Workflow](../sda_hostonboarding/README.md) -- [SDA Fabric Device Roles Workflow](../sda_fabric_device_roles/README.md) -- [Provision Workflow](../provision/README.md) +- [SDA Host Onboarding Workflow](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/sda_hostonboarding/README.md) +- [SDA Fabric Device Roles Workflow](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/sda_fabric_device_roles/README.md) +- [Provision Workflow](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/cvp/provision/README.md) ## VARS_FILE_PATH Path Resolution Ansible resolves `VARS_FILE_PATH` relative to the playbook directory, not the current working directory. diff --git a/cvp/sda_extranet_policies_config_generator/README.md b/cvp/sda_extranet_policies_config_generator/README.md index 8f88bf566..f6689489a 100644 --- a/cvp/sda_extranet_policies_config_generator/README.md +++ b/cvp/sda_extranet_policies_config_generator/README.md @@ -142,7 +142,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/sda_fabric_device_roles/README.md b/cvp/sda_fabric_device_roles/README.md index 499fcb3fe..94a9eb1e2 100644 --- a/cvp/sda_fabric_device_roles/README.md +++ b/cvp/sda_fabric_device_roles/README.md @@ -47,11 +47,11 @@ If you update the device configuration as a part of problem resolution, ensure t From **Provision > Fabric Sites** in Catalyst Center, select the fabric site to add a device. Next, click a device from the **List** view under the **Fabric Infrastructure** tab and edit Fabric Role under **More Actions**. -![Alt text](./images/Select-Device-in-Fabric.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_device_roles/images/Select-Device-in-Fabric.png) Add Control Plane Role for the device and select LISP Pub/Sub as a route distribution protocol in Catalyst Center UI. -![Alt text](./images/Add-Control-Plane.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_device_roles/images/Add-Control-Plane.png) ##### Add Control Plane Role using Playbook @@ -66,7 +66,7 @@ fabric_devices_details: ##### Enable Control Plane - Border Node - Edge Node on Catalyst Center using UI and playbook: -![Alt text](./images/Fabric-CP-Border-Edge.jpeg) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_device_roles/images/Fabric-CP-Border-Edge.jpeg) ```bash fabric_devices_details: @@ -86,7 +86,7 @@ fabric_devices_details: ##### Update Border Node and add L2 Handoff using Catalyst Center UI and playbook: -![Alt text](./images/Border-Node-and-L2-Handoff.jpeg) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_device_roles/images/Border-Node-and-L2-Handoff.jpeg) ```bash fabric_devices_details: @@ -110,7 +110,7 @@ fabric_devices_details: ##### Add Layer 3 Handoff with SDA Transit through Catalyst Center UI and playbook: -![Alt text](./images/L3-with-SDA.jpeg) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_device_roles/images/L3-with-SDA.jpeg) ```bash fabric_devices_details: @@ -128,7 +128,7 @@ fabric_devices_details: ##### Add Layer 3 Handoff with IP Transit using Catalyst Center and sample playbook: -![Alt text](./images/L3-with-IP-Transit.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_device_roles/images/L3-with-IP-Transit.png) ```bash fabric_devices_details: @@ -151,10 +151,10 @@ fabric_devices_details: To enable the ECA device, it means we will add it as at least the device roles of Control Plane and Border Node (CP, BN) and also enable the role of Embedded Wireless LAN Controller (WC). *Note: Typically, the Wireless LAN Controller (WC) role is only available on the Wireless Controller. To enable the WC role on a switch, we need to update the device with an image that includes the accompanying sub-packet. For example base image 'cat9k_iosxe.17.12.01.SPA.bin', sub-packet image 'C9800-SW-iosxe-wlc.17.12.01.SPA.bin'* -![ECA device image](./images/eca_device_image.png) +![ECA device image](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_device_roles/images/eca_device_image.png) **Catalyst Center UI and playbook:** -![ECA device](./images/eca_device.png) +![ECA device](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_device_roles/images/eca_device.png) ```bash fabric_devices_details: @@ -352,7 +352,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/sda_fabric_devices_config_generator/README.md b/cvp/sda_fabric_devices_config_generator/README.md index a20149f6f..5d5536ffb 100644 --- a/cvp/sda_fabric_devices_config_generator/README.md +++ b/cvp/sda_fabric_devices_config_generator/README.md @@ -128,7 +128,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/sda_fabric_discover_and_onboard_fabric_devices/README.md b/cvp/sda_fabric_discover_and_onboard_fabric_devices/README.md index a88154aa3..a4cc706d1 100644 --- a/cvp/sda_fabric_discover_and_onboard_fabric_devices/README.md +++ b/cvp/sda_fabric_discover_and_onboard_fabric_devices/README.md @@ -33,7 +33,7 @@ From the repository root: python3 -m venv .venv source .venv/bin/activate pip install --upgrade pip setuptools wheel -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -814,7 +814,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/sda_fabric_extranet_policy/README.md b/cvp/sda_fabric_extranet_policy/README.md index df5105819..e7a2b724f 100644 --- a/cvp/sda_fabric_extranet_policy/README.md +++ b/cvp/sda_fabric_extranet_policy/README.md @@ -124,40 +124,40 @@ ansible-playbook -i host_inventory_dnac1/hosts.yml cvp/fabric_extranet_policy/pl #### **Mapping config to UI Actions.** - The config parameter within this task corresponds to the "Provision > Virtual Networks> Create Template" action in the Cisco Catalyst Center UI. - Select "Provision" -> "Virtual Networks" to access the Virtual Networks page. -![alt text](./images/ext1.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/ext1.png) - Click Layer3 Virtual Network. -![alt text](./images/ext2.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/ext2.png) - Click "Extranet Policies" -> "Create Extranet Policy" to start creating a new policy. -![alt text](./images/ext3.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/ext3.png) - ext4.png: Enter the Extranet Policy name (eg: "ex_policy_infra_vn_provider") and click "Next". -![alt text](./images/ext4.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/ext4.png) - Select Provider Virtual Network (eg: "INFRA_VN") and click "Next". -![alt text](./images/ext5.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/ext5.png) - Select Subscriber Virtual Networks (eg: "DEFAULT_VN", "NY_L3_1") and click "Next". -![alt text](./images/ext6.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/ext6.png) - Select "New York" in Fabric Sites, click "Next" to specify the site for the Extranet Policy. -![alt text](./images/ext7.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/ext7.png) - Check "Summary," click "Next" to confirm the configuration. -![alt text](./images/ext8.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/ext8.png) - Select "Preview and Deploy," click "Deploy" to deploy the Extranet Policy. -![alt text](./images/ext9.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/ext9.png) - Click "Save Intent," then click "Submit" to save and submit the configuration. -![alt text](./images/ext10.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/ext10.png) - Confirm "ex_policy_infra_vn_provider" in the Extranet Policies list to test the policy in action. -![alt text](./images/ext11.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/ext11.png) - Check Extranet Policy created. -![alt text](./images/ext12.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/ext12.png) #### **Example Input File.** @@ -175,37 +175,37 @@ extranet_policies: ### 2. Update SDA Extranet Policies #### **Mapping config to UI Actions.** - Select Extranet Policy Name to update -> "More Action" -> "Edit Extranet Policy" to update Extranet Policy. -![alt text](./images/edit_ext1.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/edit_ext1.png) - In Subscriber Virtual Networks section -> "Edit" to update Subscriber Virtual Networks. -![alt text](./images/edit_ext2.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/edit_ext2.png) - Check all Subscriber Virtual Networks that have been added and Subscriber Virtual Networks that you want to add. -![alt text](./images/edit_ext3.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/edit_ext3.png) - Select Subscriber Virtual Networks that you want to add -> "Next" to update Subscriber Virtual Networks. -![alt text](./images/edit_ext5.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/edit_ext5.png) - Select Fabric Sites that you want to Update, if not updated, you can skip this step -> "Next". -![alt text](./images/edit_ext41.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/edit_ext41.png) - Check the configuration information that has changed -> "Next". -![alt text](./images/edit_ext42.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/edit_ext42.png) - Deploy Extranet Policy that has just been updated. -![alt text](./images/edit_ext6.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/edit_ext6.png) - Enter "Task Name" for the update task -> Submit. -![alt text](./images/edit_ext7.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/edit_ext7.png) - Execute "Save Intent". -![alt text](./images/edit_ext8.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/edit_ext8.png) - Update notification successful. -![alt text](./images/edit_ext9.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/edit_ext9.png) - Check configuration update. -![alt text](./images/edit_ext10.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/edit_ext10.png) #### **Example Input File.** @@ -225,16 +225,16 @@ extranet_policies: ### 2. Delete SDA Extranet Policies #### **Mapping config to UI Actions.** - Select Extranet Policy Name to update -> "More Action" -> "Delete Extranet Policy" to update Extranet Policy. -![alt text](./images/delete_1.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/delete_1.png) - Click "Apply" to delete. -![alt text](./images/delete_2.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/delete_2.png) - Click "Next" -> to continue deleting Extranet Policy. -![alt text](./images/delete_3.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/delete_3.png) - Check the deleted Extranet Policy. -![alt text](./images/delete_5.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_extranet_policy/images/delete_5.png) #### **Example Input File.** @@ -282,7 +282,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/sda_fabric_multicast/README.md b/cvp/sda_fabric_multicast/README.md index 59ed20301..556edf84d 100644 --- a/cvp/sda_fabric_multicast/README.md +++ b/cvp/sda_fabric_multicast/README.md @@ -54,7 +54,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -268,7 +268,7 @@ The *SDA Fabric Multicast* feature relies on these components that must be prede ipv4_ssm_ranges: - "232.0.0.0/8" ``` - ###### ![Update SDA Multicasts Example](./images/update_sda_multicast.png) + ###### ![Update SDA Multicasts Example](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_multicast/images/update_sda_multicast.png) ###### **Figure 1**: *Update SDA Multicasts Example* --- @@ -299,7 +299,7 @@ The *SDA Fabric Multicast* feature relies on these components that must be prede ex_rp_ipv4_address: "204.1.2.70" ``` - ###### ![Delete SDA Multicasts Example](./images/delete_sda_multicast.png) + ###### ![Delete SDA Multicasts Example](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_multicast/images/delete_sda_multicast.png) ###### **Figure 2**: *Delete SDA Multicasts Example* --- @@ -311,7 +311,7 @@ Run the following command to validate your input file against the schema: ./tools/schemavalidation.sh -s ./cvp/sda_fabric_multicast/schema/sda_fabric_multicast_schema.yml -v ./cvp/sda_fabric_multicast/vars/sda_fabric_multicast_inputs.yml ``` -##### ![Validate parameters Multicast Configuration Example](./images/validate_parameters_multicast.png) +##### ![Validate parameters Multicast Configuration Example](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_multicast/images/validate_parameters_multicast.png) ##### **Figure 3**: *Validate parameters Multicast Configuration* --- @@ -329,7 +329,7 @@ Run the following command to validate your input file against the schema: 2. **Verify Deployment**: After execution, verify the configuration in the Cisco Catalyst Center UI under the SDA fabric multicast section. If `catalystcenter_debug` is enabled, review the logs for detailed operation information. - ![Multicast Configuration Example](./images/mapping_parameter_multicast.png) + ![Multicast Configuration Example](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_multicast/images/mapping_parameter_multicast.png) **Figure 4**: *SDA Fabric Multicast Configuration in Cisco Catalyst Center* --- diff --git a/cvp/sda_fabric_multicast_config_generator/README.md b/cvp/sda_fabric_multicast_config_generator/README.md index e4c0575f2..2a2ff6b6c 100644 --- a/cvp/sda_fabric_multicast_config_generator/README.md +++ b/cvp/sda_fabric_multicast_config_generator/README.md @@ -388,7 +388,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/sda_fabric_sites_zones/README.md b/cvp/sda_fabric_sites_zones/README.md index 6f9c7e088..075af39e4 100644 --- a/cvp/sda_fabric_sites_zones/README.md +++ b/cvp/sda_fabric_sites_zones/README.md @@ -50,7 +50,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -180,16 +180,16 @@ These examples show how to define input YAML files for Fabric Site & Zone Manage A. Create Fabric Sites and Fabric Zones (state: merged) Figure 1: Creating Fabric Sites and Fabric Zones -![Alt text](./images/Fabric_sites.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_sites_zones/images/Fabric_sites.png) Figure 2 Select the Authentication profile for the fabric site -![Alt text](./images/Fabric_site_auth_profile.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_sites_zones/images/Fabric_site_auth_profile.png) Figure 3 Select the fabric zones -![Alt text](./images/Fabric_zones.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_sites_zones/images/Fabric_zones.png) Figure 4 Configuratin Summary -![Alt text](./images/Fabric_site_zone_summary.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_sites_zones/images/Fabric_site_zone_summary.png) This configuration sets up a fabric site (AREA1 BLD1) and two fabric zones (FLOOR1 and FLOOR2) under it. All areas use No Authentication, and pub/sub is enabled for the fabric site to support real-time event sync @@ -215,13 +215,13 @@ This can be achieved using the following input YAML configuration: B. Authentication Control: Apply different authentication profiles (state: merged) Figure 1: Apply Closed Authentication -![Alt text](./images/fb_close.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_sites_zones/images/fb_close.png) Figure 2: Customize settings Closed Authentication -![Alt text](./images/fb_close_edit.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_sites_zones/images/fb_close_edit.png) Figure 3: Customize settings Low Impact (include pre_auth_acl) -![Alt text](./images/fb_low_edit.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_sites_zones/images/fb_low_edit.png) Updated Closed Authentication for San Jose site @@ -281,7 +281,7 @@ Customize settings such as 802.1X fallback timeout, Wake-on-LAN, and Pre-Auth AC C. Apply Pending Events (state: merged) Figure 1: Apply Pending Events -![Alt text](./images/apply_pending.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_sites_zones/images/apply_pending.png) The following input will update the fabric configuration after changes that have not been applied. @@ -296,7 +296,7 @@ The following input will update the fabric configuration after changes that have D. Remove Fabric Zone (state: deleted) Figure 1: Remove Fabric Zone By Unchecking Those Fabric Zones -![Alt text](./images/delete_fabric_zone.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_sites_zones/images/delete_fabric_zone.png) This action will delete 2 fabric zones of the RTP site, RTP_BLD10 and RTP_BLD11 @@ -313,7 +313,7 @@ E. Remove Fabric Site (state: deleted) This action will delete fabric site RTP Figure 1: Delete Fabric Site -![Alt text](./images/delete_fb_site.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_sites_zones/images/delete_fb_site.png) ```yaml - fabric_sites: @@ -350,13 +350,13 @@ If there is an error in the input or an issue with the API call during execution After executing the playbook, check the Catalyst Center UI to verify switch profile has been created. If debug_log is enabled, you can also review the logs for detailed information on operations performed and any updates made. Figure 1: Successfully Created Site AREA1 BLD1 -![Alt text](./images/Fabric_site_and_zones.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_sites_zones/images/Fabric_site_and_zones.png) Figure 2: Successfully Updated Authentication For San Jose Site -![Alt text](./images/fb_close.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_sites_zones/images/fb_close.png) Figure 3: After Using apply_pending_events: true -![Alt text](./images/aplply_pending_after.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_sites_zones/images/aplply_pending_after.png) 4. **Creating Bulk Site Configurations using JINJA Template and Using the Playbook** @@ -422,7 +422,7 @@ PLAY RECAP ********************************************************************* catalyst_center220 : ok=9 changed=3 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0 ``` Figure 1 Jinja created fabric sites -![Alt text](./images/fabric_sites_with_jinja.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_sites_zones/images/fabric_sites_with_jinja.png) ## References diff --git a/cvp/sda_fabric_sites_zones_config_generator/README.md b/cvp/sda_fabric_sites_zones_config_generator/README.md index 5b8b0954a..0db7c2d02 100644 --- a/cvp/sda_fabric_sites_zones_config_generator/README.md +++ b/cvp/sda_fabric_sites_zones_config_generator/README.md @@ -150,7 +150,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/sda_fabric_transits/README.md b/cvp/sda_fabric_transits/README.md index 715d05e08..ff21e8b61 100644 --- a/cvp/sda_fabric_transits/README.md +++ b/cvp/sda_fabric_transits/README.md @@ -58,7 +58,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -162,7 +162,7 @@ Before creating fabric transits, ensure the following are configured in *Cisco C ##### 1. **Create IP-Based Transit** *Example*: Configure a new IP-based transit with BGP routing. -![Alt text](images/image.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_transits/images/image.png) ```yaml catalystcenter_version: 3.1.3.0 catalystcenter_verify: false @@ -198,7 +198,7 @@ fabric_transits: ##### 3. **Create SDA LISP BGP Transit** *Example*: Configure an SDA BGP transit with control plane devices. -![Alt text](images/image-1.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_transits/images/image-1.png) ```yaml catalystcenter_version: 3.1.3.0 catalystcenter_verify: false @@ -243,7 +243,7 @@ fabric_transits: ##### 5. **Update Transit Configuration** *Example*: Update control plane devices for an existing transit. -![Alt text](./images/image-3.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_transits/images/image-3.png) > **Note**: IP-based transits cannot change ASN after creation. Only control plane devices and multicast settings can be updated for SDA transits. ```yaml catalystcenter_version: 3.1.3.0 @@ -278,7 +278,7 @@ fabric_transits: ##### 7. **Delete Fabric Transits** *Example*: Delete one or more fabric transits by name. -![Alt text](images/image-2.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_transits/images/image-2.png) > **Warning**: Deleting transits may impact network connectivity. Verify dependencies before proceeding. ```yaml catalystcenter_version: 3.1.3.0 @@ -322,7 +322,7 @@ yamale -s cvp/sda_fabric_transits/schema/sda_fabric_transits_workflow_schema.yml 3. **Verify Deployment**: After execution, verify the configuration in the *Cisco Catalyst Center* UI under **Design > Network Settings > SDA Fabric Transits**. If `catalystcenter_debug` is enabled, review the logs for detailed operation information. - ![Fabric transit configuration in Cisco Catalyst Center UI](./images/image-1.png) + ![Fabric transit configuration in Cisco Catalyst Center UI](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_fabric_transits/images/image-1.png) **Figure 1**: *Fabric Transit Configuration in Cisco Catalyst Center* --- diff --git a/cvp/sda_fabric_transits_config_generator/README.md b/cvp/sda_fabric_transits_config_generator/README.md index e4a226770..3718909af 100644 --- a/cvp/sda_fabric_transits_config_generator/README.md +++ b/cvp/sda_fabric_transits_config_generator/README.md @@ -139,7 +139,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/sda_fabric_virtual_networks_config_generator/README.md b/cvp/sda_fabric_virtual_networks_config_generator/README.md index e7b1f8790..67a42c6be 100644 --- a/cvp/sda_fabric_virtual_networks_config_generator/README.md +++ b/cvp/sda_fabric_virtual_networks_config_generator/README.md @@ -155,7 +155,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/sda_host_port_onboarding_config_generator/README.md b/cvp/sda_host_port_onboarding_config_generator/README.md index e34db7b8b..c5d6c27bf 100644 --- a/cvp/sda_host_port_onboarding_config_generator/README.md +++ b/cvp/sda_host_port_onboarding_config_generator/README.md @@ -69,7 +69,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/sda_hostonboarding/README.md b/cvp/sda_hostonboarding/README.md index 7b6d19049..fb3e7176e 100644 --- a/cvp/sda_hostonboarding/README.md +++ b/cvp/sda_hostonboarding/README.md @@ -32,7 +32,7 @@ Module documentation (Ansible Galaxy): https://galaxy.ansible.com/ui/repo/published/cisco/catalystcenter/content/module/sda_host_port_onboarding_workflow_manager/ Host Onboarding Figure: -![alt text](./images/host_onboarding.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_hostonboarding/images/host_onboarding.png) --- @@ -222,21 +222,21 @@ sda_host_onboarding_details: ``` #### 4.2. Add port interfaces (UI) -![alt text](./images/port-assign.png) -![alt text](./images/add-port-assignment.png) -![alt text](./images/choose_port-assign.png) -![alt text](./images/deloy_port_assignment.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_hostonboarding/images/port-assign.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_hostonboarding/images/add-port-assignment.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_hostonboarding/images/choose_port-assign.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_hostonboarding/images/deloy_port_assignment.png) #### 4.3. Add port channel (UI) -![alt text](./images/port-assign.png) -![alt text](./images/create-port-channel.png) -![alt text](./images/Chose-device.png) -![alt text](./images/Chose_parameter_port_channel.png) -![alt text](./images/Chose_interface_port_channel.png) -![alt text](./images/Deploy_port_channel.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_hostonboarding/images/port-assign.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_hostonboarding/images/create-port-channel.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_hostonboarding/images/Chose-device.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_hostonboarding/images/Chose_parameter_port_channel.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_hostonboarding/images/Chose_interface_port_channel.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_hostonboarding/images/Deploy_port_channel.png) #### 4.4. Result -![alt text](./images/result-add-port.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_hostonboarding/images/result-add-port.png) --- @@ -326,15 +326,15 @@ sda_host_onboarding_details: ``` #### 5.2. Update port interfaces (UI) -![alt text](./images/edit-port-assignment.png) -![alt text](./images/update_port_assignment.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_hostonboarding/images/edit-port-assignment.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_hostonboarding/images/update_port_assignment.png) #### 5.3. Update port channel (UI) -![alt text](./images/edit_port_channel.png) -![alt text](./images/update_port_channel.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_hostonboarding/images/edit_port_channel.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_hostonboarding/images/update_port_channel.png) #### 5.4. Result -![alt text](./images/result_update_port_channel.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_hostonboarding/images/result_update_port_channel.png) --- @@ -368,12 +368,12 @@ sda_host_onboarding_details: ``` #### 6.2. Delete port interfaces (UI) -![alt text](./images/clear_port_assignment.png) -![alt text](./images/deploy_clear_port_assignment.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_hostonboarding/images/clear_port_assignment.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_hostonboarding/images/deploy_clear_port_assignment.png) #### 6.3. Delete Port Channel (UI) -![alt text](./images/delete_port_channel.png) -![alt text](./images/apply_delete_port_channel.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_hostonboarding/images/delete_port_channel.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_hostonboarding/images/apply_delete_port_channel.png) --- @@ -407,7 +407,7 @@ sda_host_onboarding_details: ``` #### 7.2. Result -![alt text](./images/vlan_ssid.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_hostonboarding/images/vlan_ssid.png) --- @@ -773,7 +773,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/sda_port_assignment_migration/README.md b/cvp/sda_port_assignment_migration/README.md index 537f64044..57ec4e4de 100644 --- a/cvp/sda_port_assignment_migration/README.md +++ b/cvp/sda_port_assignment_migration/README.md @@ -10,7 +10,7 @@ It uses: The following diagram represents the end-to-end functionality performed by this workflow: -![SDA Port Assignment Migration Workflow](./images/port_assignment_migration_workflow.png) +![SDA Port Assignment Migration Workflow](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_port_assignment_migration/images/port_assignment_migration_workflow.png) ## Input Data Model @@ -89,8 +89,8 @@ source .venv/bin/activate # Upgrade pip tooling python -m pip install --upgrade pip setuptools wheel -# Install Python dependencies (includes ansible and catalystcentersdk) -pip install -r requirements.txt +# Install Cisco Catalyst Center Python SDK +pip install catalystcentersdk # Install/upgrade Cisco Catalyst Center Ansible collection ansible-galaxy collection install cisco.catalystcenter --force diff --git a/cvp/sda_virtual_networks_l2l3_gateways/README.md b/cvp/sda_virtual_networks_l2l3_gateways/README.md index 82743dce2..ab912855e 100644 --- a/cvp/sda_virtual_networks_l2l3_gateways/README.md +++ b/cvp/sda_virtual_networks_l2l3_gateways/README.md @@ -63,7 +63,7 @@ In the context of SDA Fabric Virtual Networks, there are three main components: anchored_site_name: "Global/India" ``` mapping config to UI Actions: - ![alt text](./images/create_l3_anchor.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_virtual_networks_l2l3_gateways/images/create_l3_anchor.png) * Parameter Explanation: ```yaml @@ -85,7 +85,7 @@ In the context of SDA Fabric Virtual Networks, there are three main components: - site_name_hierarchy: "Global/Vietnam" ``` mapping config to UI Actions: - ![alt text](./images/update_l3_anchor.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_virtual_networks_l2l3_gateways/images/update_l3_anchor.png) + Example input config remove all fabric site: ```yaml @@ -129,7 +129,7 @@ In the context of SDA Fabric Virtual Networks, there are three main components: fabric_type: "fabric_site" ``` mapping config to UI Actions: - ![alt text](./images/create_bulk_l3.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_virtual_networks_l2l3_gateways/images/create_bulk_l3.png) \* If we want create parallel layer3, we can use: ```yaml @@ -160,7 +160,7 @@ In the context of SDA Fabric Virtual Networks, there are three main components: - site_name_hierarchy: "Global/dat2" ``` mapping config to UI Actions: - ![alt text](./images/update_bulk_l3.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_virtual_networks_l2l3_gateways/images/update_bulk_l3.png) + Example config for `delete` multiple layer3: ```yaml @@ -174,7 +174,7 @@ In the context of SDA Fabric Virtual Networks, there are three main components: - vn_name: "vn_dat_non_exist" ``` module return message: - ![alt text](./images/delete_layer3_bulk.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_virtual_networks_l2l3_gateways/images/delete_layer3_bulk.png) ### 2. Layer 2 Fabric VLANs #### a. Create layer2 @@ -192,7 +192,7 @@ In the context of SDA Fabric Virtual Networks, there are three main components: traffic_type: "DATA" ``` mapping config to UI Actions: - ![alt text](./images/create_l2.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_virtual_networks_l2l3_gateways/images/create_l2.png) * Parameter Explanation: ```yaml @@ -220,7 +220,7 @@ In the context of SDA Fabric Virtual Networks, there are three main components: fabric_enabled_wireless: true ``` mapping config to UI Actions: - ![alt text](./images/update_l2.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_virtual_networks_l2l3_gateways/images/update_l2.png) + If want to update the assigned fabric zones to empty, need to try deleting Layer 2 with the specified zone: ```yaml @@ -362,7 +362,7 @@ In the context of SDA Fabric Virtual Networks, there are three main components: traffic_type: "DATA" ``` mapping config to UI Actions: - ![alt text](./images/create_anycast_gw.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_virtual_networks_l2l3_gateways/images/create_anycast_gw.png) + Example input config (2): ```yaml @@ -377,7 +377,7 @@ In the context of SDA Fabric Virtual Networks, there are three main components: traffic_type: "DATA" ``` mapping config to UI Actions: - ![alt text](./images/create_anycast_gw_2.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_virtual_networks_l2l3_gateways/images/create_anycast_gw_2.png) * Parameter Explanation: ```yaml @@ -639,7 +639,7 @@ This example can be reused and customized to your requirement and increase the r ``` #### c. UI Action - ![alt text](./images/scale_site_and_fbsite.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_virtual_networks_l2l3_gateways/images/scale_site_and_fbsite.png) ### 2. Create a Scale layer3 and Scale layer2 #### a. JINJA Template @@ -798,7 +798,7 @@ This example can be reused and customized to your requirement and increase the r ``` #### d. UI Action - ![alt text](./images/scale_l2_and_l3.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/sda_virtual_networks_l2l3_gateways/images/scale_l2_and_l3.png) ### 3. Delete a Scale layer3 and Scale layer2 Similar to Create, change the destination playbook to: `./cvp/network_settings/playbook/delete_network_settings_playbook.yml` @@ -915,7 +915,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/site_config_generator/README.md b/cvp/site_config_generator/README.md index 34788840e..3389d800c 100644 --- a/cvp/site_config_generator/README.md +++ b/cvp/site_config_generator/README.md @@ -149,7 +149,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/site_hierarchy/README.md b/cvp/site_hierarchy/README.md index 0e19cb615..62a63ce13 100644 --- a/cvp/site_hierarchy/README.md +++ b/cvp/site_hierarchy/README.md @@ -11,7 +11,7 @@ This playbook enables you to automate the creation, modification, and deletion o - Site deletion and cleanup workflows. Network Hierarchy table, displaying Global, Area, Site, Building, and Floor. -![Alt text](./images/site_image1.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/site_hierarchy/images/site_image1.png) --- @@ -40,7 +40,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -244,10 +244,10 @@ Use the input var file: jinja_template_site_hierarchy_design_vars.yml and specif ### Example of Sites Created Using a Jinja Template Figure 2: Example of a site design created using a Jinja template. -![Alt text](./images/template_created_sites.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/site_hierarchy/images/template_created_sites.png) Figure 3: Example of a site created using a Jinja template, including floor image design. -![Alt text](./images/template_created_floor_image.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/site_hierarchy/images/template_created_floor_image.png) Delete all the sites under a specified hierarchy. diff --git a/cvp/swim/README.md b/cvp/swim/README.md index 932fdddc0..46db9fd29 100644 --- a/cvp/swim/README.md +++ b/cvp/swim/README.md @@ -18,14 +18,11 @@ The SWIM protocol provides a standardized way to manage and upgrade software ima * **Credentials:** Valid login credentials for the switch (username/password or SSH key). * **Software Image:** The desired Cisco IOS XE software image file (.bin). -## Demo Video -[![Device Software Upgrade Demo](./images/swimdemo.png)](http://3.136.0.140/iac_demos/swim/SWIMDEMO.mp4) - # Detailed steps to perform 1. ## Import image: We have three ways to import images into Catalyst Center: -![alt text](./images/import.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/swim/images/import.png) ### a. local Download the image to your local machine and import directly. @@ -89,8 +86,8 @@ We have three ways to import images into Catalyst Center: is_third_party: False ``` Catalyst Center will install in parallel with the two images: 'cat9k_iosxe.17.15.01prd18.SPA.bin' and 'C9800-SW-iosxe-wlc.17.15.01prd18.SPA.bin'. After the import is completed, Catalyst Center will continue to install the image 'C9800-universalk9_wlc.17.15.01prd18.SPA.bin'. - ![alt text](./images/import_parallel_image_1.png) - ![alt text](./images/import_parallel_image_2.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/swim/images/import_parallel_image_1.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/swim/images/import_parallel_image_2.png) ### c. cco Import images prepared for Catalyst Center from Cisco Connection Online. @@ -107,12 +104,12 @@ We have three ways to import images into Catalyst Center: ``` * Note: we can only install the CCO image to be displayed on Catalyst Center. The feature of installing images from CCO has limitations; we can only install images that have been prepared for display on Catalyst Center. - ![alt text](./images/cco_image_suggest.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/swim/images/cco_image_suggest.png) For example, with the above images, we can see some CCO images that are proposed on Catalyst Center (cat9k_iosxe.17.06.08.SPA.bin, cat9k_iosxe.17.09.05.SPA.bin, cat9k_iosxe.17.09.06a.SPA.bin, ...). We can only install CCO type with those proposed images. ### d. Delete image in Cisco Catalyst Center After the image is imported to Catalyst Center using the above methods (local, URL, CCO), it will exist on the Cisco Catalyst Center. We can delete it through the following playbook. - ![alt text](./images/imported_image.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/swim/images/imported_image.png) + Example input config (state: "deleted"): ```yaml swim_details: @@ -129,7 +126,7 @@ We have three ways to import images into Catalyst Center: ``` + The UI display: - ![alt text](./images/deleted_image.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/swim/images/deleted_image.png) **NOTE:The API for deleting images is only supported from Catalyst Center version 2.3.7.9 and above.** @@ -146,7 +143,7 @@ Define and manage golden images that represent standard or preferred versions fo site_name: Global/USA/SAN JOSE tagging: true ``` -![alt text](./images/tag_golden.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/swim/images/tag_golden.png) If you tag a different image with the same device_image_family_name, then the existing image will be untagged first. ```yaml @@ -159,7 +156,7 @@ If you tag a different image with the same device_image_family_name, then the ex site_name: Global/USA/SAN JOSE tagging: true ``` -![alt text](./images/tag_new_golden.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/swim/images/tag_new_golden.png) 3. ## Distribute Distribute the image to the device. In the playbook, we can have two types for distribution: distribute to a specific device (device_e2e) and distribute to multiple devices in parallel using device role and site filters (filter_e2e). @@ -186,7 +183,7 @@ Distribute the image to the device. In the playbook, we can have two types for d device_series_name: Cisco Catalyst 9300 Series Switches ``` UI action (includes distribute and activate): -![alt text](./images/distribute-activate_filter.png) +![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/swim/images/distribute-activate_filter.png) ### c. Distribute & Activate without specifying image name (new enhancement) Automatically uses Golden Image tagged in Catalyst Center. It will satisfy the intersection of the specifications from `image_distribution_details` and `tagging_details`. @@ -230,8 +227,8 @@ Distribute the image to the device. In the playbook, we can have two types for d status: success ``` + The UI display (include activation): - ![alt text](./images/base_and_sub_image.png) - ![alt text](./images/base_and_sub_image_1.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/swim/images/base_and_sub_image.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/swim/images/base_and_sub_image_1.png) **Note:** - We also can only need to provide the base image, or can choose not to provide both the base image and sub-package, and it can still upgrade the image using the image from the golden tag, include base and sub-package image (specifically for the case where `the device to be upgraded is currently running both the base and sub-package images`.) @@ -295,7 +292,7 @@ Activate the image to the device after successful distribution. In the playbook, device_upgrade_mode: currentlyExists: This likely indicates that the activation process will target devices that already have the image in their inventory. ``` UI action (includes distribute and activate): - ![alt text](./images/distribute-activate_filter.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/swim/images/distribute-activate_filter.png) ### c. Distribute & Activate without specifying image name (new enhancement) Automatically uses Golden Image tagged in Catalyst Center. It will satisfy the intersection of the specifications from `image_activation_details` and `tagging_details`. @@ -347,8 +344,8 @@ Activate the image to the device after successful distribution. In the playbook, status: success ``` + The UI display: - ![alt text](./images/base_and_sub_image.png) - ![alt text](./images/base_and_sub_image_1.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/swim/images/base_and_sub_image.png) + ![alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/swim/images/base_and_sub_image_1.png) **Note:** - We also can only need to provide the base image, or can choose not to provide both the base image and sub-package, and it can still upgrade the image using the image from the golden tag, include base and sub-package image (specifically for the case where `the device to be upgraded is currently running both the base and sub-package images`.) @@ -485,7 +482,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/tags_manager/README.md b/cvp/tags_manager/README.md index d42c21b53..d1e644778 100644 --- a/cvp/tags_manager/README.md +++ b/cvp/tags_manager/README.md @@ -38,7 +38,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -162,7 +162,7 @@ The schema file (e.g., `schema/tags_manager_schema.yml`) defines the structure o ## Example Input File The Tags module allows you to create tags and use them to group devices together for easier management. -![Tag UI Page](./images/tag_UI_page.png) +![Tag UI Page](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/tags_manager/images/tag_UI_page.png) Refer to the full workflow specification for detailed instructions on the available options and their structure: https://galaxy.ansible.com/ui/repo/published/cisco/catalystcenter/docs/ @@ -191,7 +191,7 @@ tags_details: - Mapping in the UI: -![Create tag](./images/create_tag.png) +![Create tag](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/tags_manager/images/create_tag.png) #### b. Update Update multiple tags including the statuses: new create, new update, and no change. The module will return detailed messages about their statuses. @@ -225,7 +225,7 @@ tags_details: - Mapping in the UI: -![Update tag](./images/update_tag.png) +![Update tag](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/tags_manager/images/update_tag.png) #### b. Delete @@ -259,7 +259,7 @@ tags_details: - Mapping in the UI: -![Delete tag](./images/delete_tag.png) +![Delete tag](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/tags_manager/images/delete_tag.png) ***Note: If tags have been assigned to a device, a normal delete will not succeed. However, in the module, if we add the option 'force_delete: true', it will include steps to unassign the tags from the device and successfully delete the tags.*** @@ -301,7 +301,7 @@ tags_details: - Mapping in the UI: -![Assign tag to device](./images/assign_tag_to_device.png) +![Assign tag to device](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/tags_manager/images/assign_tag_to_device.png) In addition, we can define the device scope and add a port tag rule to save a port tag rule. @@ -331,7 +331,7 @@ tags_details: - Mapping in the UI: -![port tag rule](./images/port_tag_rule.png) +![port tag rule](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/tags_manager/images/port_tag_rule.png) ***Note: We can unassign a tag using the same input as above, with the state set to `deleted`.*** @@ -367,7 +367,7 @@ tags_details: - Mapping in the UI: -![Assign device to tag](./images/assign_device_to_tag.png) +![Assign device to tag](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/tags_manager/images/assign_device_to_tag.png) ***Note: We can unassign a tag using the same input as above, with the state set to `deleted`.*** @@ -399,7 +399,7 @@ tags_details: - Mapping in the UI: -![force delete tag](./images/force_delete_tag.png) +![force delete tag](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/tags_manager/images/force_delete_tag.png) ### Step 3: Execute the Playbook diff --git a/cvp/template_config_generator/README.md b/cvp/template_config_generator/README.md index 5295f82f0..817fb8037 100644 --- a/cvp/template_config_generator/README.md +++ b/cvp/template_config_generator/README.md @@ -146,7 +146,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/user_role_config_generator/README.md b/cvp/user_role_config_generator/README.md index 3e30a0f4c..0320c08c1 100644 --- a/cvp/user_role_config_generator/README.md +++ b/cvp/user_role_config_generator/README.md @@ -191,7 +191,7 @@ Create and activate a Python virtual environment, then install dependencies: ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ansible-galaxy collection install ansible.utils ``` diff --git a/cvp/users_and_roles/README.md b/cvp/users_and_roles/README.md index 4d78f0f03..4c4a8c767 100644 --- a/cvp/users_and_roles/README.md +++ b/cvp/users_and_roles/README.md @@ -249,13 +249,13 @@ Run the create Playbook Once the users and roles are created, they will be reflected in the Catalyst Center. Figure 1: User mapping with the default and customized roles. -![Alt text](./images/user_roles_mapping.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/users_and_roles/images/user_roles_mapping.png) Figure 2: Customized Role 1 creation with the permissions. -![Alt text](./images/customized_role_permissions1.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/users_and_roles/images/customized_role_permissions1.png) Figure 3: Customized Role 2 creation with the permissions. -![Alt text](./images/customized_role_permissions2.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/users_and_roles/images/customized_role_permissions2.png) ## Run the playbook with password in Ansible vault. Create your password file in the folder: vaulted_passwords/ @@ -387,10 +387,10 @@ roles_users_details: - Assurance-role ``` Figure 4: User associated with roles using Jinja template. -![Alt text](./images/user_with_roles_associated_with_jina_template.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/users_and_roles/images/user_with_roles_associated_with_jina_template.png) Figure 5: Role creation and assigned role to the user with Jinja template. -![Alt text](./images/role_defined_with_jinja_template.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/users_and_roles/images/role_defined_with_jinja_template.png) ### ## Deleting the users and the roles with Jinja template and Vault password ```bash @@ -398,10 +398,10 @@ Figure 5: Role creation and assigned role to the user with Jinja template. ``` Figure 6: User deleted using Jinja template. -![Alt text](./images/Deleted_users_with_jinja_template.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/users_and_roles/images/Deleted_users_with_jinja_template.png) Figure 7: Role deleted using Jinja template. -![Alt text](./images/Deleted_roles_with_jinja_template.png) +![Alt text](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/users_and_roles/images/Deleted_roles_with_jinja_template.png) ## References @@ -438,7 +438,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/wired_campus_automation_config_generator/README.md b/cvp/wired_campus_automation_config_generator/README.md index ff41ecc18..8fbd59c98 100644 --- a/cvp/wired_campus_automation_config_generator/README.md +++ b/cvp/wired_campus_automation_config_generator/README.md @@ -441,7 +441,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/cvp/wireless_design/README.md b/cvp/wireless_design/README.md index 75f4c0476..a33664dde 100644 --- a/cvp/wireless_design/README.md +++ b/cvp/wireless_design/README.md @@ -45,7 +45,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` @@ -195,7 +195,7 @@ The schema file (e.g., `schema/wireless_design_schema.yml`) defines the structur ## Example Input File The Wireless Design module allows you to configure and manage various aspects of your wireless network through Cisco Catalyst Center. The configuration is structured into several key components: -![Wireless Design UI Page](./images/wireless_design.png) +![Wireless Design UI Page](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/wireless_design/images/wireless_design.png) Refer to the full workflow specification for detailed instructions on the available options and their structure: https://galaxy.ansible.com/ui/repo/published/cisco/catalystcenter/docs/ @@ -1181,7 +1181,7 @@ After executing the playbook with the input from `Step 2`, we will receive the o ``` - Mapping in the UI: -![SSID add](./images/ssid_add.png) +![SSID add](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/wireless_design/images/ssid_add.png) ##### `UPDATE/EDIT`: Return the exact message for create (if the SSID did not exist before) and update (if the SSID already existed). @@ -1201,7 +1201,7 @@ Return the exact message for create (if the SSID did not exist before) and updat ``` - Mapping in the UI: -![SSID edit](./images/ssid_edit.png) +![SSID edit](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/wireless_design/images/ssid_edit.png) ##### `DELETE/REMOVE`: Return the exact SSIDs that were actually deleted. @@ -1247,7 +1247,7 @@ Return the exact SSIDs that were actually deleted. ``` - Mapping in the UI: -![Interface add](./images/interface_add.png) +![Interface add](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/wireless_design/images/interface_add.png) ##### `UPDATE/EDIT`: - Terminal return: @@ -1262,7 +1262,7 @@ Return the exact SSIDs that were actually deleted. ``` - Mapping in the UI: -![Interface add](./images/interface_edit.png) +![Interface add](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/wireless_design/images/interface_edit.png) ##### `DELETE/REMOVE`: - Terminal return: @@ -1293,7 +1293,7 @@ Return the exact SSIDs that were actually deleted. ``` - Mapping in the UI: -![Power add](./images/power_add.png) +![Power add](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/wireless_design/images/power_add.png) ##### `UPDATE/EDIT`: - Terminal: @@ -1307,7 +1307,7 @@ Return the exact SSIDs that were actually deleted. ``` - Mapping in the UI: -![Power edit](./images/power_edit.png) +![Power edit](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/wireless_design/images/power_edit.png) ##### `DELETE/REMOVE`: - Terminal: @@ -1342,7 +1342,7 @@ Return the exact SSIDs that were actually deleted. ``` - Mapping in the UI: -![AP profiles add](./images/ap_add.png) +![AP profiles add](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/wireless_design/images/ap_add.png) ##### `UPDATE/EDIT`: - Terminal: @@ -1393,7 +1393,7 @@ Return the exact SSIDs that were actually deleted. ``` - Mapping in the UI: -![RF profiles add](./images/rf_add.png) +![RF profiles add](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/wireless_design/images/rf_add.png) ##### `UPDATE/EDIT`: - Terminal: @@ -1411,7 +1411,7 @@ Return the exact SSIDs that were actually deleted. ``` - Mapping in the UI: -![RF profiles edit](./images/rf_edit.png) +![RF profiles edit](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/wireless_design/images/rf_edit.png) ##### `DELETE/REMOVE`: Return the exact SSIDs that were actually deleted. @@ -1445,7 +1445,7 @@ Return the exact SSIDs that were actually deleted. ``` - Mapping in the UI: -![Anchor Group add](./images/anchor_add.png) +![Anchor Group add](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/cvp/wireless_design/images/anchor_add.png) ##### `UPDATE/EDIT`: - Terminal: diff --git a/cvp/wireless_design_config_generator/README.md b/cvp/wireless_design_config_generator/README.md index 9e80ab12c..ffc194e61 100644 --- a/cvp/wireless_design_config_generator/README.md +++ b/cvp/wireless_design_config_generator/README.md @@ -139,7 +139,7 @@ flowchart TD ```bash python3 -m venv .venv source .venv/bin/activate -pip install -r requirements.txt +pip install catalystcentersdk ansible-galaxy collection install cisco.catalystcenter --force ``` diff --git a/galaxy.yml b/galaxy.yml index fc0109dd5..ff39f0b5c 100644 --- a/galaxy.yml +++ b/galaxy.yml @@ -68,7 +68,6 @@ build_ignore: - Pipfile - Pipfile.lock - - requirements.txt - test-requirements.txt - "*.tar.gz" diff --git a/roles/README.md b/roles/README.md index 82e9ffd2c..6b2a9fcd3 100644 --- a/roles/README.md +++ b/roles/README.md @@ -146,75 +146,75 @@ ansible-playbook example_playbook.yml --ask-vault-pass | Role | Description | README | |------|-------------|--------| -| **site** | Create and manage site hierarchies (areas, buildings, floors) | [📖 Guide](site/README.md) | -| **network_settings** | Configure network settings (DHCP, DNS, NTP, AAA, Banners, Telemetry) | [📖 Guide](network_settings/README.md) | -| **network_profile_switching** | Manage switching network profiles and port templates | [📖 Guide](network_profile_switching/README.md) | -| **network_profile_wireless** | Manage wireless network profiles | [📖 Guide](network_profile_wireless/README.md) | -| **wireless_design** | Configure wireless SSIDs, anchors, and interfaces | [📖 Guide](wireless_design/README.md) | -| **tags** | Manage device tags and groups | [📖 Guide](tags/README.md) | -| **template** | Design and deploy device configuration templates | [📖 Guide](template/README.md) | -| **user_role** | Manage users and RBAC roles | [📖 Guide](user_role/README.md) | +| **site** | Create and manage site hierarchies (areas, buildings, floors) | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/site/README.md) | +| **network_settings** | Configure network settings (DHCP, DNS, NTP, AAA, Banners, Telemetry) | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/network_settings/README.md) | +| **network_profile_switching** | Manage switching network profiles and port templates | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/network_profile_switching/README.md) | +| **network_profile_wireless** | Manage wireless network profiles | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/network_profile_wireless/README.md) | +| **wireless_design** | Configure wireless SSIDs, anchors, and interfaces | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/wireless_design/README.md) | +| **tags** | Manage device tags and groups | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/tags/README.md) | +| **template** | Design and deploy device configuration templates | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/template/README.md) | +| **user_role** | Manage users and RBAC roles | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/user_role/README.md) | ### 🖥️ Device Management | Role | Description | README | |------|-------------|--------| -| **discovery** | Discover network devices using CDP, LLDP, or IP ranges | [📖 Guide](discovery/README.md) | -| **device_credential** | Manage device credentials (CLI, SNMP, HTTP) | [📖 Guide](device_credential/README.md) | -| **inventory** | Manage device inventory and assignments | [📖 Guide](inventory/README.md) | -| **provision** | Provision devices to sites | [📖 Guide](provision/README.md) | -| **pnp** | Plug and Play device onboarding | [📖 Guide](pnp/README.md) | -| **swim** | Software image management and upgrades | [📖 Guide](swim/README.md) | -| **rma** | Device replacement workflows (RMA) | [📖 Guide](rma/README.md) | -| **device_configs_backup** | Backup managed device configurations | [📖 Guide](device_configs_backup/README.md) | -| **network_devices_info** | Network devices information and inventory queries | [📖 Guide](network_devices_info/README.md) | +| **discovery** | Discover network devices using CDP, LLDP, or IP ranges | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/discovery/README.md) | +| **device_credential** | Manage device credentials (CLI, SNMP, HTTP) | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/device_credential/README.md) | +| **inventory** | Manage device inventory and assignments | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/inventory/README.md) | +| **provision** | Provision devices to sites | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/provision/README.md) | +| **pnp** | Plug and Play device onboarding | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/pnp/README.md) | +| **swim** | Software image management and upgrades | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/swim/README.md) | +| **rma** | Device replacement workflows (RMA) | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/rma/README.md) | +| **device_configs_backup** | Backup managed device configurations | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/device_configs_backup/README.md) | +| **network_devices_info** | Network devices information and inventory queries | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/network_devices_info/README.md) | ### 🌐 SDA Fabric | Role | Description | README | |------|-------------|--------| -| **sda_fabric_sites_zones** | Configure SDA fabric sites and zones | [📖 Guide](sda_fabric_sites_zones/README.md) | -| **sda_fabric_transits** | Configure fabric transits and inter-site connectivity | [📖 Guide](sda_fabric_transits/README.md) | -| **sda_fabric_virtual_networks** | Manage virtual networks and L2/L3 gateways | [📖 Guide](sda_fabric_virtual_networks/README.md) | -| **sda_fabric_devices** | Assign fabric device roles (edge, border, control plane) | [📖 Guide](sda_fabric_devices/README.md) | -| **sda_host_port_onboarding** | Onboard hosts to SDA fabric | [📖 Guide](sda_host_port_onboarding/README.md) | -| **sda_fabric_multicast** | Configure multicast settings in SDA fabric | [📖 Guide](sda_fabric_multicast/README.md) | -| **sda_extranet_policies** | Manage extranet policies for inter-VN communication | [📖 Guide](sda_extranet_policies/README.md) | -| **fabric_devices_info** | SDA fabric devices information and inventory queries | [📖 Guide](fabric_devices_info/README.md) | -| **wired_campus_automation** | Wired campus automation workflows | [📖 Guide](wired_campus_automation/README.md) | -| **lan_automation** | LAN automation (underlay) workflows | [📖 Guide](lan_automation/README.md) | +| **sda_fabric_sites_zones** | Configure SDA fabric sites and zones | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/sda_fabric_sites_zones/README.md) | +| **sda_fabric_transits** | Configure fabric transits and inter-site connectivity | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/sda_fabric_transits/README.md) | +| **sda_fabric_virtual_networks** | Manage virtual networks and L2/L3 gateways | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/sda_fabric_virtual_networks/README.md) | +| **sda_fabric_devices** | Assign fabric device roles (edge, border, control plane) | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/sda_fabric_devices/README.md) | +| **sda_host_port_onboarding** | Onboard hosts to SDA fabric | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/sda_host_port_onboarding/README.md) | +| **sda_fabric_multicast** | Configure multicast settings in SDA fabric | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/sda_fabric_multicast/README.md) | +| **sda_extranet_policies** | Manage extranet policies for inter-VN communication | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/sda_extranet_policies/README.md) | +| **fabric_devices_info** | SDA fabric devices information and inventory queries | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/fabric_devices_info/README.md) | +| **wired_campus_automation** | Wired campus automation workflows | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/wired_campus_automation/README.md) | +| **lan_automation** | LAN automation (underlay) workflows | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/lan_automation/README.md) | ### 🔍 Assurance & Monitoring | Role | Description | README | |------|-------------|--------| -| **assurance_issue** | Manage and remediate network assurance issues | [📖 Guide](assurance_issue/README.md) | -| **assurance_icap_settings** | Configure intelligent packet capture (iCAP) | [📖 Guide](assurance_icap_settings/README.md) | -| **assurance_device_health_score_settings** | Configure health score KPI thresholds | [📖 Guide](assurance_device_health_score_settings/README.md) | -| **path_trace** | Run path trace analysis for troubleshooting | [📖 Guide](path_trace/README.md) | +| **assurance_issue** | Manage and remediate network assurance issues | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/assurance_issue/README.md) | +| **assurance_icap_settings** | Configure intelligent packet capture (iCAP) | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/assurance_icap_settings/README.md) | +| **assurance_device_health_score_settings** | Configure health score KPI thresholds | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/assurance_device_health_score_settings/README.md) | +| **path_trace** | Run path trace analysis for troubleshooting | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/path_trace/README.md) | ### 🔐 Security & Integration | Role | Description | README | |------|-------------|--------| -| **ise_radius_integration** | Integrate with Cisco ISE for AAA | [📖 Guide](ise_radius_integration/README.md) | -| **application_policy** | Manage application policies and QoS | [📖 Guide](application_policy/README.md) | +| **ise_radius_integration** | Integrate with Cisco ISE for AAA | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/ise_radius_integration/README.md) | +| **application_policy** | Manage application policies and QoS | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/application_policy/README.md) | ### ⚙️ Operations & Maintenance | Role | Description | README | |------|-------------|--------| -| **backup_and_restore** | Backup and restore Catalyst Center configurations | [📖 Guide](backup_and_restore/README.md) | -| **network_compliance** | Check device compliance against standards | [📖 Guide](network_compliance/README.md) | -| **events_and_notifications** | Manage notification destinations and event subscriptions | [📖 Guide](events_and_notifications/README.md) | -| **reports** | Generate and manage reports | [📖 Guide](reports/README.md) | +| **backup_and_restore** | Backup and restore Catalyst Center configurations | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/backup_and_restore/README.md) | +| **network_compliance** | Check device compliance against standards | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/network_compliance/README.md) | +| **events_and_notifications** | Manage notification destinations and event subscriptions | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/events_and_notifications/README.md) | +| **reports** | Generate and manage reports | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/reports/README.md) | ### 🔧 Access Points | Role | Description | README | |------|-------------|--------| -| **accesspoint** | Configure and provision access points | [📖 Guide](accesspoint/README.md) | -| **accesspoint_location** | Manage AP locations on floor maps | [📖 Guide](accesspoint_location/README.md) | +| **accesspoint** | Configure and provision access points | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/accesspoint/README.md) | +| **accesspoint_location** | Manage AP locations on floor maps | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/accesspoint_location/README.md) | --- @@ -224,36 +224,36 @@ Config-generator roles extract current device/controller configurations and writ | Role | Description | README | |------|-------------|--------| -| **accesspoint_config_generator** | Access Point Config Generator | [📖 Guide](accesspoint_config_generator/README.md) | -| **accesspoint_location_config_generator** | Access Point Location Config Generator | [📖 Guide](accesspoint_location_config_generator/README.md) | -| **application_policy_config_generator** | Application Policy Config Generator | [📖 Guide](application_policy_config_generator/README.md) | -| **assurance_device_health_score_settings_config_generator** | Assurance Device Health Score Settings Config Generator | [📖 Guide](assurance_device_health_score_settings_config_generator/README.md) | -| **assurance_issue_config_generator** | Assurance Issue Config Generator | [📖 Guide](assurance_issue_config_generator/README.md) | -| **backup_and_restore_config_generator** | Backup and Restore Config Generator | [📖 Guide](backup_and_restore_config_generator/README.md) | -| **device_credential_config_generator** | Device Credential Config Generator | [📖 Guide](device_credential_config_generator/README.md) | -| **discovery_config_generator** | Discovery Config Generator | [📖 Guide](discovery_config_generator/README.md) | -| **events_and_notifications_config_generator** | Events and Notifications Config Generator | [📖 Guide](events_and_notifications_config_generator/README.md) | -| **inventory_config_generator** | Inventory Config Generator | [📖 Guide](inventory_config_generator/README.md) | -| **ise_radius_integration_config_generator** | ISE Radius Integration Config Generator | [📖 Guide](ise_radius_integration_config_generator/README.md) | -| **network_profile_switching_config_generator** | Network Profile Switching Config Generator | [📖 Guide](network_profile_switching_config_generator/README.md) | -| **network_profile_wireless_config_generator** | Network Profile Wireless Config Generator | [📖 Guide](network_profile_wireless_config_generator/README.md) | -| **network_settings_config_generator** | Network Settings Config Generator | [📖 Guide](network_settings_config_generator/README.md) | -| **pnp_config_generator** | PnP Config Generator | [📖 Guide](pnp_config_generator/README.md) | -| **provision_config_generator** | Provision Config Generator | [📖 Guide](provision_config_generator/README.md) | -| **rma_config_generator** | RMA Config Generator | [📖 Guide](rma_config_generator/README.md) | -| **sda_extranet_policies_config_generator** | SDA Extranet Policies Config Generator | [📖 Guide](sda_extranet_policies_config_generator/README.md) | -| **sda_fabric_devices_config_generator** | SDA Fabric Devices Config Generator | [📖 Guide](sda_fabric_devices_config_generator/README.md) | -| **sda_fabric_multicast_config_generator** | SDA Fabric Multicast Config Generator | [📖 Guide](sda_fabric_multicast_config_generator/README.md) | -| **sda_fabric_sites_zones_config_generator** | SDA Fabric Sites Zones Config Generator | [📖 Guide](sda_fabric_sites_zones_config_generator/README.md) | -| **sda_fabric_transits_config_generator** | SDA Fabric Transits Config Generator | [📖 Guide](sda_fabric_transits_config_generator/README.md) | -| **sda_fabric_virtual_networks_config_generator** | SDA Fabric Virtual Networks Config Generator | [📖 Guide](sda_fabric_virtual_networks_config_generator/README.md) | -| **sda_host_port_onboarding_config_generator** | SDA Host Port Onboarding Config Generator | [📖 Guide](sda_host_port_onboarding_config_generator/README.md) | -| **site_config_generator** | Site Config Generator | [📖 Guide](site_config_generator/README.md) | -| **tags_config_generator** | Tags Config Generator | [📖 Guide](tags_config_generator/README.md) | -| **template_config_generator** | Template Config Generator | [📖 Guide](template_config_generator/README.md) | -| **user_role_config_generator** | User Role Config Generator | [📖 Guide](user_role_config_generator/README.md) | -| **wired_campus_automation_config_generator** | Wired Campus Automation Config Generator | [📖 Guide](wired_campus_automation_config_generator/README.md) | -| **wireless_design_config_generator** | Wireless Design Config Generator | [📖 Guide](wireless_design_config_generator/README.md) | +| **accesspoint_config_generator** | Access Point Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/accesspoint_config_generator/README.md) | +| **accesspoint_location_config_generator** | Access Point Location Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/accesspoint_location_config_generator/README.md) | +| **application_policy_config_generator** | Application Policy Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/application_policy_config_generator/README.md) | +| **assurance_device_health_score_settings_config_generator** | Assurance Device Health Score Settings Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/assurance_device_health_score_settings_config_generator/README.md) | +| **assurance_issue_config_generator** | Assurance Issue Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/assurance_issue_config_generator/README.md) | +| **backup_and_restore_config_generator** | Backup and Restore Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/backup_and_restore_config_generator/README.md) | +| **device_credential_config_generator** | Device Credential Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/device_credential_config_generator/README.md) | +| **discovery_config_generator** | Discovery Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/discovery_config_generator/README.md) | +| **events_and_notifications_config_generator** | Events and Notifications Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/events_and_notifications_config_generator/README.md) | +| **inventory_config_generator** | Inventory Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/inventory_config_generator/README.md) | +| **ise_radius_integration_config_generator** | ISE Radius Integration Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/ise_radius_integration_config_generator/README.md) | +| **network_profile_switching_config_generator** | Network Profile Switching Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/network_profile_switching_config_generator/README.md) | +| **network_profile_wireless_config_generator** | Network Profile Wireless Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/network_profile_wireless_config_generator/README.md) | +| **network_settings_config_generator** | Network Settings Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/network_settings_config_generator/README.md) | +| **pnp_config_generator** | PnP Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/pnp_config_generator/README.md) | +| **provision_config_generator** | Provision Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/provision_config_generator/README.md) | +| **rma_config_generator** | RMA Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/rma_config_generator/README.md) | +| **sda_extranet_policies_config_generator** | SDA Extranet Policies Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/sda_extranet_policies_config_generator/README.md) | +| **sda_fabric_devices_config_generator** | SDA Fabric Devices Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/sda_fabric_devices_config_generator/README.md) | +| **sda_fabric_multicast_config_generator** | SDA Fabric Multicast Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/sda_fabric_multicast_config_generator/README.md) | +| **sda_fabric_sites_zones_config_generator** | SDA Fabric Sites Zones Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/sda_fabric_sites_zones_config_generator/README.md) | +| **sda_fabric_transits_config_generator** | SDA Fabric Transits Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/sda_fabric_transits_config_generator/README.md) | +| **sda_fabric_virtual_networks_config_generator** | SDA Fabric Virtual Networks Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/sda_fabric_virtual_networks_config_generator/README.md) | +| **sda_host_port_onboarding_config_generator** | SDA Host Port Onboarding Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/sda_host_port_onboarding_config_generator/README.md) | +| **site_config_generator** | Site Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/site_config_generator/README.md) | +| **tags_config_generator** | Tags Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/tags_config_generator/README.md) | +| **template_config_generator** | Template Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/template_config_generator/README.md) | +| **user_role_config_generator** | User Role Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/user_role_config_generator/README.md) | +| **wired_campus_automation_config_generator** | Wired Campus Automation Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/wired_campus_automation_config_generator/README.md) | +| **wireless_design_config_generator** | Wireless Design Config Generator | [📖 Guide](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/roles/wireless_design_config_generator/README.md) | --- @@ -333,9 +333,10 @@ Config-generator roles extract current device/controller configurations and writ ## 📞 Support +- **Automation Hub Support**: For certified content, use `Create issue` from the [Cisco Catalyst Center collection page on Red Hat Automation Hub](https://console.redhat.com/ansible/automation-hub/repo/published/cisco/catalystcenter/). - **Documentation**: [Collection Docs](https://cisco-en-programmability.github.io/catalystcenter-ansible/) -- **Issues**: [GitHub Issues](https://github.com/cisco-en-programmability/catalystcenter-ansible/issues) -- **Full Guide**: [ROLES_GUIDE.md](../ROLES_GUIDE.md) +- **Community Issues**: [GitHub Issues](https://github.com/cisco-en-programmability/catalystcenter-ansible/issues) +- **Full Guide**: [ROLES_GUIDE.md](https://github.com/cisco-en-programmability/catalystcenter-ansible/blob/main/ROLES_GUIDE.md) --- diff --git a/roles/accesspoint/README.md b/roles/accesspoint/README.md index 35bf465a1..7839631ef 100644 --- a/roles/accesspoint/README.md +++ b/roles/accesspoint/README.md @@ -65,8 +65,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Configuretion AP 1](./images/configuretion_ap_1.png) -![Configuretion AP 2](./images/configuretion_ap_2.png) +![Configuretion AP 1](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/accesspoint/images/configuretion_ap_1.png) +![Configuretion AP 2](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/accesspoint/images/configuretion_ap_2.png) ## Adapted Examples diff --git a/roles/accesspoint/meta/main.yml b/roles/accesspoint/meta/main.yml index 2b4d54fa3..eee012b81 100644 --- a/roles/accesspoint/meta/main.yml +++ b/roles/accesspoint/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Access Points company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/accesspoint_config_generator/meta/main.yml b/roles/accesspoint_config_generator/meta/main.yml index 1c235cea3..8dd35015b 100644 --- a/roles/accesspoint_config_generator/meta/main.yml +++ b/roles/accesspoint_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center Access Point playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/accesspoint_location/README.md b/roles/accesspoint_location/README.md index 7166159a0..fed706fe0 100644 --- a/roles/accesspoint_location/README.md +++ b/roles/accesspoint_location/README.md @@ -65,8 +65,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Image1](./images/image1.png) -![Image2](./images/image2.png) +![Image1](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/accesspoint_location/images/image1.png) +![Image2](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/accesspoint_location/images/image2.png) ## Adapted Examples diff --git a/roles/accesspoint_location/meta/main.yml b/roles/accesspoint_location/meta/main.yml index 40a6479e3..6d542ae12 100644 --- a/roles/accesspoint_location/meta/main.yml +++ b/roles/accesspoint_location/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Access Point Location company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/accesspoint_location_config_generator/meta/main.yml b/roles/accesspoint_location_config_generator/meta/main.yml index 0dc529bac..ea005ebf6 100644 --- a/roles/accesspoint_location_config_generator/meta/main.yml +++ b/roles/accesspoint_location_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center Access Point Location playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/application_policy/meta/main.yml b/roles/application_policy/meta/main.yml index 825d4c7d0..65d36d4c7 100644 --- a/roles/application_policy/meta/main.yml +++ b/roles/application_policy/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Application Policies company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/application_policy_config_generator/meta/main.yml b/roles/application_policy_config_generator/meta/main.yml index 1777f4128..30a7b1001 100644 --- a/roles/application_policy_config_generator/meta/main.yml +++ b/roles/application_policy_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center Application Policy playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/assurance_device_health_score_settings/README.md b/roles/assurance_device_health_score_settings/README.md index ab48a4d1e..75e268f25 100644 --- a/roles/assurance_device_health_score_settings/README.md +++ b/roles/assurance_device_health_score_settings/README.md @@ -63,8 +63,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Unified Ap Custom1](./images/Unified_AP_Custom1.png) -![Wired Client Custom](./images/wired_client_custom.png) +![Unified Ap Custom1](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/assurance_device_health_score_settings/images/Unified_AP_Custom1.png) +![Wired Client Custom](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/assurance_device_health_score_settings/images/wired_client_custom.png) ## Adapted Examples diff --git a/roles/assurance_device_health_score_settings/meta/main.yml b/roles/assurance_device_health_score_settings/meta/main.yml index fbc3c6626..572bed565 100644 --- a/roles/assurance_device_health_score_settings/meta/main.yml +++ b/roles/assurance_device_health_score_settings/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Assurance Device Health Score Settings company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/assurance_device_health_score_settings_config_generator/meta/main.yml b/roles/assurance_device_health_score_settings_config_generator/meta/main.yml index 30bfed3b7..ddd2655ae 100644 --- a/roles/assurance_device_health_score_settings_config_generator/meta/main.yml +++ b/roles/assurance_device_health_score_settings_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center Assurance Device Health Score Settings playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/assurance_icap_settings/README.md b/roles/assurance_icap_settings/README.md index 53661d5e0..45e335a47 100644 --- a/roles/assurance_icap_settings/README.md +++ b/roles/assurance_icap_settings/README.md @@ -63,8 +63,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![ICAP Onboarding Capture Page3](./images/icap_onboarding_capture_page3.png) -![ICAP Onboarding Capture Page5](./images/icap_onboarding_capture_page5.png) +![ICAP Onboarding Capture Page3](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/assurance_icap_settings/images/icap_onboarding_capture_page3.png) +![ICAP Onboarding Capture Page5](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/assurance_icap_settings/images/icap_onboarding_capture_page5.png) ## Adapted Examples diff --git a/roles/assurance_icap_settings/meta/main.yml b/roles/assurance_icap_settings/meta/main.yml index 7173dcd7f..ab32e9f64 100644 --- a/roles/assurance_icap_settings/meta/main.yml +++ b/roles/assurance_icap_settings/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Assurance ICAP Settings company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/assurance_issue/README.md b/roles/assurance_issue/README.md index 918106717..18fa154f8 100644 --- a/roles/assurance_issue/README.md +++ b/roles/assurance_issue/README.md @@ -62,8 +62,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![User Def Issue Created](./images/User_def_issue_created.png) -![User Def Issue Updated](./images/User_def_issue_updated.png) +![User Def Issue Created](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/assurance_issue/images/User_def_issue_created.png) +![User Def Issue Updated](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/assurance_issue/images/User_def_issue_updated.png) ## Adapted Examples diff --git a/roles/assurance_issue/meta/main.yml b/roles/assurance_issue/meta/main.yml index 214f1f8bd..678aa19bd 100644 --- a/roles/assurance_issue/meta/main.yml +++ b/roles/assurance_issue/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Assurance Issues company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/assurance_issue_config_generator/meta/main.yml b/roles/assurance_issue_config_generator/meta/main.yml index 61765b1b0..069f7fa4f 100644 --- a/roles/assurance_issue_config_generator/meta/main.yml +++ b/roles/assurance_issue_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center Assurance Issue playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/backup_and_restore/README.md b/roles/backup_and_restore/README.md index 1fcc821c5..fc2c89cdc 100644 --- a/roles/backup_and_restore/README.md +++ b/roles/backup_and_restore/README.md @@ -65,8 +65,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Image](./images/image.png) -![Image-1](./images/image-1.png) +![Image](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/backup_and_restore/images/image.png) +![Image-1](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/backup_and_restore/images/image-1.png) ## Adapted Examples diff --git a/roles/backup_and_restore/meta/main.yml b/roles/backup_and_restore/meta/main.yml index 5f8fe3577..12eac0048 100644 --- a/roles/backup_and_restore/meta/main.yml +++ b/roles/backup_and_restore/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Backup And Restore company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/backup_and_restore_config_generator/meta/main.yml b/roles/backup_and_restore_config_generator/meta/main.yml index b1eef263b..fc21169a0 100644 --- a/roles/backup_and_restore_config_generator/meta/main.yml +++ b/roles/backup_and_restore_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center Backup And Restore playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/device_configs_backup/README.md b/roles/device_configs_backup/README.md index 5e23b1501..d9b7706d7 100644 --- a/roles/device_configs_backup/README.md +++ b/roles/device_configs_backup/README.md @@ -63,8 +63,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Hostname](./images/hostname.png) -![Password](./images/password.png) +![Hostname](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/device_configs_backup/images/hostname.png) +![Password](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/device_configs_backup/images/password.png) ## Adapted Examples diff --git a/roles/device_configs_backup/meta/main.yml b/roles/device_configs_backup/meta/main.yml index e7b6b6f58..bab81f8b8 100644 --- a/roles/device_configs_backup/meta/main.yml +++ b/roles/device_configs_backup/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Device Configuration Backups company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/device_credential/README.md b/roles/device_credential/README.md index d4ca4310b..aee4ff236 100644 --- a/roles/device_credential/README.md +++ b/roles/device_credential/README.md @@ -63,8 +63,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Credential](./images/credential.png) -![Manage Creden](./images/manage_creden.png) +![Credential](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/device_credential/images/credential.png) +![Manage Creden](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/device_credential/images/manage_creden.png) ## Adapted Examples diff --git a/roles/device_credential/meta/main.yml b/roles/device_credential/meta/main.yml index c48822c12..26801eb01 100644 --- a/roles/device_credential/meta/main.yml +++ b/roles/device_credential/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Device Credentials company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/device_credential_config_generator/meta/main.yml b/roles/device_credential_config_generator/meta/main.yml index 754b49cce..88097b58f 100644 --- a/roles/device_credential_config_generator/meta/main.yml +++ b/roles/device_credential_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center Device Credential playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/discovery/README.md b/roles/discovery/README.md index 65d11c118..19497f830 100644 --- a/roles/discovery/README.md +++ b/roles/discovery/README.md @@ -64,8 +64,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Discovery 2](./images/discovery_2.png) -![Discovery 3](./images/discovery_3.png) +![Discovery 2](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/discovery/images/discovery_2.png) +![Discovery 3](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/discovery/images/discovery_3.png) ## Adapted Examples diff --git a/roles/discovery/meta/main.yml b/roles/discovery/meta/main.yml index 4b7d93a89..34e34cc44 100644 --- a/roles/discovery/meta/main.yml +++ b/roles/discovery/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Discovery company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/discovery_config_generator/meta/main.yml b/roles/discovery_config_generator/meta/main.yml index f3702b683..60af1e192 100644 --- a/roles/discovery_config_generator/meta/main.yml +++ b/roles/discovery_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center Discovery playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/events_and_notifications/meta/main.yml b/roles/events_and_notifications/meta/main.yml index c923e9589..c6a96283c 100644 --- a/roles/events_and_notifications/meta/main.yml +++ b/roles/events_and_notifications/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Events and Notifications company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/events_and_notifications_config_generator/meta/main.yml b/roles/events_and_notifications_config_generator/meta/main.yml index b6e4d2e0c..933cf7f03 100644 --- a/roles/events_and_notifications_config_generator/meta/main.yml +++ b/roles/events_and_notifications_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center Events And Notifications playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/fabric_devices_info/README.md b/roles/fabric_devices_info/README.md index 76e17494c..a5910a2fe 100644 --- a/roles/fabric_devices_info/README.md +++ b/roles/fabric_devices_info/README.md @@ -65,7 +65,7 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Example Fabric Device Info](./images/example_fabric_device_info.png) +![Example Fabric Device Info](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/fabric_devices_info/images/example_fabric_device_info.png) ## Adapted Examples diff --git a/roles/fabric_devices_info/meta/main.yml b/roles/fabric_devices_info/meta/main.yml index 8beb773d2..15ef19ac3 100644 --- a/roles/fabric_devices_info/meta/main.yml +++ b/roles/fabric_devices_info/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Fabric Devices Info company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/inventory/meta/main.yml b/roles/inventory/meta/main.yml index 7c3b3af61..aaa4b7408 100644 --- a/roles/inventory/meta/main.yml +++ b/roles/inventory/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Inventory company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/inventory_config_generator/meta/main.yml b/roles/inventory_config_generator/meta/main.yml index 5d43bd1e8..cde34c8d3 100644 --- a/roles/inventory_config_generator/meta/main.yml +++ b/roles/inventory_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center Inventory playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/ise_radius_integration/README.md b/roles/ise_radius_integration/README.md index f7ec438c8..e2f816361 100644 --- a/roles/ise_radius_integration/README.md +++ b/roles/ise_radius_integration/README.md @@ -63,8 +63,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![AAA Full Config](./images/aaa_full_config.png) -![Edit AAA](./images/edit_aaa.png) +![AAA Full Config](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/ise_radius_integration/images/aaa_full_config.png) +![Edit AAA](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/ise_radius_integration/images/edit_aaa.png) ## Adapted Examples diff --git a/roles/ise_radius_integration/meta/main.yml b/roles/ise_radius_integration/meta/main.yml index 7477eac60..9bd328be6 100644 --- a/roles/ise_radius_integration/meta/main.yml +++ b/roles/ise_radius_integration/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center ISE RADIUS Integration company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/ise_radius_integration_config_generator/meta/main.yml b/roles/ise_radius_integration_config_generator/meta/main.yml index 7e64b50b6..eb5f10625 100644 --- a/roles/ise_radius_integration_config_generator/meta/main.yml +++ b/roles/ise_radius_integration_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center ISE Radius Integration playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/lan_automation/README.md b/roles/lan_automation/README.md index 7693477a6..a1c69c8fe 100644 --- a/roles/lan_automation/README.md +++ b/roles/lan_automation/README.md @@ -62,8 +62,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![LAN Automation Prerequisites](./images/LAN-Auto-Prereqs.png) -![LAN Automation Execution Demo](./images/Lan_Automation_demo.png) +![LAN Automation Prerequisites](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/lan_automation/images/LAN-Auto-Prereqs.png) +![LAN Automation Execution Demo](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/lan_automation/images/Lan_Automation_demo.png) ## Adapted Examples diff --git a/roles/lan_automation/meta/main.yml b/roles/lan_automation/meta/main.yml index 1306f6eb0..2dec9481b 100644 --- a/roles/lan_automation/meta/main.yml +++ b/roles/lan_automation/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center LAN Automation company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/network_compliance/README.md b/roles/network_compliance/README.md index 741a44387..1bcdfa210 100644 --- a/roles/network_compliance/README.md +++ b/roles/network_compliance/README.md @@ -62,7 +62,7 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Complian](./images/complian.png) +![Complian](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/network_compliance/images/complian.png) ## Adapted Examples diff --git a/roles/network_compliance/meta/main.yml b/roles/network_compliance/meta/main.yml index a7e10aafe..1fdaebc40 100644 --- a/roles/network_compliance/meta/main.yml +++ b/roles/network_compliance/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Network Compliance company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/network_devices_info/README.md b/roles/network_devices_info/README.md index 1e2a69eac..370c7a110 100644 --- a/roles/network_devices_info/README.md +++ b/roles/network_devices_info/README.md @@ -65,7 +65,7 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Image](./images/image.png) +![Image](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/network_devices_info/images/image.png) ## Adapted Examples diff --git a/roles/network_devices_info/meta/main.yml b/roles/network_devices_info/meta/main.yml index 4227e8141..8bc5affd0 100644 --- a/roles/network_devices_info/meta/main.yml +++ b/roles/network_devices_info/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Network Devices Info company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/network_profile_switching/meta/main.yml b/roles/network_profile_switching/meta/main.yml index cfdf8b1bd..ad3fe6912 100644 --- a/roles/network_profile_switching/meta/main.yml +++ b/roles/network_profile_switching/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Network Profile Switching company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/network_profile_switching_config_generator/meta/main.yml b/roles/network_profile_switching_config_generator/meta/main.yml index 2a1f7900f..57f849b00 100644 --- a/roles/network_profile_switching_config_generator/meta/main.yml +++ b/roles/network_profile_switching_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center Network Profile Switching playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/network_profile_wireless/README.md b/roles/network_profile_wireless/README.md index f524f2071..178bb893e 100644 --- a/roles/network_profile_wireless/README.md +++ b/roles/network_profile_wireless/README.md @@ -62,8 +62,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Feature Template With Aaa Configuration](./images/feature_template_with_AAA_configuration.png) -![Feature Template With Aaa Configuration 2](./images/feature_template_with_AAA_configuration_2.png) +![Feature Template With Aaa Configuration](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/network_profile_wireless/images/feature_template_with_AAA_configuration.png) +![Feature Template With Aaa Configuration 2](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/network_profile_wireless/images/feature_template_with_AAA_configuration_2.png) ## Adapted Examples diff --git a/roles/network_profile_wireless/meta/main.yml b/roles/network_profile_wireless/meta/main.yml index b3780b421..7cb090a2f 100644 --- a/roles/network_profile_wireless/meta/main.yml +++ b/roles/network_profile_wireless/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Network Profile Wireless company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/network_profile_wireless_config_generator/meta/main.yml b/roles/network_profile_wireless_config_generator/meta/main.yml index a990495e3..e6e0c325e 100644 --- a/roles/network_profile_wireless_config_generator/meta/main.yml +++ b/roles/network_profile_wireless_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center Network Profile Wireless playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/network_settings/README.md b/roles/network_settings/README.md index ba1b57aab..61f96b35c 100644 --- a/roles/network_settings/README.md +++ b/roles/network_settings/README.md @@ -63,8 +63,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![AAA Config 1](./images/aaa_1.png) -![AAA Config 1.1](./images/aaa_1.1.png) +![AAA Config 1](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/network_settings/images/aaa_1.png) +![AAA Config 1.1](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/network_settings/images/aaa_1.1.png) ## Adapted Examples diff --git a/roles/network_settings/meta/main.yml b/roles/network_settings/meta/main.yml index 70fe1bc7c..7145d326e 100644 --- a/roles/network_settings/meta/main.yml +++ b/roles/network_settings/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Network Settings company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/network_settings_config_generator/meta/main.yml b/roles/network_settings_config_generator/meta/main.yml index 168b61dc8..0cea26dee 100644 --- a/roles/network_settings_config_generator/meta/main.yml +++ b/roles/network_settings_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center Network Settings playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/path_trace/README.md b/roles/path_trace/README.md index be375f2eb..a6e55577f 100644 --- a/roles/path_trace/README.md +++ b/roles/path_trace/README.md @@ -63,7 +63,7 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Create Path Trace](./images/create_path_trace.png) +![Create Path Trace](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/path_trace/images/create_path_trace.png) ## Adapted Examples diff --git a/roles/path_trace/meta/main.yml b/roles/path_trace/meta/main.yml index 6ba0326f0..45003d8b5 100644 --- a/roles/path_trace/meta/main.yml +++ b/roles/path_trace/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Path Trace company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/pnp/meta/main.yml b/roles/pnp/meta/main.yml index b86cb2aec..573f982b7 100644 --- a/roles/pnp/meta/main.yml +++ b/roles/pnp/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Plug and Play (PnP) company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/pnp_config_generator/meta/main.yml b/roles/pnp_config_generator/meta/main.yml index f6542e6e9..dc32820d1 100644 --- a/roles/pnp_config_generator/meta/main.yml +++ b/roles/pnp_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center PnP playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/provision/README.md b/roles/provision/README.md index a26cc24d1..edfb54ac6 100644 --- a/roles/provision/README.md +++ b/roles/provision/README.md @@ -64,8 +64,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Nw Profile](./images/nw_profile.png) -![Nw Profile Feature Template](./images/nw_profile_feature_template.png) +![Nw Profile](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/provision/images/nw_profile.png) +![Nw Profile Feature Template](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/provision/images/nw_profile_feature_template.png) ## Adapted Examples diff --git a/roles/provision/meta/main.yml b/roles/provision/meta/main.yml index 624cc95e6..f85142af2 100644 --- a/roles/provision/meta/main.yml +++ b/roles/provision/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Device Provisioning company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/provision_config_generator/meta/main.yml b/roles/provision_config_generator/meta/main.yml index 9e94026c7..8774a33f6 100644 --- a/roles/provision_config_generator/meta/main.yml +++ b/roles/provision_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center Provision playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/reports/README.md b/roles/reports/README.md index a28c8f3c9..dec1d7509 100644 --- a/roles/reports/README.md +++ b/roles/reports/README.md @@ -66,8 +66,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Image1](./images/image1.png) -![Image](./images/image.png) +![Image1](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/reports/images/image1.png) +![Image](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/reports/images/image.png) ## Adapted Examples diff --git a/roles/reports/meta/main.yml b/roles/reports/meta/main.yml index 884d35cbf..e6f850d2e 100644 --- a/roles/reports/meta/main.yml +++ b/roles/reports/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Reports company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/rma/README.md b/roles/rma/README.md index 0102757c8..9c580da07 100644 --- a/roles/rma/README.md +++ b/roles/rma/README.md @@ -69,8 +69,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Mark Device Replacement](./images/mark_device_replacement.png) -![Replacement](./images/replacement.png) +![Mark Device Replacement](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/rma/images/mark_device_replacement.png) +![Replacement](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/rma/images/replacement.png) ## Adapted Examples diff --git a/roles/rma/meta/main.yml b/roles/rma/meta/main.yml index 95d5aca04..90e74d864 100644 --- a/roles/rma/meta/main.yml +++ b/roles/rma/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center RMA (Return Merchandise Authorization) company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/rma_config_generator/meta/main.yml b/roles/rma_config_generator/meta/main.yml index 1aa9b93b1..d202d26d0 100644 --- a/roles/rma_config_generator/meta/main.yml +++ b/roles/rma_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center RMA playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/sda_extranet_policies/README.md b/roles/sda_extranet_policies/README.md index 4eff4d455..f130f0eaa 100644 --- a/roles/sda_extranet_policies/README.md +++ b/roles/sda_extranet_policies/README.md @@ -62,8 +62,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Ext1](./images/ext1.png) -![Ext2](./images/ext2.png) +![Ext1](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/sda_extranet_policies/images/ext1.png) +![Ext2](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/sda_extranet_policies/images/ext2.png) ## Adapted Examples diff --git a/roles/sda_extranet_policies/meta/main.yml b/roles/sda_extranet_policies/meta/main.yml index 4af80e264..f0cf0cb13 100644 --- a/roles/sda_extranet_policies/meta/main.yml +++ b/roles/sda_extranet_policies/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center SDA Extranet Policies company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/sda_extranet_policies_config_generator/meta/main.yml b/roles/sda_extranet_policies_config_generator/meta/main.yml index 4cfccc7d1..038575ded 100644 --- a/roles/sda_extranet_policies_config_generator/meta/main.yml +++ b/roles/sda_extranet_policies_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center SDA Extranet Policies playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/sda_fabric_devices/README.md b/roles/sda_fabric_devices/README.md index deebb654d..12c2a9876 100644 --- a/roles/sda_fabric_devices/README.md +++ b/roles/sda_fabric_devices/README.md @@ -63,8 +63,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Select-device-in-fabric](./images/Select-Device-in-Fabric.png) -![Add-control-plane](./images/Add-Control-Plane.png) +![Select-device-in-fabric](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/sda_fabric_devices/images/Select-Device-in-Fabric.png) +![Add-control-plane](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/sda_fabric_devices/images/Add-Control-Plane.png) ## Adapted Examples diff --git a/roles/sda_fabric_devices/meta/main.yml b/roles/sda_fabric_devices/meta/main.yml index b7423de19..e6089f64c 100644 --- a/roles/sda_fabric_devices/meta/main.yml +++ b/roles/sda_fabric_devices/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center SDA Fabric Devices company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/sda_fabric_devices_config_generator/meta/main.yml b/roles/sda_fabric_devices_config_generator/meta/main.yml index 5e2f6933a..f9faeb8ea 100644 --- a/roles/sda_fabric_devices_config_generator/meta/main.yml +++ b/roles/sda_fabric_devices_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center SDA Fabric Devices playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/sda_fabric_multicast/README.md b/roles/sda_fabric_multicast/README.md index 5dadcaa39..cc497f656 100644 --- a/roles/sda_fabric_multicast/README.md +++ b/roles/sda_fabric_multicast/README.md @@ -62,8 +62,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Update SDA Multicasts Example](./images/update_sda_multicast.png) -![Delete SDA Multicasts Example](./images/delete_sda_multicast.png) +![Update SDA Multicasts Example](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/sda_fabric_multicast/images/update_sda_multicast.png) +![Delete SDA Multicasts Example](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/sda_fabric_multicast/images/delete_sda_multicast.png) ## Adapted Examples diff --git a/roles/sda_fabric_multicast/meta/main.yml b/roles/sda_fabric_multicast/meta/main.yml index ddd7fd676..8f280fd00 100644 --- a/roles/sda_fabric_multicast/meta/main.yml +++ b/roles/sda_fabric_multicast/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center SDA Fabric Multicast company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/sda_fabric_multicast_config_generator/meta/main.yml b/roles/sda_fabric_multicast_config_generator/meta/main.yml index 6c8b756a8..53863b4a1 100644 --- a/roles/sda_fabric_multicast_config_generator/meta/main.yml +++ b/roles/sda_fabric_multicast_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center SDA Fabric Multicast playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/sda_fabric_sites_zones/README.md b/roles/sda_fabric_sites_zones/README.md index 8e4c95348..22b31aec6 100644 --- a/roles/sda_fabric_sites_zones/README.md +++ b/roles/sda_fabric_sites_zones/README.md @@ -63,8 +63,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Fabric Sites](./images/Fabric_sites.png) -![Fabric Site Auth Profile](./images/Fabric_site_auth_profile.png) +![Fabric Sites](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/sda_fabric_sites_zones/images/Fabric_sites.png) +![Fabric Site Auth Profile](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/sda_fabric_sites_zones/images/Fabric_site_auth_profile.png) ## Adapted Examples diff --git a/roles/sda_fabric_sites_zones/meta/main.yml b/roles/sda_fabric_sites_zones/meta/main.yml index 8ed4eb54e..a2d9359cf 100644 --- a/roles/sda_fabric_sites_zones/meta/main.yml +++ b/roles/sda_fabric_sites_zones/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center SDA Fabric Sites and Zones company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/sda_fabric_sites_zones_config_generator/meta/main.yml b/roles/sda_fabric_sites_zones_config_generator/meta/main.yml index a49c515b8..1b1ebf327 100644 --- a/roles/sda_fabric_sites_zones_config_generator/meta/main.yml +++ b/roles/sda_fabric_sites_zones_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center SDA Fabric Sites Zones playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/sda_fabric_transits/README.md b/roles/sda_fabric_transits/README.md index 645b6ecbd..df31f7d16 100644 --- a/roles/sda_fabric_transits/README.md +++ b/roles/sda_fabric_transits/README.md @@ -63,8 +63,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Image-3](./images/image-3.png) -![Fabric transit configuration in Cisco Catalyst Center UI](./images/image-1.png) +![Image-3](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/sda_fabric_transits/images/image-3.png) +![Fabric transit configuration in Cisco Catalyst Center UI](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/sda_fabric_transits/images/image-1.png) ## Adapted Examples diff --git a/roles/sda_fabric_transits/meta/main.yml b/roles/sda_fabric_transits/meta/main.yml index d4d3d1702..f0836e841 100644 --- a/roles/sda_fabric_transits/meta/main.yml +++ b/roles/sda_fabric_transits/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center SDA Fabric Transits company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/sda_fabric_transits_config_generator/meta/main.yml b/roles/sda_fabric_transits_config_generator/meta/main.yml index aa2402baf..d538e2889 100644 --- a/roles/sda_fabric_transits_config_generator/meta/main.yml +++ b/roles/sda_fabric_transits_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center SDA Fabric Transits playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/sda_fabric_virtual_networks/README.md b/roles/sda_fabric_virtual_networks/README.md index 895d8543f..64a746b14 100644 --- a/roles/sda_fabric_virtual_networks/README.md +++ b/roles/sda_fabric_virtual_networks/README.md @@ -64,8 +64,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Create L3 Anchor](./images/create_l3_anchor.png) -![Update L3 Anchor](./images/update_l3_anchor.png) +![Create L3 Anchor](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/sda_fabric_virtual_networks/images/create_l3_anchor.png) +![Update L3 Anchor](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/sda_fabric_virtual_networks/images/update_l3_anchor.png) ## Adapted Examples diff --git a/roles/sda_fabric_virtual_networks/meta/main.yml b/roles/sda_fabric_virtual_networks/meta/main.yml index 53cdb2662..713d592ad 100644 --- a/roles/sda_fabric_virtual_networks/meta/main.yml +++ b/roles/sda_fabric_virtual_networks/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center SDA Fabric Virtual Networks company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/sda_fabric_virtual_networks_config_generator/meta/main.yml b/roles/sda_fabric_virtual_networks_config_generator/meta/main.yml index 32950fa34..13516a279 100644 --- a/roles/sda_fabric_virtual_networks_config_generator/meta/main.yml +++ b/roles/sda_fabric_virtual_networks_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center SDA Fabric Virtual Networks playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/sda_host_port_onboarding/README.md b/roles/sda_host_port_onboarding/README.md index f03d1b108..6e131710c 100644 --- a/roles/sda_host_port_onboarding/README.md +++ b/roles/sda_host_port_onboarding/README.md @@ -63,8 +63,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Host Onboarding](./images/host_onboarding.png) -![Port-assign](./images/port-assign.png) +![Host Onboarding](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/sda_host_port_onboarding/images/host_onboarding.png) +![Port-assign](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/sda_host_port_onboarding/images/port-assign.png) ## Adapted Examples diff --git a/roles/sda_host_port_onboarding/meta/main.yml b/roles/sda_host_port_onboarding/meta/main.yml index 2df5f608c..f45c4803a 100644 --- a/roles/sda_host_port_onboarding/meta/main.yml +++ b/roles/sda_host_port_onboarding/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center SDA Host Port Onboarding company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/sda_host_port_onboarding_config_generator/meta/main.yml b/roles/sda_host_port_onboarding_config_generator/meta/main.yml index e7d3b13b0..7c5e100c3 100644 --- a/roles/sda_host_port_onboarding_config_generator/meta/main.yml +++ b/roles/sda_host_port_onboarding_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center SDA Host Port Onboarding playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/site/README.md b/roles/site/README.md index f692cf37e..a0bdf62cb 100644 --- a/roles/site/README.md +++ b/roles/site/README.md @@ -66,8 +66,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Site Image1](./images/site_image1.png) -![Template Created Sites](./images/template_created_sites.png) +![Site Image1](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/site/images/site_image1.png) +![Template Created Sites](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/site/images/template_created_sites.png) ## Adapted Examples diff --git a/roles/site/meta/main.yml b/roles/site/meta/main.yml index c8028c61f..d7cc01a0f 100644 --- a/roles/site/meta/main.yml +++ b/roles/site/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Sites company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/site_config_generator/meta/main.yml b/roles/site_config_generator/meta/main.yml index ca8fdaa8f..20513b4bb 100644 --- a/roles/site_config_generator/meta/main.yml +++ b/roles/site_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center Site playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/swim/README.md b/roles/swim/README.md index 5efb84e42..786508b98 100644 --- a/roles/swim/README.md +++ b/roles/swim/README.md @@ -63,8 +63,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Device Software Upgrade Demo](./images/swimdemo.png) -![Import](./images/import.png) +![Device Software Upgrade Demo](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/swim/images/swimdemo.png) +![Import](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/swim/images/import.png) ## Adapted Examples diff --git a/roles/swim/meta/main.yml b/roles/swim/meta/main.yml index 8f290d6f9..67bcf23a4 100644 --- a/roles/swim/meta/main.yml +++ b/roles/swim/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Software Image Management (SWIM) company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/tags/README.md b/roles/tags/README.md index 1424555f2..1b60a818f 100644 --- a/roles/tags/README.md +++ b/roles/tags/README.md @@ -63,8 +63,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Tag UI Page](./images/tag_UI_page.png) -![Create tag](./images/create_tag.png) +![Tag UI Page](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/tags/images/tag_UI_page.png) +![Create tag](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/tags/images/create_tag.png) ## Adapted Examples diff --git a/roles/tags/meta/main.yml b/roles/tags/meta/main.yml index bb0b5bfd0..b8132ac84 100644 --- a/roles/tags/meta/main.yml +++ b/roles/tags/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Tags company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/tags_config_generator/meta/main.yml b/roles/tags_config_generator/meta/main.yml index e72abd896..d73f24dec 100644 --- a/roles/tags_config_generator/meta/main.yml +++ b/roles/tags_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center Tags playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/template/README.md b/roles/template/README.md index 600333fdd..1763f1761 100644 --- a/roles/template/README.md +++ b/roles/template/README.md @@ -62,8 +62,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Create0](./images/create0.png) -![Template1](./images/template1.png) +![Create0](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/template/images/create0.png) +![Template1](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/template/images/template1.png) ## Adapted Examples diff --git a/roles/template/meta/main.yml b/roles/template/meta/main.yml index 94185b68b..41f48cd2c 100644 --- a/roles/template/meta/main.yml +++ b/roles/template/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Templates company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/template_config_generator/meta/main.yml b/roles/template_config_generator/meta/main.yml index 5c2c4e99a..5810255d8 100644 --- a/roles/template_config_generator/meta/main.yml +++ b/roles/template_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center Template playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/user_role/README.md b/roles/user_role/README.md index 0455a20c6..d52dc1201 100644 --- a/roles/user_role/README.md +++ b/roles/user_role/README.md @@ -64,8 +64,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![User Roles Mapping](./images/user_roles_mapping.png) -![Customized Role Permissions1](./images/customized_role_permissions1.png) +![User Roles Mapping](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/user_role/images/user_roles_mapping.png) +![Customized Role Permissions1](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/user_role/images/customized_role_permissions1.png) ## Adapted Examples diff --git a/roles/user_role/meta/main.yml b/roles/user_role/meta/main.yml index f215a93ed..8bd39a901 100644 --- a/roles/user_role/meta/main.yml +++ b/roles/user_role/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center User Roles company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/user_role_config_generator/meta/main.yml b/roles/user_role_config_generator/meta/main.yml index 09fd4358a..ec8322e37 100644 --- a/roles/user_role_config_generator/meta/main.yml +++ b/roles/user_role_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center User Role playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/wired_campus_automation/meta/main.yml b/roles/wired_campus_automation/meta/main.yml index ab1af77ce..9e23169b2 100644 --- a/roles/wired_campus_automation/meta/main.yml +++ b/roles/wired_campus_automation/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Wired Campus Automation company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/wired_campus_automation_config_generator/meta/main.yml b/roles/wired_campus_automation_config_generator/meta/main.yml index b62b97e2f..fde60e776 100644 --- a/roles/wired_campus_automation_config_generator/meta/main.yml +++ b/roles/wired_campus_automation_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center Wired Campus Automation playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/wireless_design/README.md b/roles/wireless_design/README.md index 7741ed8d4..4180f4b6c 100644 --- a/roles/wireless_design/README.md +++ b/roles/wireless_design/README.md @@ -45,8 +45,8 @@ These examples are adapted from the workflow documentation and example assets in ## Visual Reference The following image is copied from the workflow documentation to help map the role inputs to the Catalyst Center UI or expected output. -![Wireless Design UI Page](./images/wireless_design.png) -![SSID add](./images/ssid_add.png) +![Wireless Design UI Page](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/wireless_design/images/wireless_design.png) +![SSID add](https://raw.githubusercontent.com/cisco-en-programmability/catalystcenter-ansible/main/roles/wireless_design/images/ssid_add.png) ## Adapted Examples diff --git a/roles/wireless_design/meta/main.yml b/roles/wireless_design/meta/main.yml index c8de60aa7..07a9c067e 100644 --- a/roles/wireless_design/meta/main.yml +++ b/roles/wireless_design/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for managing Catalyst Center Wireless Design company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: diff --git a/roles/wireless_design_config_generator/meta/main.yml b/roles/wireless_design_config_generator/meta/main.yml index 34473b93b..912f265f0 100644 --- a/roles/wireless_design_config_generator/meta/main.yml +++ b/roles/wireless_design_config_generator/meta/main.yml @@ -4,7 +4,7 @@ galaxy_info: description: Ansible role for generating Catalyst Center Wireless Design playbook inputs company: Cisco Systems license: GPL-3.0-or-later - min_ansible_version: "2.14" + min_ansible_version: "2.16" platforms: - name: Any versions: