Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Translate in french all the doc #1610

Open
wants to merge 15 commits into
base: main
Choose a base branch
from
Open
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Changes from request review
Signed-off-by: Benjamin Fourmaux <49273769+BenjaminFourmaux@users.noreply.github.com>
BenjaminFourmaux committed Jan 26, 2025
commit d0efcca761776d62f28179d3f9af38fb0a15bb36
2 changes: 1 addition & 1 deletion content/fr/docs/chart_template_guide/named_templates.md
Original file line number Diff line number Diff line change
@@ -168,7 +168,7 @@ metadata:
{{- template "mychart.labels" . }}
```

Notez que nous passons `.` à la fin de l'appel `template`. Nous pourrions tout aussi bien passer `.Values`, `.Values.favorite` ou tout autre scope que nous souhaitons. Mais ce que nous voulons, c'est le scope de niveau supérieur.
Notez que nous passons `.` à la fin de l'appel `template`. Nous pourrions tout aussi bien passer `.Values`, `.Values.favorite` ou tout autre scope souhaité. Mais ce que nous voulons ici, c'est le scope de niveau supérieur. Dans le contexte du modèle nommé, `$` fera référence au scope que vous avez passé et non à un scope global.

Maintenant, lorsque nous exécutons ce modèle avec `helm install --dry-run --debug plinking-anaco ./mychart`, nous obtenons ceci :

2 changes: 1 addition & 1 deletion content/fr/docs/chart_template_guide/variables.md
Original file line number Diff line number Diff line change
@@ -86,7 +86,7 @@ data:
{{- end }}
```

Pour les structures de données qui ont à la fois une clé et une valeur, nous pouvons utiliser `range` pour obtenir les deux. Par exemple, nous pouvons boucler sur `.Values.favorite` comme ceci :
Lors de la première itération, `$key` sera à `drink` et `$val` sera à `coffee` et lors de la seconde, `$key` sera à `food` et `$val` sera à `pizza`. L'exécution de ce qui précède générera ceci :

