Go Academy · Leçon

Variables d’environnement

Remplacer la configuration depuis l’environnement

Variables d’environnement est une leçon Go Academy gratuite sur CoddyKit. Ceci est la leçon 2 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Go Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Go Academy comprend 4 leçons au total.

Pourquoi utiliser des variables d’environnement

La méthodologie Twelve-Factor App recommande de stocker la configuration dans l’environnement. Les variables d’environnement permettent au même binaire de se comporter différemment en développement, en préproduction et en production, sans modifier les fichiers.

Viper peut superposer les variables d’environnement à la configuration provenant d’un fichier.

Ordre de priorité

Viper détermine la valeur d’une clé en vérifiant les sources par ordre de priorité, de la plus élevée à la plus faible :

appels explicites à Set
options
variables d’environnement
fichier de configuration
valeurs par défaut

Une variable d’environnement remplace donc la valeur du fichier, mais reste prioritaire sur elle-même face à un appel explicite à Set.

Activer la prise en charge de l’environnement

viper.AutomaticEnv() indique à Viper de vérifier les variables d’environnement pour chaque clé demandée. Ensuite, viper.GetString("port") consulte la variable d’environnement PORT.

viper.AutomaticEnv()
port := viper.GetString("port")

Ajouter un préfixe

Pour éviter les conflits avec des variables d’environnement sans rapport, définissez un préfixe :

viper.SetEnvPrefix("myapp")
La clé port correspond alors à la variable d’environnement MYAPP_PORT

Viper convertit la clé en majuscules et ajoute le préfixe en le séparant par un trait de soulignement.

viper.SetEnvPrefix("myapp")
viper.AutomaticEnv()
fmt.Println(viper.GetString("port")) // reads MYAPP_PORT

Gérer les clés imbriquées

Les variables d’environnement ne peuvent pas contenir de points. Utilisez un remplaceur de clés pour convertir les clés séparées par des points en clés séparées par des traits de soulignement, afin que server.port devienne SERVER_PORT.

replacer := strings.NewReplacer(".", "_")
viper.SetEnvKeyReplacer(replacer)
viper.AutomaticEnv()
// server.port -> SERVER_PORT

Associer une seule variable

Au lieu du mode automatique, vous pouvez associer explicitement une clé avec viper.BindEnv. Cette méthode est utile lorsque le nom de la variable d’environnement ne suit pas votre convention de préfixe.

viper.BindEnv("id", "ACCOUNT_ID")
fmt.Println(viper.GetString("id"))

Le paquet os de la bibliothèque standard

En interne, cette lecture s’effectue dans l’environnement du processus, exposé par la bibliothèque standard via os.Getenv et os.LookupEnv.

os.Getenv renvoie une chaîne vide lorsque la variable n’est pas définie
os.LookupEnv renvoie un second booléen indiquant si la variable était présente

val, ok := os.LookupEnv("PORT")
if !ok {
    val = "8080" // default
}

Définir des variables d’environnement en Go

Vous pouvez définir des variables d’environnement par programmation pour les vérifications ou les valeurs par défaut avec os.Setenv. C’est exactement ce que nous utilisons pour illustrer ensuite le comportement de remplacement.

os.Setenv("MYAPP_PORT", "9090")

Vide ou non définie

Attention : une variable d’environnement définie sur une chaîne vide est tout de même présente. os.LookupEnv renvoie ("", true). Si vous utilisez uniquement os.Getenv, vous ne pouvez pas distinguer une valeur vide d’une variable non définie, ce qui est important pour les indicateurs de type booléen.

os.Setenv("FEATURE", "")
v, ok := os.LookupEnv("FEATURE")
fmt.Println(v == "", ok) // true true

Assemblage (concept)

Un flux de démarrage typique consiste à lire le fichier pour obtenir les valeurs par défaut, puis à appeler AutomaticEnv afin que les variables d’environnement du déploiement soient prioritaires. Les équipes d’exploitation peuvent modifier MYAPP_PORT sans toucher au fichier YAML.

viper.SetConfigName("config")
viper.ReadInConfig()
viper.SetEnvPrefix("myapp")
viper.AutomaticEnv()
fmt.Println(viper.GetInt("port"))

Exécutable : démonstration du remplacement par l’environnement

Ce programme utilisant la bibliothèque standard reproduit les priorités de Viper : une valeur par défaut provenant d’un fichier, remplacée par l’environnement.

package main

import (
    "fmt"
    "os"
)

func get(key, fileDefault string) string {
    if v, ok := os.LookupEnv(key); ok {
        return v
    }
    return fileDefault
}

func main() {
    os.Setenv("PORT", "9090")
    fmt.Println("port:", get("PORT", "8080"))
    fmt.Println("host:", get("HOST", "localhost"))
}

Vérification rapide

Vérifiez votre compréhension de la configuration par variables d’environnement.

Récapitulatif

Vous avez appris à remplacer la configuration avec l’environnement :

Les variables d’environnement occupent une position élevée dans les priorités de Viper, au-dessus du fichier
AutomaticEnv et SetEnvPrefix associent les clés au format PREFIX_KEY
Utilisez SetEnvKeyReplacer pour les clés imbriquées séparées par des points
La bibliothèque standard s’appuie sur os.Getenv et os.LookupEnv pour cette fonctionnalité

Questions Fréquemment Posées

La leçon « Variables d’environnement » est-elle gratuite ?

Oui — le texte complet de « Variables d’environnement » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Go Academy, passe à CoddyKit PRO. Le cours Go Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Variables d’environnement » ?

Remplacer la configuration depuis l’environnement Tu pratiques Go Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Go Academy ?

Aucune expérience préalable n'est requise. Go Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 2 sur 4.

Combien de temps prend la leçon « Variables d’environnement » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Go Academy ?

Oui. Chaque leçon Go Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

← Retour à Go Academy