Helm

Ce guide connecte Helm — le gestionnaire de paquets CNCF pour Kubernetes — à RustFS via le plugin helm-s3, pour qu'un bucket RustFS devienne un dépôt privé de charts. Vous allez initialiser le dépôt dans le bucket, pousser un chart empaqueté, puis ajouter le dépôt à Helm et rapatrier le chart. Le workflow a été vérifié avec alpine/helm:3.16.4 et helm-s3 v0.17.2 sur un bucket RustFS.

Vous avez besoin de Docker. Ce déploiement est destiné aux tests d'intégration locaux, pas à la production.

ArchitectureCopy Anchor Link

Le préfixe du bucket contient index.yaml et un fichier .tgz par version de chart. Helm le lit et l'écrit via le plugin, donc le dépôt est accessible partout où RustFS l'est.

cd /tmp
wget -q https://github.com/hypnoglow/helm-s3/releases/download/v0.17.2/helm-s3_0.17.2_linux_amd64.tar.gz
mkdir -p helm-s3 && tar -xzf helm-s3_0.17.2_linux_amd64.tar.gz -C helm-s3
helm plugin install helm-s3

export AWS_ENDPOINT=<your-rustfs-endpoint>:9000
export AWS_DISABLE_SSL=true
export AWS_ACCESS_KEY_ID=<your-access-key>
export AWS_SECRET_ACCESS_KEY=<your-secret-key>
export AWS_DEFAULT_REGION=us-east-1

helm s3 init s3://my-bucket/charts

Initialized empty repository at s3://my-bucket/charts

helm repo add rustfs-charts s3://my-bucket/charts

helm create demo
helm package demo
helm s3 push ./demo-0.1.0.tgz rustfs-charts

Successfully uploaded the chart to the repository.

helm repo update
helm search repo rustfs-charts/demo

NAME              	CHART VERSION	APP VERSION	DESCRIPTION
rustfs-charts/demo	0.1.0        	1.16.0     	A Helm chart for Kubernetes

helm pull rustfs-charts/demo --destination ./pullback
tar -tzf ./pullback/demo-0.1.0.tgz | head -2

demo/Chart.yaml
demo/values.yaml

aws s3 rm s3://my-bucket/charts --recursive \
  --endpoint-url http://<your-rustfs-endpoint>:9000

DépannageCopy Anchor Link

head s3 object: Forbidden sur helm s3 initCopy Anchor Link

Le plugin utilise l'adressage virtual-hosted — AWS_ENDPOINT et AWS_DISABLE_SSL ne sont pas définis. Exportez-les exactement comme à l'étape 1.

check if index exists in the storage échoue avec une erreur gitCopy Anchor Link

L'image n'a pas de git, donc helm plugin install <git-url> ne peut pas cloner. Installez depuis l'archive de version comme à l'étape 1.

The index file already exists under the provided URICopy Anchor Link

Le préfixe du dépôt a déjà été initialisé. Relancez avec helm s3 init --ignore-if-exists s3://my-bucket/charts, ou passez --force pour remplacer l'index.

repo with name s3://... not found à la pousséeCopy Anchor Link

helm s3 push attend le nom de dépôt enregistré via helm repo add — utilisez helm s3 push ./demo-0.1.0.tgz rustfs-charts.

couldn't load repositories file pendant la pousséeCopy Anchor Link

Le repositories.yaml de Helm n'existe pas encore dans cet environnement. Exécutez helm repo add rustfs-charts s3://my-bucket/charts avant de pousser.

Prochaines étapesCopy Anchor Link

• Consultez les notes de compatibilité S3 avant d'héberger des dépôts plus volumineux avec de nombreuses versions de charts.
• Créez des identifiants de production dédiés avec la gestion des clés d'accès.
• Suivez la documentation helm-s3 pour la réindexation, la suppression de charts et l'usage CI sur le même bucket.