Skip to main content

DockerNetwork

Resource DockerNetwork in pulumi-portainer.
5 min read

Resource DockerNetwork in pulumi-portainer.

Pulumi type: portainer:index/dockerNetwork:DockerNetwork.

name is the Pulumi resource name. Nested object fields are documented under that object. They are not arguments of this resource.

Example#

Only required arguments are set. A string in angle brackets stands in for that argument. Any other value is an option or example written in the SDK description.

Arguments#

PropertyTypeRequiredDescription
attachablebooleannoWhether standalone containers may attach to this Swarm overlay network.
configFromstringnoName of a config-only network from which to copy configuration.
configOnlybooleannoWhether this is a config-only network that contains only configuration for other networks.
dockerNetworkIdstringno
driverstringnoDriver used by the Docker network (e.g., bridge, overlay, macvlan, host, null).
enableIpv4booleannoWhether IPv4 is enabled on the Docker network.
enableIpv6booleannoWhether IPv6 is enabled on the Docker network.
endpointIdnumberyesID of the Portainer environment (Docker host or Swarm) where the network is created.
ingressbooleannoWhether the network is a Swarm ingress network used for the routing mesh.
internalbooleannoWhether the network is restricted to internal use only (no external connectivity).
ipamConfigsDockerNetworkIpamConfig (input)[]noList of IPAM configuration blocks defining subnets, gateways, and IP ranges.
ipamDriverstringnoIPAM driver used to allocate IP addresses for the Docker network.
ipamOptions{ [key: string]: string }noDriver-specific options passed to the IPAM driver.
labels{ [key: string]: string }noKey/value labels attached to the Docker network.
namestringnoName of the Docker network.
options{ [key: string]: string }noDriver-specific options passed to the Docker network driver.
scopestringnoScope of the Docker network (local, global, or swarm).
swarmNodeIdstringnoSwarm node ID where the network operation is targeted, when applicable.

Outputs#

Computed outputs are produced by the provider. They are not constructor arguments.

PropertyTypeComputedDescription
attachablebooleannoWhether standalone containers may attach to this Swarm overlay network.
configFromstringnoName of a config-only network from which to copy configuration.
configOnlybooleannoWhether this is a config-only network that contains only configuration for other networks.
dockerNetworkIdstringno
driverstringnoDriver used by the Docker network (e.g., bridge, overlay, macvlan, host, null).
enableIpv4booleannoWhether IPv4 is enabled on the Docker network.
enableIpv6booleannoWhether IPv6 is enabled on the Docker network.
endpointIdnumbernoID of the Portainer environment (Docker host or Swarm) where the network is created.
ingressbooleannoWhether the network is a Swarm ingress network used for the routing mesh.
internalbooleannoWhether the network is restricted to internal use only (no external connectivity).
ipamConfigsDockerNetworkIpamConfig (output)[]noList of IPAM configuration blocks defining subnets, gateways, and IP ranges.
ipamDriverstringnoIPAM driver used to allocate IP addresses for the Docker network.
ipamOptions{ [key: string]: string }noDriver-specific options passed to the IPAM driver.
labels{ [key: string]: string }noKey/value labels attached to the Docker network.
namestringnoName of the Docker network.
options{ [key: string]: string }noDriver-specific options passed to the Docker network driver.
resourceControlIdnumberyesID of the Portainer resource control associated with this Docker network.
scopestringnoScope of the Docker network (local, global, or swarm).
swarmNodeIdstringnoSwarm node ID where the network operation is targeted, when applicable.

DockerNetworkIpamConfig (input)#

Input object DockerNetworkIpamConfig. Fields below belong to this object, not to the parent.

PropertyTypeRequiredDescription
auxiliaryAddresses{ [key: string]: string }noAuxiliary IPv4 or IPv6 addresses used by the network driver, keyed by name.
gatewaystringnoGateway IPv4 or IPv6 address for the subnet.
ipRangestringnoSub-range of IP addresses within the subnet from which to allocate container IPs.
subnetstringyesSubnet in CIDR notation for the IPAM pool.

DockerNetworkIpamConfig (output)#

Output object DockerNetworkIpamConfig. Fields below belong to this object.

PropertyTypeAlways presentDescription
auxiliaryAddresses{ [key: string]: string }noAuxiliary IPv4 or IPv6 addresses used by the network driver, keyed by name.
gatewaystringnoGateway IPv4 or IPv6 address for the subnet.
ipRangestringnoSub-range of IP addresses within the subnet from which to allocate container IPs.
subnetstringyesSubnet in CIDR notation for the IPAM pool.