fresh-angle-76971
08/19/2025, 11:47 AMgarden deploy
?
ℹ deploy.tailscale-operator → Deploying tailscale-operator (type helm) at version v-9f42f2e248...
✖ deploy.tailscale-operator → Failed (took 6.3 sec)
✖ deploy.tailscale-operator → Failed processing Deploy type=helm name=tailscale-operator (took 8.23 sec). This is what happened:
─────────────────────────────────────────
Command "/Users/spike/.garden/tools/helm/0dc3c32729046d4e/darwin-arm64/helm --kube-context kubernetes-admin@huudot-test-cluster --kubeconfig /Users/spike/gits/work/huudot.git/main/iac/infra/kubeconfig.yaml --namespace tailscale install tailscale-operator tailscale-operator --repo https://pkgs.tailscale.com/helmcharts --dry-run --namespace tailscale --output json --timeout 300s --values /private/var/folders/1y/httmdjmd02qf57f9zd3py6kw0000gn/T/113b7979b6cec659e9bc40edeee803a5" failed with code 1:
Error: INSTALLATION FAILED: file '/Users/spike/Library/Caches/helm/repository/tailscale-operator-1.86.2-1753978303-9f1ee41e298aac17db343df700f412b84d349962fbb0f680b102fa5e2c1453fd.tgz' does not appear to be a gzipped archive; got 'application/octet-stream'
microscopic-river-74022
08/19/2025, 11:47 AMmicroscopic-river-74022
08/19/2025, 11:47 AMError: INSTALLATION FAILED: file '/Users/spike/Library/Caches/helm/repository/tailscale-operator-1.86.2-1753978303-9f1ee41e298aac17db343df700f412b84d349962fbb0f680b102fa5e2c1453fd.tgz' does not appear to be a gzipped archive; got 'application/octet-stream'
indicates that Helm is trying to use a file that it expects to be a gzipped Helm chart archive (.tgz
), but the file is either not a valid archive or is corrupted.
Based on the Garden documentation, when deploying a Helm chart using Garden, you typically specify the chart using either the url
, repo
, or name
fields under spec.chart
in your module configuration. Garden then uses Helm under the hood to fetch and install the chart. If the chart cannot be fetched or is not a valid archive, Helm will fail with an error similar to what you are seeing.
Possible causes based on the knowledge sources:
- The chart file downloaded from the repository may be corrupted or not a valid Helm chart archive.
- There may be an issue with the Helm repository itself, or with how the chart is referenced in your Garden configuration.
- The repo
field should point to a valid Helm chart repository, and the name
field should specify the chart name. For example:
yaml
kind: Deploy
type: helm
name: tailscale-operator
spec:
chart:
name: tailscale-operator
repo: <https://pkgs.tailscale.com/helmcharts>
version: "1.86.2"
This is the recommended way to reference a chart from a Helm repository in Garden. If you are using the url
field, ensure it points directly to a valid .tgz
Helm chart archive, not to a web page or an invalid file type [Installing Helm charts]().microscopic-river-74022
08/19/2025, 11:47 AMmicroscopic-river-74022
08/19/2025, 11:47 AMfresh-angle-76971
08/19/2025, 11:50 AMkind: Deploy
type: helm
name: tailscale-operator
description: Install Tailscale Operator to the Kubernetes cluster
spec:
namespace: tailscale
chart:
name: tailscale-operator
repo: https://pkgs.tailscale.com/helmcharts
microscopic-river-74022
08/19/2025, 11:50 AMmicroscopic-river-74022
08/19/2025, 11:50 AMyaml
kind: Deploy
type: helm
name: tailscale-operator
description: Install Tailscale Operator to the Kubernetes cluster
spec:
namespace: tailscale
chart:
name: tailscale-operator
repo: <https://pkgs.tailscale.com/helmcharts>
However, based on the error you received, the issue is likely related to the chart version. When specifying a chart from a Helm repository, it is recommended (and often required) to also specify the version
field under chart
. Without a version, Helm may not fetch the correct chart archive, which can result in the kind of error you are seeing (“does not appear to be a gzipped archive”) [Reference: Action-types > Deploy > helm > spec.chart]().
How to fix:
Add the version
field to your chart
specification. For example:
yaml
spec:
namespace: tailscale
chart:
name: tailscale-operator
repo: <https://pkgs.tailscale.com/helmcharts>
version: "1.86.2" # Replace with the actual version you want to use
This matches the documented approach for referencing charts from a Helm repository [Installing Helm charts]().
Summary:
Add the version
field to your chart
block. This should resolve the error, provided the version exists in the repository and is a valid Helm chart archive.
If you continue to see the error after specifying the version, try clearing your Helm cache and re-running the deployment, as a corrupted download can also cause this issue.
----------------------
Note: you can ask me a follow up question by @ mentioning me again :speech_balloon:
----------------------microscopic-river-74022
08/19/2025, 11:50 AM