def main():
args = getargs.getargs()
stub_config = auth.get_session_auth_stub_config(args.user, args.password,
args.nsx_host,
args.tcp_port)
# Create a pretty printer to make the output look nice.
pp = PrettyPrinter()
# Create the services we'll need.
transportzones_svc = TransportZones(stub_config)
logicalswitches_svc = LogicalSwitches(stub_config)
logicalports_svc = LogicalPorts(stub_config)
nsgroups_svc = NsGroups(stub_config)
efflports_svc = EffectiveLogicalPortMembers(stub_config)
# Create a transport zone and logical switch. We only
# need these so we can create logical ports. They aren't
# part of the demo.
tz = TransportZone(transport_type=TransportZone.TRANSPORT_TYPE_OVERLAY,
display_name="Tagging Demo Transport Zone",
description="Transport zone for tagging demo",
host_switch_name="hostswitch")
tz = transportzones_svc.create(tz)
ls = LogicalSwitch(
transport_zone_id=tz.id,
admin_state=LogicalSwitch.ADMIN_STATE_UP,
replication_mode=LogicalSwitch.REPLICATION_MODE_MTEP,
display_name="ls-tag-demo",
)
ls = logicalswitches_svc.create(ls)
# First, create a new group whose members are any logical
# ports with a tag scope of "color" and tag value of "green"
group = NSGroup(
display_name="Green Logical Ports",
description="All logical ports with scope=color and tag=green",
membership_criteria=[
NSGroupTagExpression(resource_type="NSGroupTagExpression",
target_type="LogicalPort",
scope_op="EQUALS",
scope="color",
tag_op="EQUALS",
tag="green")
])
green_group = nsgroups_svc.create(group)
# Now create another group for color:yellow logical ports.
group = NSGroup(
display_name="Yellow Logical Ports",
description="All logical ports with scope=color and tag=yellow",
membership_criteria=[
NSGroupTagExpression(resource_type="NSGroupTagExpression",
target_type="LogicalPort",
scope_op="EQUALS",
scope="color",
tag_op="EQUALS",
tag="yellow")
])
yellow_group = nsgroups_svc.create(group)
# Now get the list of effective members (that is, logical ports
# with color:green). There should be no effective members yet.
print("Before creating any lports:")
print_group_effective_members("green group",
efflports_svc.list(green_group.id))
print_group_effective_members("yellow group",
efflports_svc.list(yellow_group.id))
print("")
# Create a logical port with color:green
lport = LogicalPort(display_name="tagging-demo-lp1",
admin_state=LogicalPort.ADMIN_STATE_UP,
logical_switch_id=ls.id,
tags=[Tag(scope="color", tag="green")])
lport = logicalports_svc.create(lport)
print("Logical port for this test has id %s" % lport.id)
print("")
# Group membership is computed asynchronously in the NSX
# manager. Wait a bit.
time.sleep(2.0)
# Find the effective members of the green and yellow groups.
# Notice that the logical port is in the green group.
print("After creating green lport:")
print_group_effective_members("green group",
efflports_svc.list(green_group.id))
print_group_effective_members("yellow group",
efflports_svc.list(yellow_group.id))
print("")
# Now modify the logical port's color to yellow.
lport = logicalports_svc.get(lport.id)
lport.tags = [Tag(scope="color", tag="yellow")]
logicalports_svc.update(lport.id, lport)
# Wait for group recalculation
time.sleep(2.0)
# Find the effective members of the green and yellow groups.
# Notice that the logical port is now in the yellow group
# and no longer in the green group.
print("After changing lport color to yellow:")
print_group_effective_members("green group",
efflports_svc.list(green_group.id))
print_group_effective_members("yellow group",
efflports_svc.list(yellow_group.id))
print("")
# Now clear the tag
lport = logicalports_svc.get(lport.id)
lport.tags = []
logicalports_svc.update(lport.id, lport)
# Wait for group recalculation
time.sleep(2.0)
# The port should be in neither group
print("After removing lport color tag:")
print_group_effective_members("green group",
efflports_svc.list(green_group.id))
print_group_effective_members("yellow group",
efflports_svc.list(yellow_group.id))
print("")
print("Press enter to delete all resources created for this example.")
sys.stdin.readline()
# Delete all resources we created.
logicalports_svc.delete(lport.id)
nsgroups_svc.delete(green_group.id)
nsgroups_svc.delete(yellow_group.id)
logicalswitches_svc.delete(ls.id)
transportzones_svc.delete(tz.id)
def main():
module = AnsibleModule(argument_spec=dict(
display_name=dict(required=True, type='str'),
description=dict(required=False, type='str', default=None),
admin_state=dict(required=False,
type='str',
default='UP',
choices=['UP', 'DOWN']),
logical_switch_id=dict(required=True, type='str'),
switching_profile_ids=dict(required=False, type='list', default=None),
tags=dict(required=False, type='dict', default=None),
state=dict(required=False,
type='str',
default="present",
choices=['present', 'absent']),
nsx_manager=dict(required=True, type='str'),
nsx_username=dict(required=True, type='str'),
nsx_passwd=dict(required=True, type='str', no_log=True)),
supports_check_mode=True)
if not HAS_PYNSXT:
module.fail_json(msg='pynsxt is required for this module')
session = requests.session()
session.verify = False
nsx_url = 'https://%s:%s' % (module.params['nsx_manager'], 443)
connector = connect.get_requests_connector(session=session,
msg_protocol='rest',
url=nsx_url)
stub_config = StubConfigurationFactory.new_std_configuration(connector)
security_context = create_user_password_security_context(
module.params["nsx_username"], module.params["nsx_passwd"])
connector.set_security_context(security_context)
requests.packages.urllib3.disable_warnings()
tags = None
if module.params['tags'] is not None:
tags = []
for key, value in module.params['tags'].items():
tag = Tag(scope=key, tag=value)
tags.append(tag)
lsp_svc = LogicalPorts(stub_config)
lsp = getLogicalSwitchPortByName(module, stub_config)
if module.params['state'] == 'present':
if lsp is None:
new_lsp = LogicalPort(
display_name=module.params['display_name'],
description=module.params['description'],
address_bindings=None,
admin_state=module.params['admin_state'],
attachment=None,
logical_switch_id=module.params['logical_switch_id'],
switching_profile_ids=None,
tags=tags)
if module.check_mode:
module.exit_json(changed=True,
debug_out=str(new_lsp),
id="1111")
new_lsp = lsp_svc.create(new_lsp)
module.exit_json(
changed=True,
object_name=module.params['display_name'],
id=new_lsp.id,
message="Logical Switch Port with name %s created!" %
(module.params['display_name']))
elif lsp:
changed = False
if tags != lsp.tags:
changed = True
lsp.tags = tags
if module.check_mode:
module.exit_json(changed=True,
debug_out=str(lsp),
id=lsp.id)
new_lsp = lsp_svc.update(lsp.id, lsp)
if changed:
module.exit_json(
changed=True,
object_name=module.params['display_name'],
id=new_lsp.id,
message="Logical Switch Port with name %s has changed tags!"
% (module.params['display_name']))
module.exit_json(
changed=False,
object_name=module.params['display_name'],
id=lsp.id,
message="Logical Switch Port with name %s already exists!" %
(module.params['display_name']))
elif module.params['state'] == "absent":
if lsp:
if module.check_mode:
module.exit_json(changed=True, debug_out=str(lsp), id=lsp.id)
lsp_svc.delete(lsp.id)
module.exit_json(
changed=True,
object_name=module.params['display_name'],
message="Logical Switch Port with name %s deleted!" %
(module.params['display_name']))
module.exit_json(
changed=False,
object_name=module.params['display_name'],
message="Logical Switch Port with name %s does not exist!" %
(module.params['display_name']))
def main():
args = getargs.getargs()
stub_config = auth.get_session_auth_stub_config(args.user, args.password,
args.nsx_host,
args.tcp_port)
pp = PrettyPrinter()
# Instantiate all the services we'll need.
transportzones_svc = TransportZones(stub_config)
logicalswitches_svc = LogicalSwitches(stub_config)
logicalrouters_svc = LogicalRouters(stub_config)
logicalrouterports_svc = LogicalRouterPorts(stub_config)
logicalports_svc = LogicalPorts(stub_config)
fwsections_svc = Sections(stub_config)
# Create a transport zone
new_tz = TransportZone(
transport_type=TransportZone.TRANSPORT_TYPE_OVERLAY,
display_name="Two Tier App Demo Transport Zone",
description="Transport zone for two-tier app demo",
host_switch_name="hostswitch"
)
demo_tz = transportzones_svc.create(new_tz)
# Create a logical switch for the db tier
new_ls = LogicalSwitch(
transport_zone_id=demo_tz.id,
admin_state=LogicalSwitch.ADMIN_STATE_UP,
replication_mode=LogicalSwitch.REPLICATION_MODE_MTEP,
display_name="ls-db",
)
db_ls = logicalswitches_svc.create(new_ls)
# Create a logical switch for the web tier
new_ls = LogicalSwitch(
transport_zone_id=demo_tz.id,
admin_state=LogicalSwitch.ADMIN_STATE_UP,
replication_mode=LogicalSwitch.REPLICATION_MODE_MTEP,
display_name="ls-web",
)
web_ls = logicalswitches_svc.create(new_ls)
# Create a logical router that will route traffic between
# the web and db tiers
new_lr = LogicalRouter(
router_type=LogicalRouter.ROUTER_TYPE_TIER1,
display_name="lr-demo",
failover_mode=LogicalRouter.FAILOVER_MODE_PREEMPTIVE
)
lr = logicalrouters_svc.create(new_lr)
# Create a logical port on the db and web logical switches. We
# will attach the logical router to those ports so that it can
# route between the logical switches.
# Logical port on the db logical switch
new_lp = LogicalPort(
admin_state=LogicalPort.ADMIN_STATE_UP,
logical_switch_id=db_ls.id,
display_name="dbTierUplinkToRouter"
)
db_port_on_ls = logicalports_svc.create(new_lp)
# Logical port on the web logical switch
new_lp = LogicalPort(
admin_state=LogicalPort.ADMIN_STATE_UP,
logical_switch_id=web_ls.id,
display_name="webTierUplinkToRouter"
)
web_port_on_ls = logicalports_svc.create(new_lp)
# Populate a logical router downlink port payload and configure
# the port with the CIDR 192.168.1.1/24. We will attach this
# port to the db tier's logical switch.
new_lr_port = LogicalRouterDownLinkPort(
subnets=[IPSubnet(ip_addresses=["192.168.1.1"], prefix_length=24)],
linked_logical_switch_port_id=ResourceReference(
target_id=db_port_on_ls.id),
resource_type="LogicalRouterDownLinkPort",
logical_router_id=lr.id
)
# Create the downlink port
lr_port_for_db_tier = logicalrouterports_svc.create(new_lr_port)
# Convert to concrete type
lr_port_for_db_tier = lr_port_for_db_tier.convert_to(
LogicalRouterDownLinkPort)
# Populate a logical router downlink port payload and configure
# the port with the CIDR 192.168.2.1/24. We will attach this
# port to the web tier's logical switch.
new_lr_port = LogicalRouterDownLinkPort(
subnets=[IPSubnet(ip_addresses=["192.168.2.1"], prefix_length=24)],
linked_logical_switch_port_id=ResourceReference(
target_id=web_port_on_ls.id),
resource_type="LogicalRouterDownLinkPort",
logical_router_id=lr.id
)
# Create the downlink port
lr_port_for_web_tier = logicalrouterports_svc.create(new_lr_port)
lr_port_for_web_tier = lr_port_for_web_tier.convert_to(
LogicalRouterDownLinkPort)
# Now establish a firewall policy that only allows MSSQL
# server traffic and ICMP traffic in and out of the db tier's
# logical switch.
# Create 3 firewall rules. The first will allow traffic used
# by MS SQL Server to pass. This rule references a built-in
# ns service group that includes all the common ports used by
# the MSSQL Server. The ID is common to all NSX installations.
MSSQL_SERVER_NS_GROUP_ID = "5a6d380a-6d28-4e3f-b705-489f463ae6ad"
ms_sql_rule = FirewallRule(
action=FirewallRule.ACTION_ALLOW,
display_name="Allow MSSQL Server",
ip_protocol=FirewallRule.IP_PROTOCOL_IPV4_IPV6,
services=[
FirewallService(
target_type="NSServiceGroup",
target_id=MSSQL_SERVER_NS_GROUP_ID
)
]
)
# The second rule will allow ICMP echo requests and responses.
ICMP_ECHO_REQUEST_NS_SVC_ID = "5531a880-61aa-42cc-ba4b-13b9ea611e2f"
ICMP_ECHO_REPLY_NS_SVC_ID = "c54b2d86-6327-41ff-a3fc-c67171b6ba63"
icmp_rule = FirewallRule(
action=FirewallRule.ACTION_ALLOW,
display_name="Allow ICMP Echo",
ip_protocol=FirewallRule.IP_PROTOCOL_IPV4_IPV6,
services=[
FirewallService(
target_type="NSService",
target_id=ICMP_ECHO_REQUEST_NS_SVC_ID
),
FirewallService(
target_type="NSService",
target_id=ICMP_ECHO_REPLY_NS_SVC_ID
)
]
)
# The third rule will drop all traffic not passed by the previous
# rules.
block_all_rule = FirewallRule(
action=FirewallRule.ACTION_DROP,
display_name="Drop all",
ip_protocol=FirewallRule.IP_PROTOCOL_IPV4_IPV6
)
# Add all rules to a new firewall section and create the section.
rule_list = FirewallSectionRuleList(
rules=[ms_sql_rule, icmp_rule, block_all_rule],
section_type=FirewallSection.SECTION_TYPE_LAYER3,
stateful=True,
display_name="MSSQL Server",
description="Only allow MSSQL server traffic"
)
demo_section = fwsections_svc.createwithrules(
rule_list, None, operation="insert_top")
# Re-read the firewall section so that we are operating on up-to-date
# data.
section = fwsections_svc.get(demo_section.id)
# Make the firewall section apply to the db tier logical
# switch. This enables the firewall policy on all logical
# ports attached to the db tier logical switch.
section.applied_tos = [
ResourceReference(target_id=db_ls.id,
target_type="LogicalSwitch")
]
fwsections_svc.update(section.id, section)
print("At this point you may attach VMs for the db tier to the db")
print("logical switch and VMs for the web tier to the web logical")
print("switch. The network interfaces should be configured as")
print("follows:")
print("db tier:")
print(" IP address: in the range 192.168.1.2-254")
print(" Netmask: 255.255.255.0")
print(" Default route: 192.168.1.1")
print("web tier:")
print(" IP address: in the range 192.168.2.2-254")
print(" Netmask: 255.255.255.0")
print(" Default route: 192.168.2.1")
print("Logical switch IDs:")
print(" %s: %s" % (db_ls.display_name, db_ls.id))
print(" %s: %s" % (web_ls.display_name, web_ls.id))
print("Transport zone: %s: %s" % (demo_tz.display_name, demo_tz.id))
print("Press enter to delete all resources created for this example.")
sys.stdin.readline()
fwsections_svc.delete(section.id, cascade=True)
logicalrouterports_svc.delete(lr_port_for_web_tier.id)
logicalrouterports_svc.delete(lr_port_for_db_tier.id)
logicalports_svc.delete(web_port_on_ls.id)
logicalports_svc.delete(db_port_on_ls.id)
logicalrouters_svc.delete(lr.id)
logicalswitches_svc.delete(web_ls.id)
logicalswitches_svc.delete(db_ls.id)
transportzones_svc.delete(demo_tz.id)