La documentazione di Kubernetes

Benvenuto! Questo repository contiene tutte le informazioni necessarie per creare la documentazione e il sito web di Kubernetes. Siamo onorati che tu voglia contribuire!

Come contribuire alla documentazione

Puoi premere il pulsante Fork in alto nella parte destra dello schermo per creare una copia di questo repository sotto la tua utenza di GitHub. Questa copia è chiamata un fork. Puoi fare tutte le modifiche che vuoi nel tuo fork, e quando sei pronto a mandarci i cambiamenti, vai sulla pagina del tuo fork e crea una nuova pull request per farcelo sapere.

Una volta che hai creato la pull request, un reviewer (revisore) Kubernetes la prenderà in carico per fornire un feedback chiaro e concretamente attuabile. Come owner della pull request, è tua responsabilità modificare la tua pull request per rispondere al feedback che ti è stato fornito dal reviewer Kubernetes. Inoltre, tieni presente che potresti ricevere feedback da più di un Reviewer di Kubernetes, incluse quindi persone diverse da quella che ti ha fornito il primo feedback. In alcuni casi, uno dei tuoi reviewer potrebbe richiedere una revisione tecnica da un technical reviewer di Kubernetes quando necessario. I reviewer faranno del loro meglio per fornire feedback in modo tempestivo, ma i tempi di risposta possono variare in base alle circostanze.

Per maggiori informazioni su come contribuire alla documentazione Kubernetes, vedi:

Eseguire il sito Web localmente usando Docker

Il modo consigliato per eseguire localmente il sito Web Kubernetes prevede l'utilizzo di un'immagine Docker inclusa nel sito e configurata con tutti i software necessari, a partire dal generatore di siti web statici Hugo.

Se stai utilizzando Windows, avrai bisogno di alcuni strumenti aggiuntivi che puoi installare con Chocolatey. choco install make

Se preferisci eseguire il sito Web localmente senza Docker, vedi Eseguire il sito Web localmente utilizzando Hugo di seguito.

Se hai Docker attivo e funzionante, crea l'immagine Docker kubernetes-hugo localmente:

make container-image

Dopo aver creato l'immagine, è possibile eseguire il sito Web localmente:

make container-serve

Apri il tuo browser su http://localhost:1313 per visualizzare il sito Web. Mentre modifichi i file sorgenti, Hugo aggiorna automaticamente il sito Web e forza un aggiornamento della pagina visualizzata nel browser.

Eseguire il sito Web localmente utilizzando Hugo

Vedi la documentazione ufficiale di Hugo per le istruzioni di installazione di Hugo. Assicurati di installare esattamente la versione di Hugo specificata dalla variabile d'ambiente HUGO_VERSION nel file netlify.toml.

Per eseguire il sito Web localmente dopo aver installato Hugo:

make serve

Questo comando avvierà il server Hugo locale sulla porta 1313. Apri il tuo browser su http://localhost:1313 per visualizzare il sito Web. Mentre apporti modifiche ai file di origine, Hugo aggiorna il sito Web e forza un aggiornamento del browser.

Community, discussioni, contribuire e supporto

Scopri come interagire con la community di Kubernetes nella pagina della community.

Puoi contattare i maintainers di questo progetto su:

Codice di condotta

La partecipazione alla comunità Kubernetes è regolata dal Codice di condotta di Kubernetes.

Grazie!

Kubernetes prospera grazie alla partecipazione della comunity e apprezziamo i tuoi contributi al nostro sito Web e alla nostra documentazione!