いつもどおりのある日の事 君は突然立ち上がり言った
「Kubernetes で勤怠管理をしよう」
「Kubernetes 上で勤怠管理アプリを動かすのではなく、"Kubernetes" を使って勤怠管理を行うこと」を目標とするコントローラ。
当コントローラで勤怠管理を行うことで、 『俺たちは毎日 Kubernetes を使ってるぞ！』 という謎の達成感（？）に浸ることができる。
当コントローラの機能・詳細は こちら
- Kubernetes クラスターを用意する
- 下記コマンドで当コントローラをデプロイする
$ git clone https://github.com/a2ush/attendance-book-in-kubernetes.git
$ cd attendance-book-in-kubernetes
$ make docker-build docker-push IMG=<YOUR-REGISTRY>/<IMAGE-NAME>:tag
$ make deploy IMG=<YOUR-REGISTRY>/<IMAGE-NAME>:tag
従業員は Custome Resource である AttendanceBook (短縮名 ab) をデプロイし、当日の出欠状況を伝える。
$ cat sample-manifest.yaml
apiVersion: office.a2ush.dev/v1alpha1
kind: AttendanceBook
metadata:
name: sample-user # Your name
spec:
attendance: absent # Input present or absent
reason: "Feel sleepy" # Optional
$ kubectl apply -f sample-manifest.yaml
present, absent 以外の内容を入力した場合は、無効な状況として出欠報告が受け付けられない。
$ kubectl apply -f invalid-attendance.yaml
The AttendanceBook "test-user3" is invalid: spec.attendance: Unsupported value: "almostpresent": supported values: "present", "absent"
また、雇用者が報告を受け付けている Namespace（デフォルト: default） 以外で AttendanceBook をデプロイした場合は、当コントローラにより即時削除されるので気をつける。
$ cat not-permitted.yaml
apiVersion: office.a2ush.dev/v1alpha1
kind: AttendanceBook
metadata:
name: test-user4
namespace: notpermitted
spec:
attendance: present
$ kubectl apply -f not-permitted.yaml
attendancebook.office.a2ush.dev/test-user4 created
$ kubectl get ab -n notpermitted
No resources found in notpermitted namespace.
$ kubectl get event -n notpermitted
LAST SEEN TYPE REASON OBJECT MESSAGE
78s Normal Deleted attendancebook/test-user4 Deleted resource notpermitted/test-user4 due to the namespace that is not allowed to deploy.
もし、最初に伝えた内容と異なる状況になった場合（例: 病気による早退、出勤可能になったなど）は、従業員はすぐに自身の AttendanceBook を更新する。（更新方法は問わない）
Ex)
$ kubectl patch ab sample-user --type='json' \
-p='[{"op": "replace", "path": "/spec/attendance", "value": "present"}, {"op": "replace", "path": "/spec/reason", "value": "My eyes are opened completely"}]'
デフォルトでは、日本時間の 0:00 に全ての AttendanceBook が削除されるため、従業員は日毎に出欠状況を報告する必要がある。
$ TZ=JST-9 date; kubectl get ab
Thu Feb 10 23:50:51 JST 2022
NAME ATTENDANCE REASON REPORT TIME
sample-user present My eyes are opened completely 2022-02-10T14:46:55Z
test-user1 present well 2022-02-10T14:47:02Z
test-user2 absent BLANK 2022-02-10T14:47:05Z
$ TZ=JST-9 date; kubectl get ab
Fri Feb 11 00:00:56 JST 2022
No resources found in default namespace.
雇用者は kubectl get ab コマンドを実行し、各従業員の出勤状況を確認する。
$ kubectl get ab
NAME ATTENDANCE REASON REPORT TIME
sample-user present My eyes are opened completely 2022-02-10T14:46:55Z
test-user1 present well 2022-02-10T14:47:02Z
test-user2 absent BLANK 2022-02-10T14:47:05Z
雇用者は kubectl describe ab コマンドを実行することで、従業員がステータス変更を行ったかどうかを確認することができる。
$ kubectl describe ab sample-user
...
Events:
Type Reason Age From Message
---- ------ ---- ---- -------
Normal Created 2m46s attendancebook-controller Created resource. Attendance/Reason: absent/Feel sleepy
Normal Updated 118s attendancebook-controller Updated resource. Attendance/Reason: present/My eyes are opened completely
従業員の入れ替わり（入社/退社）が発生した場合は、雇用者は 従業員リスト(employee-list ConfigMap) を更新する。 manifest
apiVersion: v1
kind: ConfigMap
metadata:
name: employee-list
namespace: system
data:
Employeelist: |
sample-user
test-user1
test-user2
test-user3
test-user4
従業員リストに記載の無い従業員の AttendanceBook は、コントローラにより削除されるため、雇用者は正しく従業員の名前を設定する。
$ kubectl get event
...
11s Normal Deleted attendancebook/test-user5 Deleted resource default/test-user5 due to no-listed name.
雇用者は Role/RoleBinding(例) を作成し、従業員に対し「特定の Namespace 内の AttendanceBook のみ作成・閲覧・編集ができる」ように設定することもできる。