platform

type API interface {
	// BuildTaskNetworkConfiguration translates network data in task payload sent by ACS
	// into the task network configuration data structure internal to the agent.
	BuildTaskNetworkConfiguration(
		taskID string,
		taskPayload *ecsacs.Task) (*tasknetworkconfig.TaskNetworkConfig, error)

	// CreateNetNS creates a network namespace with the specified path.
	CreateNetNS(netNSPath string) error

	// DeleteNetNS deletes the specified network namespace.
	DeleteNetNS(netNSPath string) error

	// CreateDNSConfig creates the following DNS config files depending on the
	// network namespace configuration:
	// 1. resolv.conf
	// 2. hosts
	// 3. hostname
	// These files are then copied into desired locations so that containers will
	// have access to the accurate DNS configuration information.
	CreateDNSConfig(taskID string, netNS *tasknetworkconfig.NetworkNamespace) error

	// DeleteDNSConfig deletes the directory at /etc/netns/<netns-name> and all its files.
	DeleteDNSConfig(netNSName string) error

	// GetNetNSPath returns the path of a network namespace.
	GetNetNSPath(netNSName string) string

	// ConfigureInterface configures an interface inside a network namespace
	// for it to be able to serve traffic.
	ConfigureInterface(
		ctx context.Context,
		netNSPath string,
		iface *networkinterface.NetworkInterface,
		netDAO netlibdata.NetworkDataClient,
	) error

	// ConfigureAppMesh configures AppMesh specific rules inside the task network namespace
	// to enable the AppMesh feature.
	ConfigureAppMesh(ctx context.Context, netNSPath string, cfg *appmesh.AppMesh) error

	// ConfigureServiceConnect configures Service Connect specific rules inside the task network namespace
	// to enable the ServiceConnect feature.
	ConfigureServiceConnect(
		ctx context.Context,
		netNSPath string,
		primaryIf *networkinterface.NetworkInterface,
		scConfig *serviceconnect.ServiceConnectConfig,
	) error
}