Docker

Following these steps, vScope will inventory Docker assets, providing visibility and insights into configurations and statuses of containers and images within your vScope platform.

Note

The following guide is applicable for Linux distributions using systemd.

---

Configure the Docker Service

Create a file at /etc/systemd/system/docker.service.d/startup_options.conf with the following content. The default Docker port for vScope is 4243:

/etc/systemd/system/docker.service.d/override.conf

[Service]
ExecStart=
ExecStart=/usr/bin/dockerd -H fd:// -H tcp://0.0.0.0:4243

Note

The -H flag configures how the Docker daemon binds the API. For more details, refer to the daemon socket option documentation.

---

Reload the Unit Files

After creating the configuration file, reload the systemd unit files to apply the new Docker service configuration:

$ sudo systemctl daemon-reload

---

Restart the Docker Daemon

Restart the Docker daemon to apply the new configuration settings specified in your startup_options.conf file:

$ sudo systemctl restart docker.service

This command restarts Docker with the specified API binding options, including the custom port (4243 by default) for vScope integration.

---

Set User Permissions

To securely manage Docker access, ensure that only trusted users are permitted to interact with Docker, as access to the Docker daemon confers root-level permissions. Verify that only authorized users are part of the Docker group:

$ sudo usermod -aG docker <username>

For detailed instructions on managing Docker permissions, see Docker post-install steps on Linux.

---

Configure Docker Credentials in vScope

1. In vScope, navigate to Discovery Manager and click on + Credential. From the available credential types, select Docker.

   

2. Choose User and Password as the credential method, then enter the username and password for a user who is a member of the Docker group on the system hosting the Docker engine.

   Note

   If you specified a non-default port in the Docker daemon configuration, input this port under Advanced Options in vScope to ensure correct connectivity.

   

3. Once the credential details are filled out, click Save.

4. To confirm the connection, you can click Test Credential. If successful, the credential will be ready for use in vScope’s discovery process.

---

Run Discovery for Docker Assets

With the Docker credential configured, initiate a discovery to allow vScope to inventory your Docker environment:

1. In Discovery Manager, select Start Discovery or run a targeted discovery for Docker assets by specifying the Docker credential.

2. After the discovery completes, browse Library > Tables or Dashboards to view information about containers, images, and Docker engines in vScope.