Docs Home Pulumi IaC Pulumi ESC Pulumi Cloud Packages Tutorials
  1. Packages
  2. Scaleway
  3. API Docs
  4. containers
  5. Domain
Scaleway v1.25.0 published on Saturday, Mar 22, 2025 by pulumiverse
pulumiverse/pulumi-scaleway

scaleway.containers.Domain

Explore with Pulumi AI

scaleway logo
Scaleway v1.25.0 published on Saturday, Mar 22, 2025 by pulumiverse
pulumiverse/pulumi-scaleway

    The scaleway.containers.Domain resource allows you to create and manage domain name bindings for Scaleway Serverless Containers.

    Refer to the Containers domain documentation and the API documentation for more information.

    Example Usage

    The commands below shows how to bind a custom domain name to a container.

    Simple

    import * as pulumi from "@pulumi/pulumi";
import * as scaleway from "@pulumiverse/scaleway";

const app = new scaleway.containers.Container("app", {});
const appDomain = new scaleway.containers.Domain("app", {
    containerId: app.id,
    hostname: "container.domain.tld",
});

    import pulumi
import pulumiverse_scaleway as scaleway

app = scaleway.containers.Container("app")
app_domain = scaleway.containers.Domain("app",
    container_id=app.id,
    hostname="container.domain.tld")

    package main

