Go Academy · Leçon

Distribuer des outils CLI

Compilation croisée, goreleaser et dépôts homebrew

Distribuer des outils CLI est une leçon Go Academy gratuite sur CoddyKit. Ceci est la leçon 4 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.

go install pour une distribution locale

go install github.com/user/tool@latest compile et installe le binaire dans $GOPATH/bin. Les utilisateurs doivent avoir Go installé.

Compilation croisée

Go effectue nativement des compilations croisées. Définissez GOOS et GOARCH pour cibler différents systèmes d’exploitation :

GOOS=linux  GOARCH=amd64 go build -o myapp-linux-amd64
GOOS=darwin GOARCH=arm64 go build -o myapp-darwin-arm64
GOOS=windows GOARCH=amd64 go build -o myapp-windows-amd64.exe

Options de compilation pour une publication

Supprimez les informations de débogage et désactivez CGO pour obtenir des binaires statiques plus petits :

CGO_ENABLED=0 go build -ldflags="-s -w" -o myapp

Intégrer les informations de version

Injectez les informations disponibles lors de la compilation avec ldflags :

var version = "dev"
var commit  = "none"
// Build: go build -ldflags="-X main.version=1.2.3 -X main.commit=abc1234"

GoReleaser

GoReleaser automatise la compilation croisée, la création des paquets (tar.gz, .zip), la génération des sommes de contrôle et la mise en ligne des publications sur GitHub. Configurez-le dans .goreleaser.yaml.

# .goreleaser.yaml
builds:
  - env: [CGO_ENABLED=0]
    goos: [linux, darwin, windows]
    goarch: [amd64, arm64]

Dépôt Homebrew

Publiez une formule Homebrew afin que les utilisateurs de macOS/Linux puissent installer l’application avec brew install. GoReleaser peut générer automatiquement la formule.

CI/CD avec GitHub Actions

Utilisez une action GitHub pour compiler et publier l’application à chaque envoi d’une étiquette. GoReleaser dispose d’une action GitHub officielle.

- name: Run GoReleaser
  uses: goreleaser/goreleaser-action@v5
  with: { version: latest, args: release --clean }
  env: { GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN }}" }

Distribution avec Docker

Empaquetez la CLI sous forme d’image Docker pour les utilisateurs qui préfèrent les conteneurs. Utilisez une compilation en plusieurs étapes afin de conserver une image finale minimale.

FROM golang:1.22 AS build
WORKDIR /app
COPY . .
RUN CGO_ENABLED=0 go build -o myapp

FROM scratch
COPY --from=build /app/myapp /myapp
ENTRYPOINT ["/myapp"]

go:embed pour les ressources

Intégrez des fichiers statiques (modèles, schémas de configuration) au binaire avec //go:embed afin que celui-ci soit entièrement autonome.

//go:embed templates/*
var templates embed.FS

Modules versionnés

Publiez votre module CLI en respectant le versionnement des modules Go. À partir de v2, le chemin d’importation doit inclure /v2 et le chemin du module dans go.mod doit correspondre.

Compatibilité avec les versions antérieures

Suivez le versionnement sémantique. Les versions mineures peuvent ajouter des options, mais ne doivent pas supprimer ni renommer celles qui existent déjà. Les modifications incompatibles nécessitent une nouvelle version majeure.

Vérification rapide

Comment compiler un binaire Go statique pour Linux sur une machine macOS ?

Récapitulatif : distribuer des outils CLI

Points essentiels :

Effectuez une compilation croisée avec GOOS/GOARCH ; CGO_ENABLED=0 pour les binaires statiques
GoReleaser pour automatiser le pipeline de publication
Injectez la version avec -ldflags "-X main.version=..."
go:embed pour des binaires autonomes contenant leurs ressources intégrées

Questions Fréquemment Posées

La leçon « Distribuer des outils CLI » est-elle gratuite ?

Oui — le texte complet de « Distribuer des outils CLI » 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 « Distribuer des outils CLI » ?

Compilation croisée, goreleaser et dépôts homebrew 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 4 sur 4.

Combien de temps prend la leçon « Distribuer des outils CLI » ?

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