From a0325251ab6685cb3853bb4e7d3e1ed030e6626e Mon Sep 17 00:00:00 2001 From: Fabio Alessandro Locati Date: Tue, 21 Jan 2020 11:07:37 +0100 Subject: [PATCH] Add IT localization for overview/components/ (#18368) * begin the real work * rollback set of changes * translate components and required glossary items * improve many aspects thanks to the comments in the pr thread --- content/it/docs/concepts/_index.md | 3 +- .../it/docs/concepts/overview/components.md | 124 ++++++++++++++++++ .../concepts/overview/what-is-kubernetes.md | 2 +- content/it/docs/home/_index.md | 58 ++++++++ content/it/docs/reference/glossary/cluster.md | 17 +++ .../reference/glossary/container-runtime.md | 21 +++ content/it/docs/reference/glossary/etcd.md | 21 +++ .../docs/reference/glossary/kube-apiserver.md | 23 ++++ .../glossary/kube-controller-manager.md | 18 +++ .../it/docs/reference/glossary/kube-proxy.md | 23 ++++ .../docs/reference/glossary/kube-scheduler.md | 18 +++ content/it/docs/reference/glossary/kubelet.md | 19 +++ 12 files changed, 344 insertions(+), 3 deletions(-) create mode 100644 content/it/docs/concepts/overview/components.md create mode 100644 content/it/docs/home/_index.md create mode 100755 content/it/docs/reference/glossary/cluster.md create mode 100644 content/it/docs/reference/glossary/container-runtime.md create mode 100755 content/it/docs/reference/glossary/etcd.md create mode 100755 content/it/docs/reference/glossary/kube-apiserver.md create mode 100755 content/it/docs/reference/glossary/kube-controller-manager.md create mode 100755 content/it/docs/reference/glossary/kube-proxy.md create mode 100755 content/it/docs/reference/glossary/kube-scheduler.md create mode 100755 content/it/docs/reference/glossary/kubelet.md diff --git a/content/it/docs/concepts/_index.md b/content/it/docs/concepts/_index.md index 04a1e84b62..f471f2cd79 100644 --- a/content/it/docs/concepts/_index.md +++ b/content/it/docs/concepts/_index.md @@ -1,6 +1,5 @@ --- -draft: True -title: Concepts +title: Concetti main_menu: true content_template: templates/concept weight: 40 diff --git a/content/it/docs/concepts/overview/components.md b/content/it/docs/concepts/overview/components.md new file mode 100644 index 0000000000..5a057fa841 --- /dev/null +++ b/content/it/docs/concepts/overview/components.md @@ -0,0 +1,124 @@ +--- +title: I componenti di Kubernetes +content_template: templates/concept +weight: 20 +card: + name: concepts + weight: 20 +--- + +{{% capture overview %}} +Facendo il deployment di Kubernetes, ottieni un cluster. +{{< glossary_definition term_id="cluster" length="all" prepend="Un cluster è">}} + +Questo documento describe i diversi componenti che sono necessari per avere +un cluster Kubernetes completo e funzionante. + +Questo è un diagramma di un cluster Kubernetes con tutti i componenti e le loro relazioni. + +![Components of Kubernetes](/images/docs/components-of-kubernetes.png) + +{{% /capture %}} + +{{% capture body %}} +## Componenti della Control Plane + +La Control Plane è responsabile di tutte le decisioni globali sul cluster (ad esempio, lo scheduling), e l'individuazione e la risposta ad eventi derivanti dal cluster (ad esempio, l'avvio di un nuovo {{< glossary_tooltip text="pod" term_id="pod">}} quando il valore `replicas` di un deployment non è soddisfatto). + +I componenti della Control Plane possono essere eseguiti su qualsiasi nodo del cluster, ma solitamente gli script di installazione tendono a eseguire tutti i componenti della Control Plane sulla stessa macchina, separando la Control Plane dai workload dell'utente. +Vedi [creare un cluster in High-Availability](/docs/admin/high-availability/) per un esempio di un'installazione multi-master. + +### kube-apiserver + +{{< glossary_definition term_id="kube-apiserver" length="all" >}} + +### etcd + +{{< glossary_definition term_id="etcd" length="all" >}} + +### kube-scheduler + +{{< glossary_definition term_id="kube-scheduler" length="all" >}} + +### kube-controller-manager + +{{< glossary_definition term_id="kube-controller-manager" length="all" >}} + +Alcuni esempi di controller gestiti dal kube-controller-manager sono: + + * Node Controller: Responsabile del monitoraggio dei nodi del cluster, e.g. della gestione delle azioni da eseguire quando un nodo diventa non disponibile. + * Replication Controller: Responsabile per il mantenimento del corretto numero di Pod per ogni ReplicaSet presente nel sistema + * Endpoints Controller: Popola gli oggetti Endpoints (cioè, mette in relazioni i Pods con i Services). + * Service Account & Token Controllers: Creano gli account di default e i token di accesso alle API per i nuovi namespaces. + +### cloud-controller-manager + +Il [cloud-controller-manager](/docs/tasks/administer-cluster/running-cloud-controller/) esegue i controller che interagiscono con i cloud provider responsabili per la gestione dell'infrastruttura sottostante al cluster, in caso di deployment in cloud. +Il cloud-controller-manager è una funzionalità alpha introdotta in Kubernetes 1.6. + +Il cloud-controller-manager esegue esclusivamente i cicli di controllo specifici dei cloud provider. +È possibile disabilitare questi cicli di controllo usando il kube-controller-manager. +È inoltre possibile disabilitare i cicli di controllo settando il parametro `--cloud-provider` con il valore `external` durante l'esecuzione del kube-controller-manager. + +Il cloud-controller-manager permette l'evoluzione indipendente al codice di Kubernetes e a quello dei singoli cloud vendor. +Precedentemente, il codice core di Kubernetes dipendeva da implementazioni specifiche dei cloud provider. +In futuro, implementazioni specifiche per singoli cloud provider devono essere mantenuti dai cloud provider interessati e collegati al cloud-controller-manager. + +I seguenti controller hanno dipendenze verso implementazioni di specifici cloud provider: + + * Node Controller: Per controllare se sul cloud provider i nodi che hanno smesso di rispondere sono stati cancellati + * Route Controller: Per configurare le regole di route nella sottostante infrastruttura cloud + * Service Controller: Per creare, aggiornare ed eliminare i load balancer nella infrastruttura del cloud provider + * Volume Controller: Per creare, associare e montare i volumi e per interagire con il cloud provider per orchestrare i volumi + +## Componenti dei Nodi + +I componenti di Kubernetes che girano sui Worker Node sono responsabili dell'esecuzione dei workload degli utenti. + +### kubelet + +{{< glossary_definition term_id="kubelet" length="all" >}} + +### kube-proxy + +{{< glossary_definition term_id="kube-proxy" length="all" >}} + +### Container Runtime + +{{< glossary_definition term_id="container-runtime" length="all" >}} + +## Addons + +Gli Addons usano le risorse Kubernetes ({{< glossary_tooltip term_id="daemonset" >}}, {{< glossary_tooltip term_id="deployment" >}}, etc) per implementare nuove funzionalità a livello di cluster. +Dal momento che gli addons forniscono funzionalità a livello di cluster, le risorse che necessitano di un namespace, vengono collocate nel namespace `kube-system`. + +Alcuni addons sono descritti di seguito; mentre per una più estesa lista di addons, riferirsi ad [Addons](/docs/concepts/cluster-administration/addons/). + +### DNS + +Mentre gli altri addons non sono strettamente richiesti, tutti i cluster Kubernetes dovrebbero essere muniti di un [DNS del cluster](/docs/concepts/services-networking/dns-pod-service/), dal momento che molte applicazioni lo necessitano. + +Il DNS del cluster è un server DNS aggiuntivo rispetto ad altri server DNS presenti nella rete, e si occupa specificatamente dei record DNS per i servizi Kubernetes. + +I container eseguiti da Kubernetes possono utilizzare questo server per la risoluzione DNS. + +### Interfaccia web (Dashboard) + +La [Dashboard](/docs/tasks/access-application-cluster/web-ui-dashboard/) è una interfaccia web per i cluster Kubernetes. +Permette agli utenti di gestire e fare troubleshooting delle applicazioni che girano nel cluster, e del cluster stesso. + +### Monitoraggio dei Container + +Il [Monitoraggio dei Container](/docs/tasks/debug-application-cluster/resource-usage-monitoring/) salva serie temporali di metriche generiche dei container in un database centrale e fornisce una interfaccia in cui navigare i dati stessi. + +### Log a livello di Cluster + +Un [log a livello di cluster](/docs/concepts/cluster-administration/logging/) è responsabile per il salvataggio dei log dei container in un log centralizzato la cui interfaccia permette di cercare e navigare nei log. + +{{% /capture %}} +{{% capture whatsnext %}} +* Scopri i concetti relativi ai [Nodi](/docs/concepts/architecture/nodes/) +* Scopri i concetti relativi ai [Controller](/docs/concepts/architecture/controller/) +* Scopri i concetti relativi al [kube-scheduler](/docs/concepts/scheduling/kube-scheduler/) +* Leggi la [documentazione](https://etcd.io/docs/) ufficiale di etcd +{{% /capture %}} diff --git a/content/it/docs/concepts/overview/what-is-kubernetes.md b/content/it/docs/concepts/overview/what-is-kubernetes.md index e64c34d03e..851745a89b 100644 --- a/content/it/docs/concepts/overview/what-is-kubernetes.md +++ b/content/it/docs/concepts/overview/what-is-kubernetes.md @@ -16,7 +16,7 @@ Questa pagina è una panoramica generale su Kubernetes. {{% capture body %}} Kubernetes è una piattaforma portatile, estensibile e open-source per la gestione di carichi di lavoro e servizi containerizzati, in grado di facilitare sia la configurazione dichiarativa che l'automazione. La piattaforma vanta un grande ecosistema in rapida crescita. Servizi, supporto e strumenti sono ampiamente disponibili nel mondo Kubernetes . -Il nome Kubernetes deriva dal greco, significa timoniere o pilota. Google ha aperto il progetto Kubernetes nel 2014. Kubernetes si basa su [dieci anni e mezzo di esperienza di Google nella gestione di workloads (carichi di lavoro) di produzione in scala] (https://ai.google/research/pubs/pub43438), combinata con le migliori idee e pratiche della comunità. +Il nome Kubernetes deriva dal greco, significa timoniere o pilota. Google ha aperto il progetto Kubernetes nel 2014. Kubernetes si basa su [dieci anni e mezzo di esperienza di Google nella gestione di workloads (carichi di lavoro) di produzione in scala](https://ai.google/research/pubs/pub43438), combinata con le migliori idee e pratiche della comunità. ## Facciamo un piccolo passo indietro Diamo un'occhiata alla ragione per cui Kubernetes è così utile facendo un piccolo salto indietro nel tempo. diff --git a/content/it/docs/home/_index.md b/content/it/docs/home/_index.md new file mode 100644 index 0000000000..3f8e3ae0f0 --- /dev/null +++ b/content/it/docs/home/_index.md @@ -0,0 +1,58 @@ +--- +approvers: +- chenopis +title: Documentazione di Kubernetes +noedit: true +cid: docsHome +layout: docsportal_home +class: gridPage +linkTitle: "Home" +main_menu: true +weight: 10 +hide_feedback: true +menu: + main: + title: "Documentazione" + weight: 20 + post: > +

Impara come usare Kubernetes con informazioni concettuali, guide e documentazione tecnica. Puoi anche contribuire alla documentazione!

+overview: > + Kubernetes è un motore open source di orchestrazione di containers che automatizza il deployment, la scalabilità e la gestione di applicazioni containerizzate. Il progetto open source è ospitato dalla Cloud Native Computing Foundation (CNCF). +cards: +- name: concepts + title: "Capire le basi" + description: "Impara Kubernetes e i suoi concetti fondamentali." + button: "Impara i concetti" + button_path: "/docs/concepts" +- name: tutorials + title: "Prova Kubernetes" + description: "Segui delle guide per imparare come fare il deployment di applicativi in Kubernetes." + button: "Vedi le guide" + button_path: "/docs/tutorials" +- name: setup + title: "Configura un cluster" + description: "Esegui Kubernetes sulla base delle tue risorse e necessità." + button: "Configura Kubernetes" + button_path: "/docs/setup" +- name: tasks + title: "Impara come usare Kubernetes" + description: "Impara quali sono le procedure principali e come eseguirle in pochi passaggi." + button: "Guarda le procedure" + button_path: "/docs/tasks" +- name: reference + title: Guarda le referenze + description: Naviga la terminologia, la sintassi della riga di comando, la documentazione delle API e degli strumenti di installazione. + button: Vedi le referenze + button_path: /docs/reference +- name: contribute + title: Contribuisci alla documentazione + description: Chiunque può contribuire, indipendentemente dal fatto che sia nuovo nel progetto o un utente esperto. + button: Contribuisci alla documentazione + button_path: /docs/contribute +- name: download + title: Scarica Kubernetes + description: Se stai installando Kubernetes o aggiornandolo all'ultima versione, controlla le note di rilascio per la versione corrente. +- name: about + title: Sulla documentazione + description: Questo sito contiene la documentazione per la versione corrente e le precedenti 4 versioni di Kubernetes. +--- diff --git a/content/it/docs/reference/glossary/cluster.md b/content/it/docs/reference/glossary/cluster.md new file mode 100755 index 0000000000..a8d918b00d --- /dev/null +++ b/content/it/docs/reference/glossary/cluster.md @@ -0,0 +1,17 @@ +--- +title: Cluster +id: cluster +date: 2019-06-15 +full_link: +short_description: > + Un'insieme di macchine, chiamate nodi, che eseguono container e gestite da Kubernetes. Un cluster ha almeno un Worker Node e un Control Plane Node. + +aka: +tags: +- fundamental +- operation +--- +Un'insieme di macchine, chiamate nodi, che eseguono container e gestite da Kubernetes. Un cluster ha almeno un Worker Node e un Control Plane Node. + + +Il/I Worker Node ospitano i Pod che eseguono i workload dell'utente. Il/I Control Plane Node gestiscono i Worker Node e tutto quanto accade all'interno del cluster. Per garantire la high-availability e la possibilità di failover del cluster, vengono utilizzati più Control Plane Node. diff --git a/content/it/docs/reference/glossary/container-runtime.md b/content/it/docs/reference/glossary/container-runtime.md new file mode 100644 index 0000000000..640b3eaa17 --- /dev/null +++ b/content/it/docs/reference/glossary/container-runtime.md @@ -0,0 +1,21 @@ +--- +title: Container Runtime +id: container-runtime +date: 2019-06-05 +full_link: /docs/reference/generated/container-runtime +short_description: > + Il container runtime è il software che è responsabile per l'esecuzione dei container. + +aka: +tags: +- fundamental +- workload +--- + Il container runtime è il software che è responsabile per l'esecuzione dei container. + + + +Kubernetes supporta diversi container runtimes: [Docker](http://www.docker.com), +[containerd](https://containerd.io), [cri-o](https://cri-o.io/), +[rktlet](https://github.com/kubernetes-incubator/rktlet) e tutte le implementazioni di +[Kubernetes CRI (Container Runtime Interface)](https://github.com/kubernetes/community/blob/master/contributors/devel/sig-node/container-runtime-interface.md). diff --git a/content/it/docs/reference/glossary/etcd.md b/content/it/docs/reference/glossary/etcd.md new file mode 100755 index 0000000000..595cffb3da --- /dev/null +++ b/content/it/docs/reference/glossary/etcd.md @@ -0,0 +1,21 @@ +--- +title: etcd +id: etcd +date: 2018-04-12 +full_link: /docs/tasks/administer-cluster/configure-upgrade-etcd/ +short_description: > + È un database key-value altamente disponibile che è usato da Kubernetes per salvare tutte le informazioni del cluster. + +aka: +tags: +- architecture +- storage +--- + È un database key-value ridondato, che è usato da Kubernetes per salvare tutte le informazioni del cluster. + + + +Se il tuo cluster utilizza etcd per salvare le informazioni, assicurati di +avere una strategia di [backup](/docs/tasks/administer-cluster/configure-upgrade-etcd/#backing-up-an-etcd-cluster) per questi dati. + +Puoi trovare informazioni dettagliate su etcd sulla [documentazione](https://etcd.io/docs/) ufficiale. diff --git a/content/it/docs/reference/glossary/kube-apiserver.md b/content/it/docs/reference/glossary/kube-apiserver.md new file mode 100755 index 0000000000..96f5ccbd23 --- /dev/null +++ b/content/it/docs/reference/glossary/kube-apiserver.md @@ -0,0 +1,23 @@ +--- +title: API server +id: kube-apiserver +date: 2018-04-12 +full_link: /docs/reference/generated/kube-apiserver/ +short_description: > + Componente della Control plane che serve le Kubernetes API. + +aka: +- kube-apiserver +tags: +- architecture +- fundamental +--- + L'API server è un componente di Kubernetes +{{< glossary_tooltip text="control plane" term_id="control-plane" >}} che espone le Kubernetes API. +L'API server è il front end del control plane di Kubernetes. + + + +La principale implementazione di un server Kubernetes API è [kube-apiserver](/docs/reference/generated/kube-apiserver/). +kube-apiserver è progettato per scalare orizzontalmente, cioè scala aumentando il numero di istanze. +Puoi eseguire multiple istanze di kube-apiserver e bilanciare il traffico tra queste istanze. diff --git a/content/it/docs/reference/glossary/kube-controller-manager.md b/content/it/docs/reference/glossary/kube-controller-manager.md new file mode 100755 index 0000000000..32d75beeb1 --- /dev/null +++ b/content/it/docs/reference/glossary/kube-controller-manager.md @@ -0,0 +1,18 @@ +--- +title: kube-controller-manager +id: kube-controller-manager +date: 2018-04-12 +full_link: /docs/reference/command-line-tools-reference/kube-controller-manager/ +short_description: > + Componente della Control Plane che gestisce i controller. + +aka: +tags: +- architecture +- fundamental +--- + Componente della Control Plane che gestisce {{< glossary_tooltip text="controllers" term_id="controller" >}}. + + + +Da un punto di vista logico, ogni {{< glossary_tooltip text="controller" term_id="controller" >}} è un processo separato, ma per ridurre la complessità, tutti i principali controller di Kubernetes vengono raggruppati in un unico container ed eseguiti in un singolo processo. diff --git a/content/it/docs/reference/glossary/kube-proxy.md b/content/it/docs/reference/glossary/kube-proxy.md new file mode 100755 index 0000000000..c82cd60c25 --- /dev/null +++ b/content/it/docs/reference/glossary/kube-proxy.md @@ -0,0 +1,23 @@ +--- +title: kube-proxy +id: kube-proxy +date: 2018-04-12 +full_link: /docs/reference/command-line-tools-reference/kube-proxy/ +short_description: > + `kube-proxy` è un proxy eseguito su ogni nodo del cluster. + +aka: +tags: +- fundamental +- networking +--- + [kube-proxy](/docs/reference/command-line-tools-reference/kube-proxy/) è un +proxy eseguito su ogni nodo del cluster, responsabile della gestione dei +Kubernetes {{< glossary_tooltip term_id="service">}}. + + + +I kube-proxy mantengono le regole di networking sui nodi. +Queste regole permettono la comunicazione verso gli altri nodi del cluster o l'esterno. + +Il kube-proxy usa le librerie del sistema operativo quando possible; in caso contrario il kube-proxy gestisce il traffico direttamente. diff --git a/content/it/docs/reference/glossary/kube-scheduler.md b/content/it/docs/reference/glossary/kube-scheduler.md new file mode 100755 index 0000000000..c63ce0b056 --- /dev/null +++ b/content/it/docs/reference/glossary/kube-scheduler.md @@ -0,0 +1,18 @@ +--- +title: kube-scheduler +id: kube-scheduler +date: 2018-04-12 +full_link: /docs/reference/generated/kube-scheduler/ +short_description: > + Componente della Control Plane che controlla i pod appena creati che non hanno un nodo assegnato, e dopo averlo identificato glielo assegna. + +aka: +tags: +- architecture +--- + Componente della Control Plane che controlla i pod appena creati che non hanno un nodo assegnato, e dopo averlo identificato glielo assegna. + + + +I fattori presi in considerazioni nell'individuare un nodo a cui assegnare l'esecuzione di un Pod includono la richiesta di risorse del Pod stesso e degli altri workload presenti nel sistema, i vincoli delle hardware/software/policy, le indicazioni di affinity e di anti-affinity, requisiti relativi alla disponibilità di dati/Volumes, le interferenze tra diversi workload e le scadenze. + diff --git a/content/it/docs/reference/glossary/kubelet.md b/content/it/docs/reference/glossary/kubelet.md new file mode 100755 index 0000000000..23908670c6 --- /dev/null +++ b/content/it/docs/reference/glossary/kubelet.md @@ -0,0 +1,19 @@ +--- +title: Kubelet +id: kubelet +date: 2018-04-12 +full_link: /docs/reference/generated/kubelet +short_description: > + Un agente che è eseguito su ogni nodo del cluster. Si assicura che i container siano eseguiti in un pod. + +aka: +tags: +- fundamental +- core-object +--- + Un agente che è eseguito su ogni nodo del cluster. Si assicura che i container siano eseguiti in un pod. + + + +La kubelet riceve un set di PodSpecs che vengono forniti attraverso vari meccanismi, e si assicura che i container descritti in questi PodSpecs funzionino correttamente e siano sani. La kubelet non gestisce i container che non sono stati creati da Kubernetes. +