import (
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumiverse/pulumi-scaleway/sdk/go/scaleway/containers"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		app, err := containers.NewContainer(ctx, "app", nil)
		if err != nil {
			return err
		}
		_, err = containers.NewDomain(ctx, "app", &containers.DomainArgs{
			ContainerId: app.ID(),
			Hostname:    pulumi.String("container.domain.tld"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Scaleway = Pulumiverse.Scaleway;

return await Deployment.RunAsync(() => 
{
    var app = new Scaleway.Containers.Container("app");

    var appDomain = new Scaleway.Containers.Domain("app", new()
    {
        ContainerId = app.Id,
        Hostname = "container.domain.tld",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.scaleway.containers.Container;
import com.pulumi.scaleway.containers.Domain;
import com.pulumi.scaleway.containers.DomainArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var app = new Container("app");

        var appDomain = new Domain("appDomain", DomainArgs.builder()
            .containerId(app.id())
            .hostname("container.domain.tld")
            .build());

    }
}

    resources:
  app:
    type: scaleway:containers:Container
  appDomain:
    type: scaleway:containers:Domain
    name: app
    properties:
      containerId: ${app.id}
      hostname: container.domain.tld

    Complete example with domain

    import * as pulumi from "@pulumi/pulumi";
import * as scaleway from "@pulumiverse/scaleway";

const main = new scaleway.containers.Namespace("main", {
    name: "my-ns-test",
    description: "test container",
});
const app = new scaleway.containers.Container("app", {
    name: "app",
    namespaceId: main.id,
    registryImage: pulumi.interpolate`${main.registryEndpoint}/nginx:alpine`,
    port: 80,
    cpuLimit: 140,
    memoryLimit: 256,
    minScale: 1,
    maxScale: 1,
    timeout: 600,
    maxConcurrency: 80,
    privacy: "public",
    protocol: "http1",
    deploy: true,
});
const appRecord = new scaleway.domain.Record("app", {
    dnsZone: "domain.tld",
    name: "subdomain",
    type: "CNAME",
    data: pulumi.interpolate`${app.domainName}.`,
    ttl: 3600,
});
const appDomain = new scaleway.containers.Domain("app", {
    containerId: app.id,
    hostname: pulumi.interpolate`${appRecord.name}.${appRecord.dnsZone}`,
});

    import pulumi
import pulumiverse_scaleway as scaleway

main = scaleway.containers.Namespace("main",
    name="my-ns-test",
    description="test container")
app = scaleway.containers.Container("app",
    name="app",
    namespace_id=main.id,
    registry_image=main.registry_endpoint.apply(lambda registry_endpoint: f"{registry_endpoint}/nginx:alpine"),
    port=80,
    cpu_limit=140,
    memory_limit=256,
    min_scale=1,
    max_scale=1,
    timeout=600,
    max_concurrency=80,
    privacy="public",
    protocol="http1",
    deploy=True)
app_record = scaleway.domain.Record("app",
    dns_zone="domain.tld",
    name="subdomain",
    type="CNAME",
    data=app.domain_name.apply(lambda domain_name: f"{domain_name}."),
    ttl=3600)
app_domain = scaleway.containers.Domain("app",
    container_id=app.id,
    hostname=pulumi.Output.all(
        name=app_record.name,
        dns_zone=app_record.dns_zone
).apply(lambda resolved_outputs: f"{resolved_outputs['name']}.{resolved_outputs['dns_zone']}")
)

    package main

import (
	"fmt"

	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumiverse/pulumi-scaleway/sdk/go/scaleway/containers"
	"github.com/pulumiverse/pulumi-scaleway/sdk/go/scaleway/domain"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		main, err := containers.NewNamespace(ctx, "main", &containers.NamespaceArgs{
			Name:        pulumi.String("my-ns-test"),
			Description: pulumi.String("test container"),
		})
		if err != nil {
			return err
		}
		app, err := containers.NewContainer(ctx, "app", &containers.ContainerArgs{
			Name:        pulumi.String("app"),
			NamespaceId: main.ID(),
			RegistryImage: main.RegistryEndpoint.ApplyT(func(registryEndpoint string) (string, error) {
				return fmt.Sprintf("%v/nginx:alpine", registryEndpoint), nil
			}).(pulumi.StringOutput),
			Port:           pulumi.Int(80),
			CpuLimit:       pulumi.Int(140),
			MemoryLimit:    pulumi.Int(256),
			MinScale:       pulumi.Int(1),
			MaxScale:       pulumi.Int(1),
			Timeout:        pulumi.Int(600),
			MaxConcurrency: pulumi.Int(80),
			Privacy:        pulumi.String("public"),
			Protocol:       pulumi.String("http1"),
			Deploy:         pulumi.Bool(true),
		})
		if err != nil {
			return err
		}
		appRecord, err := domain.NewRecord(ctx, "app", &domain.RecordArgs{
			DnsZone: pulumi.String("domain.tld"),
			Name:    pulumi.String("subdomain"),
			Type:    pulumi.String("CNAME"),
			Data: app.DomainName.ApplyT(func(domainName string) (string, error) {
				return fmt.Sprintf("%v.", domainName), nil
			}).(pulumi.StringOutput),
			Ttl: pulumi.Int(3600),
		})
		if err != nil {
			return err
		}
		_, err = containers.NewDomain(ctx, "app", &containers.DomainArgs{
			ContainerId: app.ID(),
			Hostname: pulumi.All(appRecord.Name, appRecord.DnsZone).ApplyT(func(_args []interface{}) (string, error) {
				name := _args[0].(string)
				dnsZone := _args[1].(string)
				return fmt.Sprintf("%v.%v", name, dnsZone), nil
			}).(pulumi.StringOutput),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Scaleway = Pulumiverse.Scaleway;

return await Deployment.RunAsync(() => 
{
    var main = new Scaleway.Containers.Namespace("main", new()
    {
        Name = "my-ns-test",
        Description = "test container",
    });

    var app = new Scaleway.Containers.Container("app", new()
    {
        Name = "app",
        NamespaceId = main.Id,
        RegistryImage = main.RegistryEndpoint.Apply(registryEndpoint => $"{registryEndpoint}/nginx:alpine"),
        Port = 80,
        CpuLimit = 140,
        MemoryLimit = 256,
        MinScale = 1,
        MaxScale = 1,
        Timeout = 600,
        MaxConcurrency = 80,
        Privacy = "public",
        Protocol = "http1",
        Deploy = true,
    });

    var appRecord = new Scaleway.Domain.Record("app", new()
    {
        DnsZone = "domain.tld",
        Name = "subdomain",
        Type = "CNAME",
        Data = app.DomainName.Apply(domainName => $"{domainName}."),
        Ttl = 3600,
    });

    var appDomain = new Scaleway.Containers.Domain("app", new()
    {
        ContainerId = app.Id,
        Hostname = Output.Tuple(appRecord.Name, appRecord.DnsZone).Apply(values =>
        {
            var name = values.Item1;
            var dnsZone = values.Item2;
            return $"{name}.{dnsZone}";
        }),
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.scaleway.containers.Namespace;
import com.pulumi.scaleway.containers.NamespaceArgs;
import com.pulumi.scaleway.containers.Container;
import com.pulumi.scaleway.containers.ContainerArgs;
import com.pulumi.scaleway.domain.Record;
import com.pulumi.scaleway.domain.RecordArgs;
import com.pulumi.scaleway.containers.Domain;
import com.pulumi.scaleway.containers.DomainArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var main = new Namespace("main", NamespaceArgs.builder()
            .name("my-ns-test")
            .description("test container")
            .build());

        var app = new Container("app", ContainerArgs.builder()
            .name("app")
            .namespaceId(main.id())
            .registryImage(main.registryEndpoint().applyValue(registryEndpoint -> String.format("%s/nginx:alpine", registryEndpoint)))
            .port(80)
            .cpuLimit(140)
            .memoryLimit(256)
            .minScale(1)
            .maxScale(1)
            .timeout(600)
            .maxConcurrency(80)
            .privacy("public")
            .protocol("http1")
            .deploy(true)
            .build());

        var appRecord = new Record("appRecord", RecordArgs.builder()
            .dnsZone("domain.tld")
            .name("subdomain")
            .type("CNAME")
            .data(app.domainName().applyValue(domainName -> String.format("%s.", domainName)))
            .ttl(3600)
            .build());

        var appDomain = new Domain("appDomain", DomainArgs.builder()
            .containerId(app.id())
            .hostname(Output.tuple(appRecord.name(), appRecord.dnsZone()).applyValue(values -> {
                var name = values.t1;
                var dnsZone = values.t2;
                return String.format("%s.%s", name,dnsZone);
            }))
            .build());

    }
}

    resources:
  main:
    type: scaleway:containers:Namespace
    properties:
      name: my-ns-test
      description: test container
  app:
    type: scaleway:containers:Container
    properties:
      name: app
      namespaceId: ${main.id}
      registryImage: ${main.registryEndpoint}/nginx:alpine
      port: 80
      cpuLimit: 140
      memoryLimit: 256
      minScale: 1
      maxScale: 1
      timeout: 600
      maxConcurrency: 80
      privacy: public
      protocol: http1
      deploy: true
  appRecord:
    type: scaleway:domain:Record
    name: app
    properties:
      dnsZone: domain.tld
      name: subdomain
      type: CNAME
      data: ${app.domainName}.
      ttl: 3600
  appDomain:
    type: scaleway:containers:Domain
    name: app
    properties:
      containerId: ${app.id}
      hostname: ${appRecord.name}.${appRecord.dnsZone}

    Create Domain Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Domain(name: string, args: DomainArgs, opts?: CustomResourceOptions);
    @overload
def Domain(resource_name: str,
           args: DomainArgs,
           opts: Optional[ResourceOptions] = None)

@overload
def Domain(resource_name: str,
           opts: Optional[ResourceOptions] = None,
           container_id: Optional[str] = None,
           hostname: Optional[str] = None,
           region: Optional[str] = None)
    func NewDomain(ctx *Context, name string, args DomainArgs, opts ...ResourceOption) (*Domain, error)
    public Domain(string name, DomainArgs args, CustomResourceOptions? opts = null)
    public Domain(String name, DomainArgs args)
public Domain(String name, DomainArgs args, CustomResourceOptions options)

    type: scaleway:containers:Domain
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args DomainArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args DomainArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args DomainArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args DomainArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args DomainArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var domainResource = new Scaleway.Containers.Domain("domainResource", new()
{
    ContainerId = "string",
    Hostname = "string",
    Region = "string",
});

    example, err := containers.NewDomain(ctx, "domainResource", &containers.DomainArgs{
	ContainerId: pulumi.String("string"),
	Hostname:    pulumi.String("string"),
	Region:      pulumi.String("string"),
})

    var domainResource = new Domain("domainResource", DomainArgs.builder()
    .containerId("string")
    .hostname("string")
    .region("string")
    .build());

    domain_resource = scaleway.containers.Domain("domainResource",
    container_id="string",
    hostname="string",
    region="string")

    const domainResource = new scaleway.containers.Domain("domainResource", {
    containerId: "string",
    hostname: "string",
    region: "string",
});

    type: scaleway:containers:Domain
properties:
    containerId: string
    hostname: string
    region: string

    Domain Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Domain resource accepts the following input properties:

    ContainerId string
    The unique identifier of the container.
    Hostname string
    The hostname with a CNAME record.
    Region string
    region) The region in which the container exists.
    ContainerId string
    The unique identifier of the container.
    Hostname string
    The hostname with a CNAME record.
    Region string
    region) The region in which the container exists.
    containerId String
    The unique identifier of the container.
    hostname String
    The hostname with a CNAME record.
    region String
    region) The region in which the container exists.
    containerId string
    The unique identifier of the container.
    hostname string
    The hostname with a CNAME record.
    region string
    region) The region in which the container exists.
    container_id str
    The unique identifier of the container.
    hostname str
    The hostname with a CNAME record.
    region str
    region) The region in which the container exists.
    containerId String
    The unique identifier of the container.
    hostname String
    The hostname with a CNAME record.
    region String
    region) The region in which the container exists.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Domain resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Url string
    The URL used to query the container.
    Id string
    The provider-assigned unique ID for this managed resource.
    Url string
    The URL used to query the container.
    id String
    The provider-assigned unique ID for this managed resource.
    url String
    The URL used to query the container.
    id string
    The provider-assigned unique ID for this managed resource.
    url string
    The URL used to query the container.
    id str
    The provider-assigned unique ID for this managed resource.
    url str
    The URL used to query the container.
    id String
    The provider-assigned unique ID for this managed resource.
    url String
    The URL used to query the container.

    Look up Existing Domain Resource

    Get an existing Domain resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: DomainState, opts?: CustomResourceOptions): Domain
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        container_id: Optional[str] = None,
        hostname: Optional[str] = None,
        region: Optional[str] = None,
        url: Optional[str] = None) -> Domain
    func GetDomain(ctx *Context, name string, id IDInput, state *DomainState, opts ...ResourceOption) (*Domain, error)
    public static Domain Get(string name, Input<string> id, DomainState? state, CustomResourceOptions? opts = null)
    public static Domain get(String name, Output<String> id, DomainState state, CustomResourceOptions options)
    resources:  _:    type: scaleway:containers:Domain    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    ContainerId string
    The unique identifier of the container.
    Hostname string
    The hostname with a CNAME record.
    Region string
    region) The region in which the container exists.
    Url string
    The URL used to query the container.
    ContainerId string
    The unique identifier of the container.
    Hostname string
    The hostname with a CNAME record.
    Region string
    region) The region in which the container exists.
    Url string
    The URL used to query the container.
    containerId String
    The unique identifier of the container.
    hostname String
    The hostname with a CNAME record.
    region String
    region) The region in which the container exists.
    url String
    The URL used to query the container.
    containerId string
    The unique identifier of the container.
    hostname string
    The hostname with a CNAME record.
    region string
    region) The region in which the container exists.
    url string
    The URL used to query the container.
    container_id str
    The unique identifier of the container.
    hostname str
    The hostname with a CNAME record.
    region str
    region) The region in which the container exists.
    url str
    The URL used to query the container.
    containerId String
    The unique identifier of the container.
    hostname String
    The hostname with a CNAME record.
    region String
    region) The region in which the container exists.
    url String
    The URL used to query the container.

    Import

    Container domain binding can be imported using {region}/{id}, as shown below:

    bash

    $ pulumi import scaleway:containers/domain:Domain main fr-par/11111111-1111-1111-1111-111111111111

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    scaleway pulumiverse/pulumi-scaleway
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the scaleway Terraform Provider.
    scaleway logo
    Scaleway v1.25.0 published on Saturday, Mar 22, 2025 by pulumiverse
    pulumiverse/pulumi-scaleway