Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

herd.yml: Windows service catalogue is a subset of macOS (no Typesense), so a shared manifest cannot be applied by herd init on Windows

Aperta
  • Qualcosa non va?
#1,746 0 commenti 1 reazione 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
35/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
laravel, mysql, php, redis
Ambito
cli, devops, documentation

Direzione di ricerca

Inizia dalle pagine della documentazione di herd-yaml per macOS e Windows e confronta le pagine service-versions collegate; quindi riproduci il manifest di esempio con herd init su entrambe le piattaforme. Il completamento dovrebbe rendere esplicite le differenze tra piattaforme e cataloghi e stabilire un modo supportato per consentire ai manifest di gestire i servizi non disponibili e i cambiamenti di versione.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

fixed-in-next-release macOS windows

Summary

herd.yml is documented as a manifest a team commits so every machine gets the same PHP version and Herd Pro services via herd init. In a mixed macOS / Windows team this breaks silently at the documentation level and loudly at herd init time, because the two platforms do not offer the same services or versions:

  • The macOS service-versions page lists Typesense (0.26 / 29.x / 30.x), Valkey and Redis 7.0.x / 7.4.x.
  • The Windows service-versions page lists no Typesense and no Valkey, and Redis 7.0.0 only. /docs/windows/herd-pro-services/typesense returns 404.
  • The herd-yaml docs page (both macOS and Windows variants) mentions no platform caveat, no way to mark a service optional or per-platform, and no wildcard versions.

A manifest like this therefore works on macOS and fails herd init on Windows:

name: myapp
php: '8.5'
secured: true
services:
    mysql:
        version: 8.4.2
        port: '${DB_PORT}'
    typesense:
        version: 29.0
        port: '${TYPESENSE_PORT}'

The same failure mode already hits single-platform teams when an exact patch version drops out of a newer Herd build's catalogue (#1595, discussion #1735), so the underlying problem is that herd init treats every services entry as a hard requirement with an exact version.

Requests

  1. Document the platform differences on the herd-yaml page (or link the two service-versions pages from it) so teams know a committed manifest is not portable as-is.
  2. Let herd init warn and skip a service that is unavailable on the current platform or Herd build instead of aborting, or add an explicit optional: true / platforms: [macos] key per service.
  3. Accept wildcard versions (8.4.x, 29.x) so a manifest survives catalogue updates (this is the ask in #1595 / #1735 too).

Environment

  • Herd for macOS and Herd for Windows, both current at time of writing, Herd Pro.
  • Reproduced by committing the manifest above in a Laravel project and running herd init on each platform.
Lingua principale
Nessun dato sulla lingua
Stelle
124
Fork
1
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di beyondcode/herd-community

Tutte le issue di beyondcode/herd-community

Issue simili

Altre issue su CLI

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.