Docker

Overview

This node allows users to create a Docker secret via the Portainer API. It is useful in scenarios where you need to securely store sensitive data such as passwords, certificates, or keys within a Docker environment managed by Portainer. By creating secrets programmatically, you can automate deployment workflows and maintain secure configurations without manual intervention.

Practical examples include:

• Automating the creation of secrets during CI/CD pipelines.
• Managing secrets for multiple Docker endpoints from a centralized workflow.
• Integrating secret management into broader infrastructure automation tasks.

Properties

Output

The node outputs the JSON response returned by the Portainer API after creating the secret. This typically includes details about the newly created secret such as its ID, name, creation timestamp, and other metadata.

No binary data output is involved.

Dependencies

• Requires an active connection to a Portainer instance with API access.
• Needs an API authentication token configured in the node credentials to authorize requests.
• The node dynamically loads available Docker endpoints from the Portainer API to populate the "EndpointID" property.

Troubleshooting

• Common issues:

  • Invalid or missing API credentials will cause authentication failures.
  • Providing malformed JSON in the "Body" property may result in request errors.
  • Selecting an invalid or inaccessible endpoint ID will cause the request to fail.

• Error messages and resolutions:

  • 401 Unauthorized: Check that the API key credential is valid and has sufficient permissions.
  • 400 Bad Request: Verify the JSON structure in the "Body" property matches the expected schema for creating a secret.
  • 404 Not Found: Ensure the selected endpoint ID exists and is accessible by the API user.

Links and References

• Portainer API Documentation - Secrets
• n8n Expressions Documentation