initial commit
This commit is contained in:
Kosta Mushkin
@@ -0,0 +1,262 @@
|
||||
# Legal Disclaimer
|
||||
# This script is an example script and is not supported under any Zerto support program or service.
|
||||
# The author and Zerto further disclaim all implied warranties including, without limitation,
|
||||
# any implied warranties of merchantability or of fitness for a particular purpose.
|
||||
# In no event shall Zerto, its authors or anyone else involved in the creation,
|
||||
# production or delivery of the scripts be liable for any damages whatsoever (including,
|
||||
# without limitation, damages for loss of business profits, business interruption, loss of business
|
||||
# information, or other pecuniary loss) arising out of the use of or the inability to use the sample
|
||||
# scripts or documentation, even if the author or Zerto has been advised of the possibility of such damages.
|
||||
# The entire risk arising out of the use or performance of the sample scripts and documentation remains with you.
|
||||
|
||||
"""
|
||||
Zerto Virtual Replication Appliance (VRA) Management Example Script
|
||||
|
||||
This script demonstrates how to manage VRAs using the Zerto Virtual Manager (ZVM) API.
|
||||
It showcases VRA deployment, configuration, and cleanup operations.
|
||||
|
||||
Key Features:
|
||||
1. VRA Management:
|
||||
- List existing VRAs and their details
|
||||
- Delete existing VRAs
|
||||
- Deploy new VRAs with custom configurations
|
||||
- Monitor VRA deployment status
|
||||
|
||||
2. Resource Selection:
|
||||
- Interactive selection of hosts
|
||||
- Interactive selection of datastores
|
||||
- Interactive selection of networks
|
||||
- Custom IP configuration for VRAs
|
||||
|
||||
3. Parallel Operations:
|
||||
- Deploy multiple VRAs simultaneously
|
||||
- Delete multiple VRAs in parallel
|
||||
- Monitor multiple VRA operations
|
||||
|
||||
Required Arguments:
|
||||
--zvm_address: ZVM server address
|
||||
--client_id: Keycloak client ID
|
||||
--client_secret: Keycloak client secret
|
||||
--ignore_ssl: Ignore SSL certificate verification (optional)
|
||||
|
||||
Example Usage:
|
||||
python examples/vras_example.py \
|
||||
--zvm_address "192.168.111.20" \
|
||||
--client_id "zerto-api" \
|
||||
--client_secret "your-secret-here" \
|
||||
--ignore_ssl
|
||||
|
||||
Script Flow:
|
||||
1. Lists all existing VRAs and their details
|
||||
2. Optionally deletes all existing VRAs
|
||||
3. Creates new VRAs with user-selected resources:
|
||||
- First VRA with IP 192.168.111.30
|
||||
- Second VRA with IP 192.168.111.31 (optional)
|
||||
4. Verifies final VRA configuration
|
||||
|
||||
Note: This script includes interactive prompts for resource selection and operation
|
||||
confirmation. It demonstrates proper error handling and logging for VRA management
|
||||
operations.
|
||||
"""
|
||||
|
||||
#!/usr/bin/python3
|
||||
import argparse
|
||||
import logging
|
||||
# logging.basicConfig(level=logging.DEBUG)
|
||||
import urllib3
|
||||
import json
|
||||
import sys
|
||||
import os
|
||||
import time
|
||||
from typing import Dict, List
|
||||
sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
|
||||
from zvml import ZVMLClient
|
||||
|
||||
# Disable SSL warnings
|
||||
urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)
|
||||
|
||||
def setup_client(args):
|
||||
"""Initialize and return Zerto client"""
|
||||
client = ZVMLClient(
|
||||
zvm_address=args.zvm_address,
|
||||
client_id=args.client_id,
|
||||
client_secret=args.client_secret,
|
||||
verify_certificate=not args.ignore_ssl
|
||||
)
|
||||
return client
|
||||
|
||||
def get_user_confirmation(prompt: str) -> bool:
|
||||
"""Get user confirmation for an action"""
|
||||
while True:
|
||||
response = input(f"\n{prompt} (yes/no): ").lower().strip()
|
||||
if response in ['yes', 'y']:
|
||||
return True
|
||||
if response in ['no', 'n']:
|
||||
return False
|
||||
print("Please answer 'yes' or 'no'")
|
||||
|
||||
def select_from_list(items, item_type: str):
|
||||
"""Let user select an item from a list"""
|
||||
logging.info(f"select_from_list: {json.dumps(items, indent=2)}")
|
||||
print(f"\nAvailable {item_type}s:")
|
||||
for idx, item in enumerate(items, 1):
|
||||
if 'VirtualizationHostName' in item: # For hosts
|
||||
print(f"{idx}. {item['VirtualizationHostName']} ({item['HostIdentifier']})")
|
||||
elif 'DatastoreName' in item: # For datastores
|
||||
print(f"{idx}. {item['DatastoreName']} ({item['DatastoreIdentifier']})")
|
||||
elif 'VirtualizationNetworkName' in item: # For networks
|
||||
print(f"{idx}. {item['VirtualizationNetworkName']} ({item['NetworkIdentifier']})")
|
||||
|
||||
while True:
|
||||
try:
|
||||
choice = int(input(f"\nSelect {item_type} (1-{len(items)}): "))
|
||||
if 1 <= choice <= len(items):
|
||||
return items[choice - 1]
|
||||
except ValueError:
|
||||
pass
|
||||
print(f"Please enter a number between 1 and {len(items)}")
|
||||
|
||||
def list_vras(client: ZVMLClient):
|
||||
"""List all VRAs and their details"""
|
||||
vras = client.vras.list_vras()
|
||||
print(f"\nFound {len(vras)} VRAs:")
|
||||
for vra in vras:
|
||||
print(f"\nVRA Details:")
|
||||
print(f" Name: {vra.get('VraName')}")
|
||||
print(f" Status: {vra.get('Status')}")
|
||||
print(f" IP Address: {vra.get('IpAddress')}")
|
||||
print(f" Version: {vra.get('VraVersion')}")
|
||||
print(f" Host: {vra.get('HostName')}")
|
||||
|
||||
def create_vra_with_selection(client: ZVMLClient, vra_number: int) -> Dict:
|
||||
"""Create a VRA with user-selected resources"""
|
||||
# Get local site information
|
||||
local_site = client.localsite.get_local_site()
|
||||
site_id = local_site['SiteIdentifier']
|
||||
|
||||
# Get available resources for the local site
|
||||
print("\nRetrieving available resources...")
|
||||
hosts = client.virtualization_sites.get_virtualization_site_hosts(site_id)
|
||||
if not hosts:
|
||||
raise ValueError("No hosts found in local site")
|
||||
|
||||
datastores = client.virtualization_sites.get_virtualization_site_datastores(site_id)
|
||||
if not datastores:
|
||||
raise ValueError("No datastores found in local site")
|
||||
|
||||
networks = client.virtualization_sites.get_virtualization_site_networks(site_id)
|
||||
if not networks:
|
||||
raise ValueError("No networks found in local site")
|
||||
|
||||
# Let user select resources
|
||||
print("\nSelect resources for VRA deployment:")
|
||||
host = select_from_list(hosts, "Host")
|
||||
datastore = select_from_list(datastores, "Datastore")
|
||||
network = select_from_list(networks, "Network")
|
||||
|
||||
while True:
|
||||
# Let user customize IP address
|
||||
default_ip = f"192.168.111.{30 + vra_number - 1}"
|
||||
custom_ip = input(f"\nEnter VRA IP address (press Enter to use default {default_ip}): ").strip()
|
||||
vra_ip = custom_ip if custom_ip else default_ip
|
||||
|
||||
# Create VRA configuration
|
||||
vra_config = {
|
||||
"hostIdentifier": host['HostIdentifier'],
|
||||
"datastoreIdentifier": datastore['DatastoreIdentifier'],
|
||||
"networkIdentifier": network['NetworkIdentifier'],
|
||||
"hostRootPassword": input("\nEnter host root password: "),
|
||||
"memoryInGb": 3,
|
||||
"groupName": f"VRA_Group{vra_number}",
|
||||
"vraNetworkDataApi": {
|
||||
"vraIPConfigurationTypeApi": "Static",
|
||||
"vraIPAddress": vra_ip,
|
||||
"vraIPAddressRangeEnd": "",
|
||||
"subnetMask": "255.255.255.0",
|
||||
"defaultGateway": "192.168.111.254"
|
||||
},
|
||||
"usePublicKeyInsteadOfCredentials": False,
|
||||
"populatePostInstallation": True,
|
||||
"numOfCpus": 1,
|
||||
"vmInstanceType": ""
|
||||
}
|
||||
|
||||
# Create VRA
|
||||
print(f"\nCreating VRA {vra_number} with configuration:")
|
||||
print(json.dumps(vra_config, indent=2))
|
||||
|
||||
response = input("\nProceed with VRA creation? (yes/no/edit): ").lower().strip()
|
||||
if response in ['yes', 'y']:
|
||||
result = client.vras.create_vra(vra_config)
|
||||
print(f"VRA creation initiated: {json.dumps(result, indent=2)}")
|
||||
return result
|
||||
elif response in ['no', 'n']:
|
||||
return None
|
||||
elif response in ['edit', 'e']:
|
||||
print("\nRestarting VRA configuration...")
|
||||
continue
|
||||
else:
|
||||
print("Please answer 'yes', 'no', or 'edit'")
|
||||
|
||||
def main():
|
||||
parser = argparse.ArgumentParser(description="VRA Management Example")
|
||||
parser.add_argument("--zvm_address", required=True, help="ZVM address")
|
||||
parser.add_argument('--client_id', required=True, help='Keycloak client ID')
|
||||
parser.add_argument('--client_secret', required=True, help='Keycloak client secret')
|
||||
parser.add_argument("--ignore_ssl", action="store_true", help="Ignore SSL certificate verification")
|
||||
args = parser.parse_args()
|
||||
|
||||
# Configure logging
|
||||
logging.basicConfig(
|
||||
level=logging.INFO,
|
||||
format='%(asctime)s - %(levelname)s - %(message)s'
|
||||
)
|
||||
|
||||
try:
|
||||
# Setup client
|
||||
client = setup_client(args)
|
||||
|
||||
# Step 1: List existing VRAs
|
||||
print("\nStep 1: Listing existing VRAs...")
|
||||
list_vras(client)
|
||||
|
||||
# Step 2: Ask for deletion confirmation
|
||||
if get_user_confirmation("Would you like to delete all existing VRAs?"):
|
||||
print("\nStep 2: Deleting existing VRAs...")
|
||||
vras = client.vras.list_vras()
|
||||
for vra in vras:
|
||||
vra_id = vra.get('VraIdentifier')
|
||||
print(f"Deleting VRA: {vra.get('VraName')} ({vra_id})")
|
||||
client.vras.delete_vra(vra_id)
|
||||
print("Waiting for deletion to complete...")
|
||||
time.sleep(5) # Give some time for deletion to process
|
||||
|
||||
# Step 3: Create new VRAs
|
||||
if get_user_confirmation("Would you like to create new VRAs?"):
|
||||
print("\nStep 3: Creating new VRAs...")
|
||||
|
||||
# Create first VRA
|
||||
print("\nConfiguring first VRA...")
|
||||
result1 = create_vra_with_selection(client, 1)
|
||||
if result1:
|
||||
print("Waiting for first VRA deployment to complete...")
|
||||
time.sleep(30)
|
||||
|
||||
# Create second VRA
|
||||
if get_user_confirmation("Would you like to create a second VRA?"):
|
||||
print("\nConfiguring second VRA...")
|
||||
result2 = create_vra_with_selection(client, 2)
|
||||
if result2:
|
||||
print("Waiting for second VRA deployment to complete...")
|
||||
time.sleep(30)
|
||||
|
||||
# Step 4: Verify final state
|
||||
print("\nStep 4: Verifying final VRA configuration...")
|
||||
list_vras(client)
|
||||
|
||||
except Exception as e:
|
||||
logging.exception("Error occurred:")
|
||||
sys.exit(1)
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
Reference in New Issue
Block a user