swagger.yaml

openapi: 3.0.0
info:
  title: gnomock
  description: >
    `gnomock` is an HTTP wrapper for
    [Gnomock](https://github.com/orlangure/gnomock) integration and end-to-end
    testing toolkit. It allows to use Gnomock outside of Go ecosystem. Not all
    Gnomock features exist in this wrapper, but official presets, as well as
    basic general configuration, are supported.
  version: 1.20.0
  contact:
    url: https://github.com/orlangure/gnomock/
  license:
    name: MIT
    url: https://github.com/orlangure/gnomock/blob/master/LICENSE

paths:
  /start/localstack:
    post:
      summary: Start a new Gnomock Localstack container
      operationId: startLocalstack
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/localstack-request'
      responses:
        '200':
          $ref: '#/components/responses/container-created'
        '400':
          $ref: '#/components/responses/invalid-configuration'
        '500':
          $ref: '#/components/responses/start-failed'
      tags:
        - presets

  /start/mongo:
    post:
      summary: Start a new Gnomock MongoDB container
      operationId: startMongo
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/mongo-request'
      responses:
        '200':
          $ref: '#/components/responses/container-created'
        '400':
          $ref: '#/components/responses/invalid-configuration'
        '500':
          $ref: '#/components/responses/start-failed'
      tags:
        - presets

  /start/mssql:
    post:
      summary: Start a new Gnomock Microsoft SQL Server container
      operationId: startMssql
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/mssql-request'
      responses:
        '200':
          $ref: '#/components/responses/container-created'
        '400':
          $ref: '#/components/responses/invalid-configuration'
        '500':
          $ref: '#/components/responses/start-failed'
      tags:
        - presets

  /start/mysql:
    post:
      summary: Start a new Gnomock MySQL container
      operationId: startMysql
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/mysql-request'
      responses:
        '200':
          $ref: '#/components/responses/container-created'
        '400':
          $ref: '#/components/responses/invalid-configuration'
        '500':
          $ref: '#/components/responses/start-failed'
      tags:
        - presets

  /start/mariadb:
    post:
      summary: Start a new Gnomock MariaDB container
      operationId: startMariadb
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/mariadb-request'
      responses:
        '200':
          $ref: '#/components/responses/container-created'
        '400':
          $ref: '#/components/responses/invalid-configuration'
        '500':
          $ref: '#/components/responses/start-failed'
      tags:
        - presets
  /start/postgres:
    post:
      summary: Start a new Gnomock Postgres container
      operationId: startPostgres
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/postgres-request'
      responses:
        '200':
          $ref: '#/components/responses/container-created'
        '400':
          $ref: '#/components/responses/invalid-configuration'
        '500':
          $ref: '#/components/responses/start-failed'
      tags:
        - presets
  /start/redis:
    post:
      summary: Start a new Gnomock Redis container
      operationId: startRedis
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/redis-request'
      responses:
        '200':
          $ref: '#/components/responses/container-created'
        '400':
          $ref: '#/components/responses/invalid-configuration'
        '500':
          $ref: '#/components/responses/start-failed'
      tags:
        - presets
  /start/memcached:
    post:
      summary: Start a new Gnomock Memcached container
      operationId: startMemcached
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/memcached-request'
      responses:
        '200':
          $ref: '#/components/responses/container-created'
        '400':
          $ref: '#/components/responses/invalid-configuration'
        '500':
          $ref: '#/components/responses/start-failed'
      tags:
        - presets
  /start/splunk:
    post:
      summary: Start a new Gnomock Splunk container
      operationId: startSplunk
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/splunk-request'
      responses:
        '200':
          $ref: '#/components/responses/container-created'
        '400':
          $ref: '#/components/responses/invalid-configuration'
        '500':
          $ref: '#/components/responses/start-failed'
      tags:
        - presets
  /start/rabbitmq:
    post:
      summary: Start a new Gnomock RabbitMQ container
      operationId: startRabbitMq
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/rabbitmq-request'
      responses:
        '200':
          $ref: '#/components/responses/container-created'
        '400':
          $ref: '#/components/responses/invalid-configuration'
        '500':
          $ref: '#/components/responses/start-failed'
      tags:
        - presets
  /start/kafka:
    post:
      summary: Start a new Gnomock Kafka container
      operationId: startKafka
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/kafka-request'
      responses:
        '200':
          $ref: '#/components/responses/container-created'
        '400':
          $ref: '#/components/responses/invalid-configuration'
        '500':
          $ref: '#/components/responses/start-failed'
      tags:
        - presets
  /start/elastic:
    post:
      summary: Start a new Gnomock Elasticsearch container
      operationId: startElastic
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/elastic-request'
      responses:
        '200':
          $ref: '#/components/responses/container-created'
        '400':
          $ref: '#/components/responses/invalid-configuration'
        '500':
          $ref: '#/components/responses/start-failed'
      tags:
        - presets
  /start/kubernetes:
    post:
      summary: >
        Start a new Gnomock lightweight kubernetes (k3s) preset. Use
        `host:<kubeconfig-port>/kubeconfig` to retrieve the kubeconfig file
        that should be used to connect to this container.
      operationId: startKubernetes
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/kubernetes-request'
      responses:
        '200':
          $ref: '#/components/responses/container-created'
        '400':
          $ref: '#/components/responses/invalid-configuration'
        '500':
          $ref: '#/components/responses/start-failed'
      tags:
        - presets

  /start/cockroachdb:
    post:
      summary: Start a new Gnomock CockroachDB preset.
      operationId: startCockroachDB
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/cockroachdb-request'
      responses:
        '200':
          $ref: '#/components/responses/container-created'
        '400':
          $ref: '#/components/responses/invalid-configuration'
        '500':
          $ref: '#/components/responses/start-failed'
      tags:
        - presets

  /start/influxdb:
    post:
      summary: Start a new Gnomock InfluxDB preset.
      operationId: startInfluxDB
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/influxdb-request'
      responses:
        '200':
          $ref: '#/components/responses/container-created'
        '400':
          $ref: '#/components/responses/invalid-configuration'
        '500':
          $ref: '#/components/responses/start-failed'
      tags:
        - presets

  /start/cassandra:
    post:
      summary: Start a new Gnomock Cassandra preset.
      operationId: startCassandra
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/cassandra-request'
      responses:
        '200':
          $ref: '#/components/responses/container-created'
        '400':
          $ref: '#/components/responses/invalid-configuration'
        '500':
          $ref: '#/components/responses/start-failed'
      tags:
        - presets

### /start/preset

  /stop:
    post:
      summary: Stop an existing Gnomock container
      operationId: stop
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/stop-request'
      responses:
        '200':
          description: Container stopped successfully
        '400':
          description: Invalid stop request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/invalid-stop-request'
        '500':
          description: Stop failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stop-failed'
      tags:
        - presets

components:
  schemas:
    container:
      type: object
      properties:
        id:
          description: Container ID
          type: string
          example: f5d08dc84421
        host:
          description: Host of bound ports
          type: string
          default: localhost
        ports:
          $ref: '#/components/schemas/named-ports'
      description: >
        This object is a Gnomock wrapper of a regular docker container. It uses
        the same container ID as docker, and adds bound ports information.

    named-ports:
      type: object
      example:
        api:
          protocol: tcp
          port: 35973
      additionalProperties:
        type: object
        properties:
          protocol:
            description: Protocol of bound port
            type: string
            example: tcp
          port:
            description: Port number on host machine
            type: integer
            example: 35973
      description: >
        A map of port bindings of a Gnomock container. Human readable names are
        used to make the values readable. `port` value is an actual port
        exposed on the host; use this port to connect to the container.

    invalid-start-request:
      type: object
      properties:
        error:
          type: string
      description: >
        This error usually means that the request schema was invalid, or there
        were missing/incorrect/unsupported values.

    start-failed:
      type: object
      properties:
        error:
          type: string
      description: >
        This error means that Gnomock attempted to start a new container, but
        failed somewhere during the process. It is possible that image took too
        long to download, or there was an issue with container configuration.

    stop-failed:
      type: object
      properties:
        error:
          type: string
      description: >
        This error means that Gnomock couldn't stop the requested container. It
        is possible that the ID is incorrect, or that there is something wrong
        with docker daemon.

    invalid-stop-request:
      type: object
      properties:
        error:
          type: string
      description: >
        This error means that the provided `/stop` request was invalid.

    options:
      type: object
      properties:
        timeout:
          type: integer
          format: int64
          description: Wait timeout in nanoseconds
          default: 300000000000
          example: 60000000000
        env:
          type: array
          description: Array of environment variables to set in the container
          items:
            type: string
            example: ENV_VAR_NAME=some-value
        debug:
          type: boolean
          description: Set to true to see logs inside the Gnomock container
          default: false
        container_name:
          type: string
          description: >
            Use a specific container name instead of a random one. In case a
            container with this name already exists, it is killed and replaced
            by a new container.
          example: gnomock
        privileged:
          type: boolean
          description: Runs a container in privileged mode.
        cmd:
          type: array
          description: Command and its arguments to execute on container startup.
          items:
            type: string
        disable_cleanup:
          type: boolean
          description: Disables auto removal of this container after tests.
        use_local_images_first:
          type: boolean
          description: If possible to avoid hitting the Docker Hub pull rate limit.
        custom_named_ports:
          $ref: '#/components/schemas/named-ports'
        auth:
          type: string
          description: >
            base64 encoded JSON string with docker access credentials. JSON
            string should include two fields, username and password. For Docker
            Hub, if 2FA authentication is enabled, an access token should be
            used instead of a password.
          example: eyJ1c2VybmFtZSI6ImZvbyIsInBhc3N3b3JkIjoiYmFyIn0K
      description: >
        This object includes general Gnomock configuration, similar to all
        presets. Timeout configuration is especially useful for
        troubleshooting.

    localstack-request:
      type: object
      properties:
        preset:
          $ref: '#/components/schemas/localstack'
        options:
          $ref: '#/components/schemas/options'
      description: >
        This request includes Localstack and general configuration.

    localstack:
      type: object
      properties:
        services:
          type: array
          description: A list of localstack services to start
          example:
            - s3
            - ses
          items:
            type: string
            example: s3
            enum:
              - apigateway
              - cloudformation
              - cloudwatch
              - logs
              - events
              - dynamodb
              - dynamodbstreams
              - ec2
              - es
              - firehose
              - iam
              - kinesis
              - kms
              - lambda
              - redshift
              - route53
              - s3
              - secretsmanager
              - ses
              - sns
              - sqs
              - ssm
              - sts
              - stepfunctions
        s3_path:
          type: string
          description: >
            Path to folder to setup initial S3 state. Top level folders are
            used as buckets; all child folders and files are uploaded as-is
          example: /home/gnomock/project/testdata/s3
        version:
          type: string
          description: Docker image tag (version)
          default: latest
      required:
        - services
      example:
        services:
          - s3
      description: >
        This object describes Localstack container.

    mongo-request:
      type: object
      properties:
        preset:
          $ref: '#/components/schemas/mongo'
        options:
          $ref: '#/components/schemas/options'
      description: >
        This request includes MongoDB and general configuration.

    mongo:
      type: object
      properties:
        data_path:
          description: >
            Path to folder to setup initial container state. Each top level
            folder maps to a database, every separate file under it is a
            collection, and every line is a document in that collection.
          type: string
          example: /home/gnomock/project/testdata/mongo/data
        user:
          type: string
          description: Username to create inside the container.
          example: gnomock
        password:
          type: string
          description: Password to set for the created user.
          example: p@s$w0rD
        version:
          type: string
          description: Docker image tag (version)
          default: latest
      description: >
        This object describes MongoDB container.

    mssql-request:
      type: object
      properties:
        preset:
          $ref: '#/components/schemas/mssql'
        options:
          $ref: '#/components/schemas/options'
      description: >
        This request includes Microsoft SQL Server and general configuration.

    mssql:
      type: object
      properties:
        db:
          type: string
          description: Database name to create.
          example: mydb
          default: mydb
        password:
          type: string
          description: Superuser password.
          example: p@s$w0rD
          default: Gn0m!ck~
        queries:
          type: array
          description: >
            A list of queries to execute while setting up the container.
          items:
            type: string
          example:
            - create table foo(bar int)
            - insert into foo(bar) values(1)
        queries_files:
          type: array
          items:
            type: string
          description: SQL files to execute while setting up container state.
          example:
            - /home/gnomock/project/testdata/mssql/queries.sql
        license:
          type: boolean
          description: Accept or decline Microsoft SQL Server license.
          example: true
        version:
          type: string
          description: Docker image tag (version)
          default: latest
      required:
        - license
      description: >
        This object describes Microsoft SQL Server container.

    mysql-request:
      type: object
      properties:
        preset:
          $ref: '#/components/schemas/mysql'
        options:
          $ref: '#/components/schemas/options'
      description: >
        This request includes MySQL and general configuration.

    mysql:
      type: object
      properties:
        db:
          type: string
          description: Database name to create.
          example: mydb
          default: mydb
        user:
          type: string
          description: User to create in the container.
          example: gnomock
          default: gnomock
        password:
          type: string
          description: New user's password.
          example: p@s$w0rD
          default: gnomick
        queries:
          type: array
          description: >
            A list of queries to execute while setting up the container.
          items:
            type: string
          example:
            - create table foo(bar int)
            - insert into foo(bar) values(1)
        queries_files:
          type: array
          items:
            type: string
          description: SQL files to execute while setting up container state.
          example:
            - /home/gnomock/project/testdata/mysql/queries.sql
        version:
          type: string
          description: Docker image tag (version)
          default: latest
      description: >
        This object describes MySQL container.

    mariadb-request:
      type: object
      properties:
        preset:
          $ref: '#/components/schemas/mariadb'
        options:
          $ref: '#/components/schemas/options'
      description: >
        This request includes MariaDB and general configuration.

    mariadb:
      type: object
      properties:
        db:
          type: string
          description: Database name to create.
          example: mydb
          default: mydb
        user:
          type: string
          description: User to create in the container.
          example: gnomock
          default: gnomock
        password:
          type: string
          description: New user's password.
          example: p@s$w0rD
          default: gnoria
        queries:
          type: array
          description: >
            A list of queries to execute while setting up the container.
          items:
            type: string
          example:
            - create table foo(bar int)
            - insert into foo(bar) values(1)
        queries_files:
          type: array
          items:
            type: string
          description: SQL files to execute while setting up container state.
          example:
            - /home/gnomock/project/testdata/mysql/queries.sql
        version:
          type: string
          description: Docker image tag (version)
          default: latest
      description: >
        This object describes MariaDB container.

    postgres-request:
      type: object
      properties:
        preset:
          $ref: '#/components/schemas/postgres'
        options:
          $ref: '#/components/schemas/options'
      description: >
        This request includes Postgres and general configuration.

    postgres:
      type: object
      properties:
        db:
          type: string
          description: Database name to create. By default, `postgres` is used.
          example: mydb
        user:
          type: string
          description: >
            User to create in the container. By default, `postgres` is used
            with password `password`.
          example: gnomock
        password:
          type: string
          description: New user's password.
          example: p@s$w0rD
        queries:
          type: array
          description: >
            A list of queries to execute while setting up the container.
          items:
            type: string
          example:
            - create table foo(bar int)
            - insert into foo(bar) values(1)
        queries_files:
          type: array
          items:
            type: string
          description: SQL files to execute while setting up container state.
          example:
            - /home/gnomock/project/testdata/postgres/queries.sql
        timezone:
          type: string
          description: The timezone in the container.
          example: Europe/Paris
        version:
          type: string
          description: Docker image tag (version)
          default: latest
      description: >
        This object describes Postgres container.

    redis-request:
      type: object
      properties:
        preset:
          $ref: '#/components/schemas/redis'
        options:
          $ref: '#/components/schemas/options'
      description: >
        This request includes Redis and general configuration.

    redis:
      type: object
      properties:
        values:
          type: object
          description: A list of key/value pairs to create in the container.
          example:
            foo: bar
            baz: 42
            meh: 3.14
        version:
          type: string
          description: Docker image tag (version)
          default: latest
      description: >
        This object describes Redis container.

    memcached-request:
      type: object
      properties:
        preset:
          $ref: '#/components/schemas/memcached'
        options:
          $ref: '#/components/schemas/options'
      description: >
        This request includes Memcached and general configuration.

    memcached:
      type: object
      properties:
        values:
          type: object
          description: A list of key/value pairs to create in the container.
          example:
            computer: hal9000
        byteValues:
          type: object
          description: A list of key/value pairs to create in the container. Values are base64 strings.
          example:
            foo: YmFy
            baz: NDI=
            meh: My4xNA==
        version:
          type: string
          description: Docker image tag (version)
          default: latest
      description: >
        This object describes Memcached container.

    splunk-request:
      type: object
      properties:
        preset:
          $ref: '#/components/schemas/splunk'
        options:
          $ref: '#/components/schemas/options'
      description: >
        This request includes Splunk and general configuration.

    splunk:
      type: object
      properties:
        values:
          type: array
          description: A list of events to ingest into the container.
          items:
            type: object
            properties:
              event:
                type: string
                example: something happened
              index:
                type: string
                example: main
              source:
                type: string
                example: web
              sourcetype:
                type: string
                example: http
              time:
                type: number
                format: double
                description: timestamp in seconds (or milli-, micro- or nanoseconds)
                example: 1588269752
            required:
              - event
              - index
              - source
              - sourcetype
              - time
        values_file:
          type: string
          description: >
            File name with events to ingest into Splunk. Use JSON Lines format
            (every event is a separate JSON object), each new event starts from
            a new line.
          example: /home/gnomock/project/testdata/splunk/events.jsonl
        accept_license:
          type: boolean
          description: Accept or decline Splunk license.
          example: true
        admin_password:
          type: string
          description: Set a password for `admin` user.
          example: p@s$w0rD
        version:
          type: string
          description: Splunk version.
          default: latest
          example: 8.0.2.1
      required:
        - accept_license
        - admin_password
      description: >
        This object describes Splunk container.

    rabbitmq-request:
      type: object
      properties:
        preset:
          $ref: '#/components/schemas/rabbitmq'
        options:
          $ref: '#/components/schemas/options'
      description: >
        This request includes RabbitMQ and general configuration.

    rabbitmq:
      type: object
      properties:
        user:
          type: string
          description: Set a user name
          example: gnomock
          default: guest
        password:
          type: string
          description: Set a password for a created user
          example: p@s$w0rD
          default: guest
        version:
          type: string
          description: RabbitMQ version.
          default: 3.8.5-alpine
          example: latest
        messages:
          type: array
          description: A list of messages to send to RabbitMQ
          items:
            $ref: '#/components/schemas/rabbitmqMessage'
        messages_files:
          type: array
          items:
            type: string
      description: >
        This object describes a RabbitMQ container.

    rabbitmqMessage:
      type: object
      properties:
        queue:
          type: string
          example: alerts
        content_type:
          type: string
          example: text/plain
        string_body:
          type: string
          example: high cpu
        body:
          type: string
          format: byte

    kafka-request:
      type: object
      properties:
        preset:
          $ref: '#/components/schemas/kafka'
        options:
          $ref: '#/components/schemas/options'
      description: >
        This request includes Kafka and general configuration.

    kafka:
      type: object
      properties:
        messages:
          type: array
          description: A list of messages to send to Kafka.
          items:
            type: object
            properties:
              topic:
                type: string
                example: alerts
              key:
                type: string
                example: cpu
              value:
                type: string
                example: "high"
              time:
                type: number
                format: double
                description: timestamp in seconds
                example: 1588269752
            required:
              - topic
              - key
              - value
        messages_files:
          type: array
          items:
            type: string
        topics:
          type: array
          items:
            type: string
          description: Topic names to create in Kafka.
          example:
            - alerts
            - events
        version:
          type: string
          description: Kafka version.
          default: 2.5.1-L0
          example: latest
        use_schema_registry:
          type: boolean
          description: Set to true to wait for schema registry on startup
          default: false
      description: >
        This object describes a Kafka container.

    elastic-request:
      type: object
      properties:
        preset:
          $ref: '#/components/schemas/elastic'
        options:
          $ref: '#/components/schemas/options'
      description: >
        This request includes Elasticsearch and general configuration.

    elastic:
      type: object
      properties:
        input_files:
          type: array
          items:
            type: string
          description: >
            A list of files to ingest into Elasticsearch. File names are used
            as index names. Contents of the files need to be JSON objects
            placed one after the other.
        version:
          type: string
          description: Elasticsearch version.
          default: 7.9.2
          example: latest
      description: >
        This object describes a Elasticsearch container.

    kubernetes-request:
      type: object
      properties:
        preset:
          $ref: '#/components/schemas/kubernetes'
        options:
          $ref: '#/components/schemas/options'
      description: >
        This request includes k3s and general configuration.

    kubernetes:
      type: object
      properties:
        version:
          type: string
          description: >
            k3s version (see
            https://hub.docker.com/repository/docker/orlangure/k3s)
          default: latest
          example: latest
      description: >
        This object describes a k3s container.

    cockroachdb-request:
      type: object
      properties:
        preset:
          $ref: '#/components/schemas/cockroachdb'
        options:
          $ref: '#/components/schemas/options'
      description: >
        This request includes CockroachDB and general configuration.

    cockroachdb:
      type: object
      properties:
        version:
          type: string
          description: Docker image tag (version)
          default: latest
      description: >
        This object describes CockroachDB container.

    influxdb-request:
      type: object
      properties:
        preset:
          $ref: '#/components/schemas/influxdb'
        options:
          $ref: '#/components/schemas/options'
      description: >
        This request includes InfluxDB and general configuration.

    influxdb:
      type: object
      properties:
        version:
          type: string
          description: Docker image tag (version)
          default: latest
        username:
          type: string
          description: Super-user name
          default: gnomock
        password:
          type: string
          description: Super-user password
          default: gnomock-password
        org:
          type: string
          description: Organization name
          default: gnomock-org
        bucket:
          type: string
          description: Default bucket name
          default: gnomock-bucket
        auth_token:
          type: string
          description: Database authentication token
          default: gnomock-influxdb-token
      description: >
        This object describes InfluxDB container.

    cassandra-request:
      type: object
      properties:
        preset:
          $ref: '#/components/schemas/cassandra'
        options:
          $ref: '#/components/schemas/options'
      description: >
        This request includes Cassandra and general configuration.

    cassandra:
      type: object
      properties:
        version:
          type: string
          description: Docker image tag (version)
          default: latest
      description: >
        This object describes Cassandra container.

### preset-request

    stop-request:
      type: object
      properties:
        id:
          type: string
          example: f5d08dc84421
      description: >
        Stop request asks Gnomock to stop a container.

  responses:
    container-created:
      description: Container created successfully
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/container'
    invalid-configuration:
      description: Invalid container configuration
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/invalid-start-request'
    start-failed:
      description: Start failed
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/start-failed'
tags:
  - name: presets
    description: >
      `/start` endpoints allow to create temporary docker containers using the
      provided configuration. Each preset has its own configuration schema.
servers:
  - url: http://127.0.0.1:{port}/
    description: >
      `gnomock` runs locally in an environment with a configured docker
      daemon.
    variables:
      port:
        default: "23042"