```yaml
# Source: mychart/templates/configmap.yaml
10 changes: 10 additions & 0 deletions content/fr/docs/community/developers.md
Original file line number Diff line number Diff line change
@@ -30,6 +30,16 @@ Pour exécuter Helm localement, vous pouvez exécuter `bin/helm`.

Pour exécuter tous les tests, lancez `make test`. Comme prérequis, vous devez avoir [golangci-lint](https://golangci-lint.run) installé.

## Exécution locale

Vous pouvez mettre à jour votre variable PATH et ajouter le chemin de votre binaire Helm local. Dans un éditeur, ouvrez votre fichier de configuration de shell. Ajoutez la ligne suivante en veillant à remplacer `<path to your binary folder>` par le répertoire de votre dossier binaire local :

```
export PATH="<path to your binary folder>:$PATH"
```

Cela vous permettra d'exécuter la version construite localement de Helm depuis votre terminal.

## Directives de Contribution

Nous accueillons volontiers les contributions. Ce projet a établi certaines directives afin de garantir que (a) la qualité du code reste élevée, (b) le projet reste cohérent, et (c) les contributions respectent les exigences légales en matière de logiciel open source. Notre intention n'est pas de surcharger les contributeurs, mais de construire un code open source élégant et de haute qualité afin que nos utilisateurs en bénéficient.
5 changes: 5 additions & 0 deletions content/fr/docs/community/related.md
Original file line number Diff line number Diff line change
@@ -19,6 +19,7 @@ Si vous avez quelque chose à ajouter à cette liste, n'hésitez pas à ouvrir u
- [helm-git](https://github.com/aslafy-z/helm-git) - Installer des charts et récupérer des fichiers de valeurs depuis vos dépôts Git
- [helm-k8comp](https://github.com/cststack/k8comp) - Plugin pour créer des Helm Charts à partir de hiera en utilisant k8comp
- [helm-mapkubeapis](https://github.com/helm/helm-mapkubeapis) - Mettre à jour les métadonnées des releases Helm pour remplacer les API Kubernetes obsolètes ou supprimées
- [helm-migrate-values](https://github.com/OctopusDeployLabs/helm-migrate-values) - Plugin pour migrer les valeurs spécifiées par l'utilisateur entre différentes versions d'un chart Helm afin de gérer les changements de schéma incompatibles dans le fichier `values.yaml`
- [helm-monitor](https://github.com/ContainerSolutions/helm-monitor) - Plugin pour surveiller une release et effectuer un rollback basé sur une requête Prometheus/ElasticSearch
- [helm-release-plugin](https://github.com/JovianX/helm-release-plugin) - Plugin pour la gestion des releases : mettre à jour les valeurs des releases, extraire (et recréer) les Helm Charts à partir des releases déployées, et définir le TTL des releases Helm.
- [helm-s3](https://github.com/hypnoglow/helm-s3) -Plugin Helm permettant d'utiliser AWS S3 comme [dépôt] privé de charts
@@ -33,6 +34,7 @@ Si vous avez quelque chose à ajouter à cette liste, n'hésitez pas à ouvrir u
- [helm-external-val](https://github.com/kuuji/helm-external-val) - Plugin qui récupère les valeurs Helm depuis des sources externes (ConfigMaps, Secrets, etc.).
- [helm-images](https://github.com/nikhilsbhat/helm-images) - Plugin Helm pour récupérer toutes les images possibles depuis le chart avant le déploiement ou depuis une release déployée.
- [helm-drift](https://github.com/nikhilsbhat/helm-drift) - Plugin Helm qui identifie la configuration ayant divergé du Helm chart.
- [helm-tui](https://github.com/pidanou/helm-tui) - Une interface légère pour gérer vos ressources Helm sans quitter le terminal

Nous encourageons également les auteurs sur GitHub à utiliser le tag [helm-plugin](https://github.com/search?q=topic%3Ahelm-plugin&type=Repositories) sur leurs dépôts de plugins.

@@ -42,6 +44,7 @@ Outils superposés à Helm.

Voici la traduction des outils et plugins mentionnés :

- [Aptakube](https://aptakube.com/) - Interface bureau pour les versions Kubernetes et Helm
- [Armada](https://airshipit.readthedocs.io/projects/armada/en/latest/) - Gère les releases préfixées à travers divers namespaces Kubernetes et supprime les jobs terminés pour des déploiements complexes.
- [avionix](https://github.com/zbrookle/avionix) - Interface Python pour générer des Helm charts et des fichiers Kubernetes YAML, permettant l'héritage et moins de duplication de code.
- [Botkube](https://botkube.io) - Exécute des commandes Helm directement depuis Slack, Discord, Microsoft Teams et Mattermost.
@@ -50,11 +53,13 @@ Voici la traduction des outils et plugins mentionnés :
- [ChartMuseum](https://github.com/helm/chartmuseum) - Dépôt de Helm Charts avec support pour Amazon S3 et Google Cloud Storage.
- [chart-registry](https://github.com/hangyan/chart-registry) - Héberge des Helm Charts sur OCI Registry.
- [Codefresh](https://codefresh.io) - Plateforme CI/CD et de gestion native Kubernetes avec des tableaux de bord UI pour gérer les Helm charts et les releases.
- [Cyclops]https://cyclops-ui.com/) - Rendu dynamique d'une interface utilisateur Kubernetes basé sur des charts Helm
- [Flux](https://fluxcd.io/docs/components/helm/) - Livraison continue et progressive de Git à Kubernetes.
- [Helmfile](https://github.com/helmfile/helmfile) - Helmfile est un spécification déclarative pour déployer des Helm charts.
- [Helmper](https://github.com/ChristofferNissen/helmper) - Helmper vous aide à importer des Helm Charts - y compris tous les artefacts OCI (images), dans vos propres OCI registries. Helmper facilite également le scan de sécurité et le patch des images OCI. Helmper utilise Helm, Oras, Trivy, Copacetic et Buildkitd.
- [Helmsman](https://github.com/Praqma/helmsman) - Helmsman est un outil de type helm-charts-as-code qui permet d’installer, mettre à jour, protéger, déplacer et supprimer des releases à partir de fichiers d'état désiré versionnés (décrits dans un format TOML simple).
- [HULL](https://github.com/vidispine/hull) - Cette bibliothèque chart fournit une interface prête à l'emploi pour spécifier tous les objets Kubernetes directement dans le `values.yaml`. Elle élimine la nécessité d'écrire des templates pour vos charts et propose de nombreuses fonctionnalités supplémentaires pour simplifier la création et l'utilisation des Helm charts.
- [K8Studio](https://k8studio.io/) - Interface utilisateur de bureau pour la gestion des clusters Kubernetes avec un gestionnaire Helm intégré.
- [Konveyor Move2Kube](https://konveyor.io/move2kube/) - Génère des Helm charts pour vos projets existants.
- [Landscaper](https://github.com/Eneco/landscaper/) - "Landscaper prend un ensemble de références de Helm Chart avec des valeurs (un état désiré) et le réalise dans un cluster Kubernetes."
- [Monocular](https://github.com/helm/monocular) - Interface Web pour les dépôts de Helm Charts.
56 changes: 1 addition & 55 deletions content/fr/docs/topics/advanced.md
Original file line number Diff line number Diff line change
@@ -44,61 +44,7 @@ type PostRenderer interface {
}
```

