Skip to content

Commit

Permalink
Finish high-level translation
Browse files Browse the repository at this point in the history
  • Loading branch information
koneko096 committed Jan 14, 2020
1 parent 16115c8 commit f21c8b8
Showing 1 changed file with 36 additions and 36 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -23,40 +23,40 @@ dan sumber daya komputasi sejenis lainnya yang perlu inisialisasi dan setelan sp

## Pendaftaran plugin perangkat

The kubelet exports a `Registration` gRPC service:
Kubelet mengekspor servis gRPC `Registration`:

```gRPC
service Registration {
rpc Register(RegisterRequest) returns (Empty) {}
}
```

A device plugin can register itself with the kubelet through this gRPC service.
During the registration, the device plugin needs to send:
Plugin perangkat bisa mendaftarkan dirinya sendiri dengan kubelet melalui servis gRPC.
Dalam pendaftaran, plugin perangkat perlu mengirim:

* The name of its Unix socket.
* The Device Plugin API version against which it was built.
* The `ResourceName` it wants to advertise. Here `ResourceName` needs to follow the
[extended resource naming scheme](/docs/concepts/configuration/manage-compute-resources-container/#extended-resources)
as `vendor-domain/resourcetype`.
(For example, an NVIDIA GPU is advertised as `nvidia.com/gpu`.)
* Nama Unix socket-nya.
* Versi API Plugin Perangkat yang dipakai.
* `ResourceName` yang ingin ditunjukkan. `ResourceName` ini harus mengikuti
[skema penamaan sumber daya ekstensi](/docs/concepts/configuration/manage-compute-resources-container/#extended-resources)
sebagai `vendor-domain/tipe-sumber-daya`.
(Contohnya, NVIDIA GPU akan dinamai `nvidia.com/gpu`.)

Following a successful registration, the device plugin sends the kubelet the
list of devices it manages, dan the kubelet is then in charge of advertising those
Setelah registrasi sukses, plugin perangkat mengirim daftar perangkat yang diatur
ke kubelet, lalu kubelet kemudian in charge of advertising those
resources to the API server as part of the kubelet node status update.
For example, after a device plugin registers `hardware-vendor.example/foo` with the kubelet
and reports two healthy devices on a node, the node status is updated
to advertise that the node has 2 “Foo” devices installed dan available.
Contohnya, setelah plugin perangkat mendaftarkan `hardware-vendor.example/foo` dengan kubelet
dan melaporkan kedua perangkat dalam node dalam kondisi sehat, status node diperbarui
untuk menunjukkan bahwa node punya 2 perangkat “Foo” terpasang dan tersedia.

Then, users can request devices in a
[Container](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#container-v1-core)
specification as they request other types of resources, with the following limitations:
Kemudian, pengguna dapat meminta perangkat dalam spesifikasi
[Kontainer](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#container-v1-core)
seperti meminta tipe sumber daya lain, dengan batasan berikut:

* Extended resources are only supported as integer resources dan cannot be overcommitted.
* Devices cannot be shared among Containers.
* Sumber daya ekstensi hanya didukung sebagai sumber daya integer dan tidak bisa overcommitted.
* Perangkat tidak bisa dibagikan antar Kontainer.

Suppose a Kubernetes cluster is running a device plugin that advertises resource `hardware-vendor.example/foo`
on certain nodes. Here is an example of a pod requesting this resource to run a demo workload:
Semisal klaster Kubernetes menjalankan plugin perangkat yang menunjukkan sumber daya `hardware-vendor.example/foo`
pada node tertentu. Berikut contoh pod yang meminta sumber daya itu untuk menjalankan demo workload:

```yaml
---
Expand Down Expand Up @@ -153,15 +153,15 @@ menjamin fungsi berkelanjutan dari alokasi perangkat selama pembaruan.

{{< feature-state for_k8s_version="v1.15" state="beta" >}}

In order to monitor resources provided by device plugins, monitoring agents need to be able to
discover the set of devices that are in-use on the node dan obtain metadata to describe which
container the metric should be associated with. [Prometheus](https://prometheus.io/) metrics
exposed by device monitoring agents should follow the
[Kubernetes Instrumentation Guidelines](https://github.com/kubernetes/community/blob/master/contributors/devel/sig-instrumentation/instrumentation.md),
identifying containers using `pod`, `namespace`, dan `container` prometheus labels.
Dalam rangka mengawasi sumber daya yang disediakan plugin perangkat, agen monitoring perlu bisa
menemukan kumpulan perangkat yang terpakai dalam node dan mengambil metadata untuk mendeskripsikan
pada kontainer mana metrik harus diasosiasikan. Metrik [prometheus](https://prometheus.io/)
diekspos oleh agen monitoring perangkat harus mengikuti
[Petunjuk Instrumentasi Kubernetes](https://github.com/kubernetes/community/blob/master/contributors/devel/sig-instrumentation/instrumentation.md),
mengidentifikasi kontainer dengan label prometheus `pod`, `namespace`, dan `container`.

The kubelet provides a gRPC service to enable discovery of in-use devices, dan to provide metadata
for these devices:
Kubelet menyediakan servis gRPC untuk menyalakan pencarian perangkat yang terpakai, dan untuk menyediakan metadata
untuk perangkat berikut:

```gRPC
// PodResourcesLister is a service provided by the kubelet that provides information about the
Expand All @@ -171,13 +171,13 @@ service PodResourcesLister {
}
```

The gRPC service is served over a unix socket at `/var/lib/kubelet/pod-resources/kubelet.sock`.
Monitoring agents for device plugin resources can be deployed as a daemon, or as a DaemonSet.
The canonical directory `/var/lib/kubelet/pod-resources` requires privileged access, so monitoring
agents must run in a privileged security context. If a device monitoring agent is running as a
DaemonSet, `/var/lib/kubelet/pod-resources` must be mounted as a
{{< glossary_tooltip term_id="volume" >}} in the plugin's
[PodSpec](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#podspec-v1-core).
Servis gRPC diserved lewat socket unix pada `/var/lib/kubelet/pod-resources/kubelet.sock`.
Agen monitoring untuk sumber daya plugin perangkat dapat dideploy sebagai daemon, atau sebagai DaemonSet.
Directory canonical `/var/lib/kubelet/pod-resources` perlu privileged access,
sehingga agen monitoring harus berjalan dalam konteks keamanan privileged. Jika agen monitoring perangkat berjalan
sebagai DaemonSet, `/var/lib/kubelet/pod-resources` harus dimuat sebagai
{{< glossary_tooltip term_id="volume" >}} pada
[PodSpec](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#podspec-v1-core) plugin.

Dukungan untuk "servis PodResources" butuh [gerbang fitur](/docs/reference/command-line-tools-reference/feature-gates/)
`KubeletPodResources` untuk dinyalakan. Mulai dari Kubernetes 1.15 nilai bawaannya telah dinyalakan.
Expand Down

0 comments on commit f21c8b8

Please sign in to comment.