Annotate

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

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

Etiketler ( Annotations ) : 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.

Ek açıklamalar ( Labels ) : 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ı.