Initialize Common Label for ID Localization. (#16706)
This commit is contained in:
Irvi Aini
committed by
Kubernetes Prow Robot
Kubernetes Prow Robot
parent
060cbcd0fb
commit
ac1b7eee8e
@@ -0,0 +1,179 @@
|
|||||||
|
---
|
||||||
|
title: Label yang Disarankan
|
||||||
|
content_template: templates/concept
|
||||||
|
---
|
||||||
|
|
||||||
|
{{% capture overview %}}
|
||||||
|
Kamu dapat melakukan visualisasi dan mengatur objek Kubernetes dengan lebih banyak _tools_
|
||||||
|
dibandingkan dengan perintah kubectl dan dasbor. Sekumpulan label mengizinkan _tools_
|
||||||
|
untuk bekerja dengan interoperabilitas, mendeskripsikan objek dengan cara yang umum yang dapat
|
||||||
|
dipahami semua _tools_.
|
||||||
|
|
||||||
|
Sebagai tambahan bagi _tooling_ tambahan, label yang disarankan ini mendeskripsikan
|
||||||
|
aplikasi sehingga informasi yang ada diapat di-_query_.
|
||||||
|
{{% /capture %}}
|
||||||
|
|
||||||
|
{{% capture body %}}
|
||||||
|
Metadata ini diorganisasi berbasis konsep dari sebuah aplikasi. Kubernetes bukan merupakan
|
||||||
|
sebuah platform sebagai sebuah _service_ (_platform as a service_/PaaS) dan tidak
|
||||||
|
mewajibkan sebuah gagasan formal dari sebuah aplikasi.
|
||||||
|
Sebagai gantinya, aplikasi merupakan suatu hal informal yang dideskripsikan melalui metadata.
|
||||||
|
Definisi yang dimiliki oleh sebuah aplikasi merupakan sebuah hal yang cukup longgar.
|
||||||
|
|
||||||
|
{{< note >}}
|
||||||
|
Berikut merupakan label yang disarankan. Label ini mempermudah
|
||||||
|
proses manajemen aplikasi tetapi tidak dibutuhkan untuk _tooling_ utama apa pun.
|
||||||
|
{{< /note >}}
|
||||||
|
|
||||||
|
Label yang digunakan secara umum serta anotasi memiliki prefiks yang serupa: `app.kubernetes.io`. Label
|
||||||
|
tanpa sebuah prefiks bersifat privat khusus pengguna saja. Prefiks yang digunakan secara umum tadi
|
||||||
|
menjamin bahwa label tadi tidak akan mengganggu label _custom_ yang diberikan oleh pengguna.
|
||||||
|
|
||||||
|
## Label
|
||||||
|
|
||||||
|
Untuk mendapatkan keuntungan menyeluruh dari penggunaan label ini,
|
||||||
|
label harus digunakan pada seluruh objek sumber daya.
|
||||||
|
|
||||||
|
| _Key_ | Deskripsi | Contoh | Tipe |
|
||||||
|
| ----------------------------------- | --------------------- | -------- | ---- |
|
||||||
|
| `app.kubernetes.io/name` | Nama aplikasi | `mysql` | string |
|
||||||
|
| `app.kubernetes.io/instance` | Nama unik yang bersifat sebagai pengidentifikasi dari sebuah instans aplikasi | `wordpress-abcxzy` | string |
|
||||||
|
| `app.kubernetes.io/version` | Versi saat ini dari aplikasi (misalnya sebuah versi semantik, hash revisi, etc.) | `5.7.21` | string |
|
||||||
|
| `app.kubernetes.io/component` | Komponen yang ada pada arsitektur | `database` | string |
|
||||||
|
| `app.kubernetes.io/part-of` | Nama dari komponen lebih tinggi dari aplikasi yang mencakup bagian ini | `wordpress` | string |
|
||||||
|
| `app.kubernetes.io/managed-by` | Alat yang digunakan untuk mengatur operasi pada aplikasi | `helm` | string |
|
||||||
|
|
||||||
|
Untuk memberikan ilustrasi dari penggunaan label, bayangkan sebuah objek StatefulSet yang didefinisikan sebagai berikut:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
apiVersion: apps/v1
|
||||||
|
kind: StatefulSet
|
||||||
|
metadata:
|
||||||
|
labels:
|
||||||
|
app.kubernetes.io/name: mysql
|
||||||
|
app.kubernetes.io/instance: wordpress-abcxzy
|
||||||
|
app.kubernetes.io/version: "5.7.21"
|
||||||
|
app.kubernetes.io/component: database
|
||||||
|
app.kubernetes.io/part-of: wordpress
|
||||||
|
app.kubernetes.io/managed-by: helm
|
||||||
|
```
|
||||||
|
|
||||||
|
## Aplikasi dan Instans Aplikasi
|
||||||
|
|
||||||
|
Sebuah aplikasi dapat diinstal sekali atau beberapa kali di dalam kluster Kubernetes dan,
|
||||||
|
pada beberapa kasus, di dalam sebuah _namespace_ yang sama. Misalnya, wordpress dapat
|
||||||
|
diinstal lebih dari satu kali dimana situs web yang berbeda merupakan hasil instalasi yang berbeda.
|
||||||
|
|
||||||
|
Nama dari sebuah aplikasi dan nama instans akan dicatat secara terpisah. Sebagai contoh,
|
||||||
|
WordPress memiliki `wordpress` sebagai nilai dari `app.kubernetes.io/name` dimana
|
||||||
|
nama instans yang digunakan adalah `wordpress-abcxzy` yang merupakan nilai dari `app.kubernetes.io/instance`.
|
||||||
|
Hal ini memungkinkan aplikasi dan instans aplikasi untuk dapat diidentifikasi. Setiap instans dari aplikasi
|
||||||
|
haruslah memiliki nama yang unik.
|
||||||
|
|
||||||
|
## Contoh
|
||||||
|
|
||||||
|
Untuk memberikan ilustrasi dengan cara yang berbeda pada penggunaan label, contoh di bawah ini
|
||||||
|
memiliki tingkat kompleksitas yang cukup beragam.
|
||||||
|
|
||||||
|
### Sebuah Aplikasi _Stateless_ Sederhana
|
||||||
|
|
||||||
|
Bayangkan sebuah kasus dimana sebuah aplikasi _stateless_ di-_deploy_
|
||||||
|
menggunakan Deployment dan Service. Di bawah ini merupakan
|
||||||
|
contoh kutipan yang merepresentasikan bagaimana
|
||||||
|
label dapat digunakan secara sederhana.
|
||||||
|
|
||||||
|
Deployment digunakan untuk memastikan Pod dijalankan untuk aplikasi itu sendiri.
|
||||||
|
```yaml
|
||||||
|
apiVersion: apps/v1
|
||||||
|
kind: Deployment
|
||||||
|
metadata:
|
||||||
|
labels:
|
||||||
|
app.kubernetes.io/name: myservice
|
||||||
|
app.kubernetes.io/instance: myservice-abcxzy
|
||||||
|
...
|
||||||
|
```
|
||||||
|
|
||||||
|
Service digunakan untuk mengekspos aplikasi.
|
||||||
|
```yaml
|
||||||
|
apiVersion: v1
|
||||||
|
kind: Service
|
||||||
|
metadata:
|
||||||
|
labels:
|
||||||
|
app.kubernetes.io/name: myservice
|
||||||
|
app.kubernetes.io/instance: myservice-abcxzy
|
||||||
|
...
|
||||||
|
```
|
||||||
|
|
||||||
|
### Sebuah Aplikasi Web dengan Basis Data
|
||||||
|
|
||||||
|
Bayangkan sebuah aplikasi yang lebih kompleks: sebuah aplikasi web (WordPress)
|
||||||
|
yang menggunakan basis data (MySQL), yang diinstal menggunakan Helm.
|
||||||
|
Kutipan berikut merepresentasikan objek yang di-_deploy_ untuk aplikasi ini.
|
||||||
|
|
||||||
|
Berikut merupakan konfigurasi Deployment yang digunakan untuk WordPress:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
apiVersion: apps/v1
|
||||||
|
kind: Deployment
|
||||||
|
metadata:
|
||||||
|
labels:
|
||||||
|
app.kubernetes.io/name: wordpress
|
||||||
|
app.kubernetes.io/instance: wordpress-abcxzy
|
||||||
|
app.kubernetes.io/version: "4.9.4"
|
||||||
|
app.kubernetes.io/managed-by: helm
|
||||||
|
app.kubernetes.io/component: server
|
||||||
|
app.kubernetes.io/part-of: wordpress
|
||||||
|
...
|
||||||
|
```
|
||||||
|
|
||||||
|
Service yang digunakan untuk mengekspos WordPress:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
apiVersion: v1
|
||||||
|
kind: Service
|
||||||
|
metadata:
|
||||||
|
labels:
|
||||||
|
app.kubernetes.io/name: wordpress
|
||||||
|
app.kubernetes.io/instance: wordpress-abcxzy
|
||||||
|
app.kubernetes.io/version: "4.9.4"
|
||||||
|
app.kubernetes.io/managed-by: helm
|
||||||
|
app.kubernetes.io/component: server
|
||||||
|
app.kubernetes.io/part-of: wordpress
|
||||||
|
...
|
||||||
|
```
|
||||||
|
|
||||||
|
MySQL diekspos sebagai StatefulSet dengan metadata yang digunakan untuk StatefulSet tersebut serta aplikasi yang menggunakannya:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
apiVersion: apps/v1
|
||||||
|
kind: StatefulSet
|
||||||
|
metadata:
|
||||||
|
labels:
|
||||||
|
app.kubernetes.io/name: mysql
|
||||||
|
app.kubernetes.io/instance: mysql-abcxzy
|
||||||
|
app.kubernetes.io/version: "5.7.21"
|
||||||
|
app.kubernetes.io/managed-by: helm
|
||||||
|
app.kubernetes.io/component: database
|
||||||
|
app.kubernetes.io/part-of: wordpress
|
||||||
|
...
|
||||||
|
```
|
||||||
|
|
||||||
|
Service yang digunakan untuk mengekspos MySQL sebagai bagian dari WordPress:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
apiVersion: v1
|
||||||
|
kind: Service
|
||||||
|
metadata:
|
||||||
|
labels:
|
||||||
|
app.kubernetes.io/name: mysql
|
||||||
|
app.kubernetes.io/instance: mysql-abcxzy
|
||||||
|
app.kubernetes.io/version: "5.7.21"
|
||||||
|
app.kubernetes.io/managed-by: helm
|
||||||
|
app.kubernetes.io/component: database
|
||||||
|
app.kubernetes.io/part-of: wordpress
|
||||||
|
...
|
||||||
|
```
|
||||||
|
|
||||||
|
Dengan StatefulSet MySQL dan Service kamu dapat mengetahui informasi yang ada pada MySQL dan Wordpress.
|
||||||
|
|
||||||
|
{{% /capture %}}
|
||||||
Reference in New Issue
Block a user