Go Academy · Lezione

Distribuire strumenti CLI

Compilazione incrociata, goreleaser e tap di homebrew

Distribuire strumenti CLI è una lezione Go Academy gratuita su CoddyKit. Questa è la lezione 4 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Go Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Go Academy include 4 lezioni in totale.

go install per la distribuzione locale

go install github.com/user/tool@latest compila e installa il binario in $GOPATH/bin. Gli utenti devono avere Go installato.

Compilazione incrociata

Go supporta nativamente la compilazione incrociata. Imposti GOOS e GOARCH per scegliere sistemi operativi diversi:

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

Flag di compilazione per il rilascio

Rimuova le informazioni di debug e disabiliti CGO per ottenere binari più piccoli e statici:

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

Incorporare le informazioni sulla versione

Inserisca informazioni al momento della compilazione con ldflags:

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

GoReleaser

GoReleaser automatizza la compilazione incrociata, la creazione dei pacchetti (tar.gz, .zip), la generazione dei checksum e il caricamento dei rilasci su GitHub. Configuri il processo in .goreleaser.yaml.

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

Tap Homebrew

Pubblichi una formula Homebrew, così gli utenti macOS/Linux possono installare il programma con brew install. GoReleaser può generare automaticamente la formula.

CI/CD con GitHub Actions

Utilizzi una GitHub Action per compilare e creare un rilascio a ogni push di un tag. GoReleaser dispone di una GitHub Action ufficiale.

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

Distribuzione con Docker

Confezioni la CLI come immagine Docker per gli utenti che preferiscono i container. Utilizzi una compilazione multi-stage per mantenere minima l'immagine finale.

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 per gli asset

Incorpori i file statici, come template e schemi di configurazione, nel binario con //go:embed, così il binario è completamente autonomo.

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

Moduli con versione

Pubblichi il modulo CLI seguendo il versionamento dei moduli Go. Per v2 e versioni successive, il percorso di importazione deve includere /v2 e il percorso del modulo in go.mod deve corrispondere.

Compatibilità con le versioni precedenti

Segua il versionamento semantico. Le versioni minor possono aggiungere flag, ma non devono rimuovere o rinominare quelli esistenti. Le modifiche incompatibili richiedono un incremento della versione major.

Verifica rapida

Come si compila un binario Go statico per Linux su una macchina macOS?

Riepilogo: distribuzione degli strumenti CLI

Punti chiave:

Compilazione incrociata con GOOS/GOARCH; CGO_ENABLED=0 per binari statici
GoReleaser per una pipeline di rilascio automatizzata
Inserimento della versione con -ldflags "-X main.version=..."
go:embed per binari autonomi con asset incorporati

Domande Frequenti

La lezione «Distribuire strumenti CLI» è gratuita?

Sì — il testo completo di «Distribuire strumenti CLI» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Go Academy, passa a CoddyKit PRO. Il corso Go Academy include 4 lezioni in totale.

Cosa imparerò in «Distribuire strumenti CLI»?

Compilazione incrociata, goreleaser e tap di homebrew Eserciti Go Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Go Academy?

Non è richiesta alcuna esperienza precedente. Go Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 4 di 4.

Quanto tempo richiede la lezione «Distribuire strumenti CLI»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Go Academy?

Sì. Ogni lezione Go Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a Go Academy