Creating a SmartGroup

To create a SmartGroup:

  1. In the CoPilot UI, go to Groups > SmartGroups.

  2. Click + SmartGroup.

  3. In the Create SmartGroup dialog, provide the following information about your SmartGroup:

    Parameter Description

    Name

    Name of the new SmartGroup.

    Resource Type - Virtual Machine, Subnets, VPC/VNets

    Enter the matching criteria for resources that will be part of this SmartGroup. You can match conditions based on:

    • The properties Name, Region, or Account Name, if you want to match against all resources within an account or region. The values for the selected condition(s) are populated automatically.

    • The CSP tags that you have defined for your Cloud resources. Some examples of tags are: Backup, Controller, Aviatrix-Created-Resource, and Type. The CSP tags change depending on the selected Resource Type.

    If you select GCP-based VMs, ensure that you have first enabled the appropriate API permission: compute.networks.listEffectiveTags. See the Aviatrix Google Cloud Getting Started Guide for more information.

    Resource Type - IPs/CIDRs

    Enter multiple IPs or CIDRs.

    Enter FQDNs in the DNS Hostname Resource Type field.

    Resource Type - External Connections (S2C)

    Enter or select pre-existing external connections.

    An External Connection SmartGroup will resolve to either the remote CIDRs defined for a static route external connection, or the BGP-advertised CIDRs for BGP-based external connections.

    DNS Hostnames

    Enter Fully Qualified Domain Names. For more information, see About Hostname SmartGroups.

    Resource Type - Kubernetes Workload

    Enter or select a Namespace, Cluster, and/or Service.

    A Kubernetes Workload SmartGroup will resolve to the IP addresses of the pods in the selected cluster and namespace. A Kubernetes Workload is a set of pods that run on a Kubernetes cluster.

    Resource Type - Kubernetes Node

    Enter or select a Kubernetes Node.

    A Kubernetes Node SmartGroup will resolve to the IP addresses of the nodes in the selected cluster. A Kubernetes Node is a worker machine in Kubernetes, which can be a VM or a physical machine, depending on the cluster.

  4. Toggle on the Preview slider to show the resources that match the configured criteria.

  5. Click Save. The new Smart Group is now in the SmartGroups list.

As of Controller version 7.2.4994 with CoPilot 4.17, you can no longer enter an FQDN in the IP/CIDRs field. If you want to enter an FQDN you must enter it in the Hostname field.

Viewing SmartGroup Details

You can click a SmartGroup name in the list to view its resources and Rule References in the right-hand pane.

smartgroup details