Skip to content

Documentation needed on DOCKER_HOST behavior change #38118

@sudo-bmitch

Description

@sudo-bmitch

Description

While attempting an update to 18.09.0-beta5, I'm seeing the DOCKER_HOST handling has changed to require tcp:// in front of the URL. This change may break user scripts and should be documented in the release notes. Previous releases were much more relaxed on the parsing of the DOCKER_HOST variable, including 18.06.1.

Steps to reproduce the issue:

export DOCKER_HOST=127.0.0.1:2376
docker info

Describe the results you received:

I'm seeing the below error message from the docker client now:

parse 127.0.0.1:2376: first path segment in URL cannot contain colon

Describe the results you expected:

Successfully connect to the dockerd daemon. Release notes informing the user to change their host variable to include a tcp:// in the beginning, e.g. DOCKER_HOST=tcp://<host_name_or_ip>:<port> would be appropriate if this is a permanent change.

Additional information you deem important (e.g. issue happens only occasionally):

This appears to be a breaking changing in the 18.09 upgrade.

Output of docker version:

Docker engine is not able to start yet (separate issues may be pending). Debian Linux install from Docker's test repo.

$ DOCKER_HOST=tcp://127.0.0.1:2376 docker version
Client:
 Version:           18.09.0-beta5
 API version:       1.39
 Go version:        go1.10.4
 Git commit:        e1910c5
 Built:             Tue Oct 23 22:25:34 2018
 OS/Arch:           linux/amd64
 Experimental:      true
Cannot connect to the Docker daemon at tcp://127.0.0.1:2376. Is the docker daemon running?

Output of docker info:

See above.

Additional environment details (AWS, VirtualBox, physical, etc.):

Local physical machine.

Metadata

Metadata

Assignees

No one assigned

    Labels

    area/cliClientkind/bugBugs are bugs. The cause may or may not be known at triage time so debugging may be needed.version/18.09

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions