# Annotate

Önce kısaca tanımını yapalaım;

Ek Açıklamalar ve Etiketler benzerdir, ancak önemli farklılıkları vardır.

*<mark style="color:red;">**Etiketler ( Annotations ) :**</mark>* OpenShift/Kubernetes tarafından kullanılır, RFC 1123 tarafından en fazla 63 karakterle sınırlandırılmıştır ve "a" kaynağının etiket aracılığıyla "b" kaynağını seçebilmesi için kullanılır.

*<mark style="color:red;">**Ek açıklamalar ( Labels ) :**</mark>* ise RFC 1123 tarafından en fazla 63 karakterle sınırlandırılmamıştır ve bir kaynak hakkında meta veriler içermektedir.

Bazı ek açıklamalar ( Labels ) insanlar içindir (OpenShift/Kuberneters için DEĞİLDİR), bir kaynak hakkında bir tür meta veri görüntülemek içindir (örn. uygulama sahibi: Cahit YOLACAN gibi.)

Bazı ek açıklamalar OpenShift/Kubernetes tarafından kullanılır (örn. deployment.kubernetes.io/revision: "2")

"oc annotate" komutu bir kaynağa açıklama eklemek için kullanılabilir. Örneğin, tamamen rastgele bir örnek olarak, bir dağıtıma "owner" anahtarı ve "cahit.yolacan" değeriyle nasıl açıklama ekleyebileceğinizi aşağıda bulabilirsiniz.

```
oc annotate deployment my-app owner="Cahit YOLACAN"
deployment.apps/my-app annotated
```

Daha sonra --output yaml seçeneği ile oc get deployment komutu kullanılarak dağıtımın artık ek açıklamaya sahip olduğu görülebilir.

```
oc get deployment my-app --output yaml
metadata:
  annotations:
    owner: Cahit YOLACAN
```

Aşağıdaki gibi hata alıyorsanız zaten annotation var demektir.

```
oc annotate deployment my-app owner="Cahit YOLACAN"
error: --overwrite is false but found the following declared annotation(s): 'owner' already has a value (Cahit YOLACAN)
```

Var olan değiştdiğinzidaa gücnelleme mesajı aşağıdaki gibi olacaktır.

```
oc annotate deployment my-app owner="Cahit2 YOLACAN" --overwrite
deployment.apps/my-app annotated
```

GUI arayüzden örnek bir Annotations ayar ekranı.

<figure><img src="https://868269143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSMT05E27MzUeWbLuFPw%2Fuploads%2FxmFx1BckTjNXKRcS7Qj6%2Fannotions.png?alt=media&#x26;token=6159c5f2-6c1f-45bf-96c3-5a78cbf8d338" alt=""><figcaption></figcaption></figure>
