Portainer icon

Portainer

Interact with Portainer via API

Actions190

Kubernetes → Update Kubernetes Ingress Controllers

AI-generated

Overview

This node operation updates Kubernetes Ingress Controllers by sending new configuration data to a specified environment. It is useful when you need to modify or replace the ingress controller settings in a Kubernetes cluster, such as changing routing rules, TLS settings, or load balancing configurations.

Practical examples include:

  • Updating ingress controllers after deploying new services that require different routing.
  • Modifying TLS certificates or security settings for ingress traffic.
  • Automating ingress controller updates as part of a CI/CD pipeline.

Properties

Name Meaning
Id The numeric identifier of the Kubernetes environment where the ingress controllers will be updated. This identifies the target cluster or environment.
Body A JSON string representing the ingress controllers configuration to apply. This should contain the full desired state of the ingress controllers.

Output

The node outputs JSON data reflecting the response from the update operation on the Kubernetes ingress controllers. This typically includes status information about the update request, confirmation of changes applied, or error details if the update failed.

No binary data output is indicated.

Dependencies

  • Requires an API key credential to authenticate with the Kubernetes management service.
  • The node depends on connectivity to the Kubernetes environment identified by the provided Id.
  • Proper permissions are needed to update ingress controllers in the target Kubernetes cluster.

Troubleshooting

  • Invalid Id: If the environment identifier does not correspond to a valid Kubernetes environment, the update will fail. Verify the Id is correct.
  • Malformed Body: The body must be a valid JSON string representing ingress controllers. Invalid JSON or incorrect schema will cause errors.
  • Authentication Errors: Ensure the API key credential is valid and has sufficient permissions.
  • Network Issues: Connectivity problems to the Kubernetes API endpoint can cause timeouts or failures.
  • API Limitations: The Kubernetes API may reject updates if they violate cluster policies or resource constraints.

Links and References

Discussion