ServiceConfig class

<!-- Bug: Type and Name are switched --> Manages the configs of a Docker service in a swarm.

{{% examples %}}

Example Usage

Basic

resource "docker_config" "foo_config" {
  name = "foo_config"
  data = base64encode("{\"a\": \"b\"}")
}

Advanced

Dynamically set config with a template

In this example you can use the ${var.foo_port} variable to dynamically set the ${port} variable in the foo.configs.json.tpl template and create the data of the fooConfig with the help of the base64encode interpolation function.

The file foo.config.json.tpl has the following content:

{
  "server": {
    "public_port": ${port}
  }
}

and the resource uses it as follows:

resource "docker_config" "foo_config" {
  name = "foo_config"
  data = base64encode(
    templatefile("${path.cwd}/foo.config.json.tpl",
      {
        port = 8080
      }
    )
  )
}

Update config with no downtime

To update a config, Terraform will destroy the existing resource and create a replacement. To effectively use a docker.ServiceConfig resource with a docker.Service resource, it's recommended to specify createBeforeDestroy in a lifecycle block. Provide a unique name attribute, for example with one of the interpolation functions uuid or timestamp as shown in the example below. The reason is this issue.

resource "docker_config" "service_config" {
  name = "${var.service_name}-config-${replace(timestamp(), ":", ".")}"
  data = base64encode(
    templatefile("${path.cwd}/foo.config.json.tpl",
      {
        port = 8080
      }
    )
  )

  lifecycle {
    ignore_changes        = ["name"]
    create_before_destroy = true
  }
}

resource "docker_service" "service" {
  # ... other attributes omitted for brevity
  configs {
    config_id   = docker_config.service_config.id
    config_name = docker_config.service_config.name
    file_name   = "/root/configs/configs.json"
  }
}

Import

!/bin/bash

$ pulumi import docker:index/serviceConfig:ServiceConfig foo id

Example

Assuming you created a config as follows

#!/bin/bash
printf '{"a":"b"}' | docker config create foo -
# prints the id
08c26c477474478d971139f750984775a7f019dbe8a2e7f09d66a187c009e66d

you provide the definition for the resource as follows

resource "docker_config" "foo" {
  name = "foo"
  data = base64encode("{\"a\": \"b\"}")
}

then the import command is as follows

!/bin/bash

$ pulumi import docker:index/serviceConfig:ServiceConfig foo 08c26c477474478d971139f750984775a7f019dbe8a2e7f09d66a187c009e66d

{{% /examples %}}