This page contains a list of common errors you may encounter using Humanitec and how to resolve them.

Cannot Retrieve Workloads from CI Pipeline

If your workloads do not appear when you go to add workloads to an environment, even though you have connected your CI pipeline, then please check the following:

  • Have you added the snippet to your pipeline configuration to send the image to Humanitec? Is the YAML formatted properly?

  • Have you added the Humanitec API token as a variable for your repository?

  • Have you triggered a new build after following the previous steps?

If you've done all of this and it still doesn't work, then please contact support.

Deployment Failed (Pre-Configured Humanitec Cluster)

Here are some common reasons why your environment could fail to deploy with Humanitec using the Humanitec-managed cluster.

Kubernetes Connection Error

The Kubernetes connection error may occur if Humanitec fails to connect to the Kubernetes API, or if the connection succeeds but Kubernetes fails to execute the deployment request.

  • Try clicking the deployment button again.

  • If the error persists, then please send a help request.

Broken Pod

When Kubernetes begins to create pods for your workloads, the pod could break due to an improper configuration in the workload's Dockerfile or its configurations.

Check to see if your workload's Dockerfile runs properly. You can see this in the Humanitec interface by going to your app, clicking on the workload, and going to its Logs section.

Failure to Connect to an External Resource

If your app depends on a resource not deployed with Humanitec, such as an external database or API, and Humanitec cannot connect to it, then the deployment will fail.

  • We recommend enabling logging in your app. You can view these logs in the Humanitec interface by going to your app, clicking on the workload, and then going to its Logs section.

Cannot Access Workload at its Public URL

If you exposed your workload with a public URL but get an error when you try to access it, then check the workload's configuration page (i.e., by clicking on it) to see if the ports you exposed match the ones exposed in its Dockerfile.

Features are not available in the UI

If you are not able to see certain features in the Humanitec UI that might be because an ad blocker or other browser setting is interfering with some features on the platform. The reason for this is that Humanitec uses a system called Optimizely for UI feature flags. If you have ad blocking services enabled that block calls to https://cdn.optimizely.com, Optimizely has to be manually removed from the blacklist in your ad-blocking extension or the ad block service has to be disabled in order for you to access all Humanitec features available to you.