Switcher

The Switcher handles creation and deletion of Layer-2 virtual Infra Segments in the vSphere environment using NSX-T.

Endpoints

The Switcher has two gRPC endpoints:

create

Request

message DeploySwitch {
    Switch switch = 1;
    MetaInfo metaInfo = 2;
}

For reference, the Switch, MetaInfo messages are defined as follows:

message Switch {
  string name = 1;
  repeated string links = 2;
}

message MetaInfo {
  string exerciseName = 1;
  string deploymentName = 2;
}

Successful Response

message Identifier {
    string value = 1;
}

delete

Deletes the virtual switch from the NSX environment.

Request

message Identifier {
    string value = 1;
}

Successful Response

message Empty {}

Configuration

The following configuration options are available for the Machiner handler:

Variable	Mandatory	Type	Rules
nsxt_api	yes	string	NSX-T address
nsxt_auth	yes	string	NSX-T username and password in base64 encryption, format: username:password
transport_zone_name	yes	string	Transport zone to be used
insecure	yes	bool	Enables or disables certificate verification for the vSphere client
server_address	yes	string	The handlers own address and port

Example configuration file:

nsxt_api: nsxt.example.com
nsxt_auth: aGVsbG86d29ybGQK
transport_zone_name: EXERCISES-TZ
insecure: false
server_address: 0.0.0.0:9998