Pour plus d'informations sur l'utilisation du Go SDK, consultez la [section Go SDK](#go-sdk).

## Go SDK
Helm 3 a introduit un Go SDK entièrement restructuré pour offrir une meilleure expérience lors de la création de logiciels et d'outils utilisant Helm. La documentation complète est disponible sur [https://pkg.go.dev/helm.sh/helm/v3](https://pkg.go.dev/helm.sh/helm/v3), mais un court aperçu de certains des packages les plus courants ainsi qu'un exemple simple suivent ci-dessous.

### Vue d'ensemble des packages
Voici une liste des packages les plus couramment utilisés avec une explication simple pour chacun :

- `pkg/action` : Contient le « client » principal pour effectuer des actions Helm. Il s'agit du même package utilisé en interne par la CLI. Si vous devez simplement exécuter des commandes Helm de base depuis un autre programme Go, ce package est fait pour vous.
- `pkg/{chart,chartutil}` : Méthodes et outils utilisés pour charger et manipuler des charts.
- `pkg/cli` et ses sous-packages : Contient tous les gestionnaires des variables d'environnement Helm standard, et ses sous-packages gèrent la sortie et les fichiers de valeurs.
- `pkg/release` : Définit l'objet `Release` et ses statuts.

Évidemment, il existe de nombreux autres packages en plus de ceux-ci, alors consultez la documentation pour plus d'informations !

### Exemple simple
Voici un exemple simple de réalisation d'un `helm list` en utilisant le Go SDK :

```go
package main

import (
"log"
"os"

"helm.sh/helm/v3/pkg/action"
"helm.sh/helm/v3/pkg/cli"
)

func main() {
settings := cli.New()

actionConfig := new(action.Configuration)
// // Vous pouvez passer une chaîne vide au lieu de settings.Namespace() pour lister tous les namespaces

if err := actionConfig.Init(settings.RESTClientGetter(), settings.Namespace(), os.Getenv("HELM_DRIVER"), log.Printf); err != nil {
log.Printf("%+v", err)
os.Exit(1)
}

client := action.NewList(actionConfig)
// Liste uniquement les déploiements
client.Deployed = true
results, err := client.Run()
if err != nil {
log.Printf("%+v", err)
os.Exit(1)
}

for _, rel := range results {
log.Printf("%+v", rel)
}
}

```
Pour plus d'informations sur l'utilisation du Go SDK, consultez la [section Go SDK](https://helm.sh/docs/sdk/gosdk/).

## Stockage des backends

2 changes: 1 addition & 1 deletion content/fr/docs/topics/chart_repository.md
Original file line number Diff line number Diff line change
@@ -6,7 +6,7 @@ weight: 6

Cette section explique comment créer et travailler avec des dépôts de charts Helm. À un niveau élevé, un dépôt de charts est un emplacement où les charts emballés peuvent être stockés et partagés.

Le dépôt de charts Helm communautaire distribué est situé sur [Artifact Hub](https://artifacthub.io/packages/search?kind=0) et accueille la participation. Cependant, Helm permet également de créer et de gérer votre propre dépôt de charts. Ce guide explique comment procéder.
Le dépôt de charts Helm communautaire distribué est situé sur [Artifact Hub](https://artifacthub.io/packages/search?kind=0) et accueille la participation. Cependant, Helm permet également de créer et de gérer votre propre dépôt de charts. Ce guide explique comment procéder. Si vous envisagez de créer un dépôt de charts, vous pourriez envisager d'utiliser à la place un [registre OCI]({{< ref "../topics/registries" >}}).

## Prérequis

Loading