Troubleshooting

This guide helps you debug and resolve common issues when using Conjure.

Check which config file is being used:

conjure list

Output shows:

Using config file: /path/to/.conjure.yaml

# Install yamllint
pip install yamllint

# Check values file
yamllint ./values/production.yaml

# Check config file
yamllint ~/.conjure.yaml

Error message:

Error: config file not found

Cause: No .conjure.yaml in home directory or specified via --config.

Solution: Create ~/.conjure.yaml or pass a configuration file with the --config flag.

Error message:

Error: schema_version field is required (see documentation for migration from metadata_version)

Cause: Template or bundle metadata is missing the schema_version field.

Solution:

Add schema_version field to your metadata file:

For templates:

{
  "schema_version": "v1",
  "template_name": "deployment.yaml",
  "template_description": "Template description",
  "variables": []
}

For bundles:

{
  "schema_version": "v1",
  "bundle_type": "kubernetes",
  "bundle_name": "web-app",
  "bundle_description": "Bundle description",
  "shared_variables": [],
  "template_variables": {}
}

Error message:

Error: unsupported schema_version: v2 (only 'v1' is supported)

Cause: The schema_version field contains an unsupported version.

Solution:

Change schema_version to "v1":

{
  "schema_version": "v1"
}

Note

Default values are always strings in JSON, but Conjure validates they can be converted to the declared type.

Error message:

Error: required flag(s) "output" not set

Cause: Missing -o flag.

Solution:

Always specify output directory:

conjure bundle web-app -o ./output

Error message:

Error: failed to parse values file: yaml: line 10: mapping values are not allowed in this context

Cause: YAML syntax error in values file.

Common issues:

# Bad - missing space after colon
app_name:my-app

# Bad - wrong indentation
template_overrides:
deployment.yaml.tmpl:
  replicas: 10

# Bad - tabs instead of spaces
template_overrides:
→deployment.yaml.tmpl:  # Tab character
  →replicas: 10

# Good
app_name: my-app

template_overrides:
  deployment.yaml.tmpl:
    replicas: 10

Solution:

Use YAML validator:

yamllint ./values/production.yaml

Compare the version in use against the release notes.

conjure --version