How to Use Docker Swarm Event Discovery

This task contains the following steps:

1. Prerequisites – Set up protocol credentials

   Docker Swarm discovery uses the HTTP Protocol.

   1. Create a new HTTP protocol.

      In the HTTP Protocol Parameters dialog box, select https in the Protocol field.

   2. Right-click the protocol that you just created and select Edit using previous interface.

   3. Configure the Key Store Path, Key Store Password (if needed), and Key Password (if needed).

      • Key Store Path. Specify the full path of the Key Store file.
      • Key Store Password. Specify the password for the Key Store.
      • Key Password. Specify the password for the Key.

      For details, see How to Generate the Key Store File for Docker Swarm Discovery Credential.

      Note: If you do not need the TLS verification in Docker Swarm, skip this step.

   For credential information, see Supported Protocols.

2. Configure the URI endpoint – Edit UriEndpointConfiguration.xml

   1. Go to Data Flow Management > Adapter Management > Resources pane.
   2. Click the Find resource button, enter UriEndpointConfiguration.xml in the Name field, and then click the Find Next button.

   3. In UriEndpointConfiguration.xml, set the proper Data Flow Probe name on which the trigger UriEndpoint runs and set the url and type as follows:

      <dataflowprobe name="<Data Flow Probe name>">
        <uri-endpoint>
          <url>https://<IP address>:<port>/</url>
          <type>docker swarm</type>
        </uri-endpoint>
      </dataflowprobe>

3. Run the discovery

   1. Run Manual UriEndpoint Discovery to discover Docker Swarm UriEndpoint.
   2. Run Docker Swarm Discovery by RESTful API to discover Docker Swarm Topology.
   3. Run Docker Swarm Event Monitor to monitor Docker Swarm events.

   4. Wait for the Docker Swarm events.

   For details on running jobs, refer to "Module/Job-Based Discovery" in the Data Flow Management section of the UCMDB Help.