feat(deploy): frontend를 non-root로 돌리는 component를 둔다
비특권 nginx 이미지는 uid 101로 8080을 연다. 지금 운영 매니페스트는 pod 포트 80, probe 80, root를 전제로 한다. deploy/production/frontend-nonroot에 Kustomize component를 둔다. 켜면 frontend Deployment가 containerPort·probe 8080, runAsNonRoot·uid/gid 101, capabilities drop ALL이 되고, Service targetPort가 8080, Traefik → frontend NetworkPolicy 포트가 8080이 된다. Service port는 80 그대로라 Ingress는 바뀌지 않는다. ports 목록은 containerPort로 합쳐져 80이 남으므로 $patch: replace로 바꾼다. 기본 경로에는 넣지 않는다. 지금 운영 이미지 7a4e201은 root로 80을 열어, 켜면 probe가 모두 실패한다. README는 이미지를 비특권 Dockerfile이 들어간 commit에서 다시 만들고, 운영에만 있는 로컬 4커밋도 그 commit에 들어가 있어야 한다고 적는다. 그 이미지로 태그를 바꾸는 같은 커밋에서 켠다. 위험·한계: 운영 frontend의 source(7a4e201)가 Gitea에 없어서, 지금 main에서 이미지를 만들면 운영에만 있는 4커밋이 빠진다. 아직 적용하지 않았다. 검증: component를 켠 렌더에서 pod 포트·probe가 8080, Service targetPort 8080, NetworkPolicy 8080, securityContext가 위와 같다. kubectl apply --dry-run=server는 통과하고, frontend의 PSA restricted 경고가 사라졌다.
This commit is contained in:
@@ -26,9 +26,8 @@ Git 밖에서 만든다.
|
||||
레지스트리에서 다시 받는다.
|
||||
- 세 파드 모두 `priorityClassName: platform-critical`(platform-core `services/priority-classes`)이고
|
||||
seccomp는 `RuntimeDefault`다.
|
||||
- **frontend non-root는 남은 일이다.** nginx 공식 이미지는 root로 시작해 80번을 열고 worker를
|
||||
`nginx`로 내린다. 권한을 버리거나 non-root로 돌리려면 이미지를 비특권 nginx(8080)로 바꾸고 Service
|
||||
`targetPort`와 probe를 같이 바꿔야 한다.
|
||||
- frontend non-root는 `frontend-nonroot/` component로 둔다(아래). 지금 운영 이미지 `7a4e201`은 root로
|
||||
80번을 열기 때문에 아직 켜지 않는다.
|
||||
|
||||
## 적용
|
||||
|
||||
@@ -124,3 +123,35 @@ curl -s -o /dev/null -w '%{http_code}\n' https://hyeonworks.com/api/v1/public/ho
|
||||
|
||||
되돌리기: `kubectl -n hyeonworks-prod rollout undo deploy/techlog-backend`. 그다음 `components`를 빼는
|
||||
커밋을 만든다. ConfigMap `techlog-backend-prod-env`는 남아 있어도 해가 없다.
|
||||
|
||||
## frontend non-root (`frontend-nonroot/`, 아직 켜지 않음)
|
||||
|
||||
이 repo의 `Dockerfile`은 runtime을 `nginxinc/nginx-unprivileged:1.27.5-alpine`(예전 base와 같은 NGINX 판·Alpine)으로
|
||||
만든다. master가 uid 101로 돌고 8080을 연다(`scripts/generate-nginx-config.ts`). `frontend-nonroot/`
|
||||
component는 그 이미지에 맞춰 다음을 바꾼다.
|
||||
|
||||
| 객체 | 바뀌는 것 |
|
||||
| --- | --- |
|
||||
| Deployment `techlog-frontend` | `containerPort` 8080, liveness·readiness probe 8080, `runAsNonRoot`·uid/gid 101, `drop: [ALL]` |
|
||||
| Service `techlog-frontend` | `targetPort` 80 → 8080(`port`는 80 그대로라 Ingress는 안 바뀐다) |
|
||||
| NetworkPolicy `techlog-frontend-ingress` | Traefik → pod 포트 80 → 8080 |
|
||||
|
||||
### 켜는 순서
|
||||
|
||||
1. 이 Dockerfile이 들어간 commit에서 frontend 이미지를 만든다. **운영 `7a4e201`에만 있는 커밋(로컬
|
||||
브랜치 `chore/template-sync-v0.2.0`, main보다 4개 앞)이 그 commit에 들어 있어야 한다.** 빠지면 그
|
||||
4개(다크 모드 글씨, 2KB 넘는 본문 저장, 제목 문구, 템플릿 동기화)가 운영에서 되돌아간다.
|
||||
2. 그 이미지를 레지스트리에 push한다(위 「적용」의 전제 1과 같은 방법).
|
||||
3. 한 커밋에서 `frontend-deployment.yaml`의 이미지 태그를 새 태그로 바꾸고, `kustomization.yaml`에
|
||||
`components: [frontend-nonroot]`를 더한다(`prod-profile`이 켜져 있으면 목록에 같이 둔다).
|
||||
4. 적용과 확인:
|
||||
|
||||
```bash
|
||||
kubectl diff -k deploy/production
|
||||
kubectl apply -k deploy/production
|
||||
kubectl -n hyeonworks-prod rollout status deploy/techlog-frontend
|
||||
curl -s -o /dev/null -w '%{http_code}\n' https://hyeonworks.com/config.json
|
||||
```
|
||||
|
||||
되돌리기: `kubectl -n hyeonworks-prod rollout undo deploy/techlog-frontend`. 그다음 3의 커밋을 되돌리는
|
||||
커밋을 만들고 다시 적용한다(Service와 NetworkPolicy 포트도 80으로 돌아가야 한다).
|
||||
|
||||
@@ -0,0 +1,35 @@
|
||||
apiVersion: apps/v1
|
||||
kind: Deployment
|
||||
metadata:
|
||||
name: techlog-frontend
|
||||
spec:
|
||||
template:
|
||||
spec:
|
||||
securityContext:
|
||||
runAsNonRoot: true
|
||||
runAsUser: 101
|
||||
runAsGroup: 101
|
||||
seccompProfile:
|
||||
type: RuntimeDefault
|
||||
containers:
|
||||
- name: frontend
|
||||
# replace, not merge: ports merge on containerPort, which would
|
||||
# keep the old 80 entry next to 8080 under the same name.
|
||||
ports:
|
||||
- $patch: replace
|
||||
- name: http
|
||||
containerPort: 8080
|
||||
protocol: TCP
|
||||
securityContext:
|
||||
allowPrivilegeEscalation: false
|
||||
capabilities:
|
||||
drop:
|
||||
- ALL
|
||||
livenessProbe:
|
||||
httpGet:
|
||||
path: /config.json
|
||||
port: 8080
|
||||
readinessProbe:
|
||||
httpGet:
|
||||
path: /config.json
|
||||
port: 8080
|
||||
@@ -0,0 +1,20 @@
|
||||
# NetworkPolicy ports are pod ports: Traefik now reaches the pod on 8080.
|
||||
apiVersion: networking.k8s.io/v1
|
||||
kind: NetworkPolicy
|
||||
metadata:
|
||||
name: techlog-frontend-ingress
|
||||
spec:
|
||||
podSelector:
|
||||
matchLabels:
|
||||
app: techlog-frontend
|
||||
ingress:
|
||||
- from:
|
||||
- namespaceSelector:
|
||||
matchLabels:
|
||||
kubernetes.io/metadata.name: kube-system
|
||||
podSelector:
|
||||
matchLabels:
|
||||
app.kubernetes.io/name: traefik
|
||||
ports:
|
||||
- protocol: TCP
|
||||
port: 8080
|
||||
@@ -0,0 +1,12 @@
|
||||
# The Service keeps port 80, so the Ingress and anything that calls
|
||||
# techlog-frontend:80 do not change; only the pod side moves to 8080.
|
||||
apiVersion: v1
|
||||
kind: Service
|
||||
metadata:
|
||||
name: techlog-frontend
|
||||
spec:
|
||||
ports:
|
||||
- name: http
|
||||
port: 80
|
||||
protocol: TCP
|
||||
targetPort: 8080
|
||||
@@ -0,0 +1,15 @@
|
||||
apiVersion: kustomize.config.k8s.io/v1alpha1
|
||||
kind: Component
|
||||
|
||||
# Opt-in: runs techlog-frontend as uid 101 on port 8080 with every capability
|
||||
# dropped. Needs an image built from a commit that has the unprivileged
|
||||
# Dockerfile; the 7a4e201 image listens on 80 as root and would fail every
|
||||
# probe. Enable it in the same commit that moves the frontend image tag, by
|
||||
# adding
|
||||
# components:
|
||||
# - frontend-nonroot
|
||||
# to ../kustomization.yaml. See ../README.md ("frontend non-root").
|
||||
patches:
|
||||
- path: frontend-deployment-patch.yaml
|
||||
- path: frontend-service-patch.yaml
|
||||
- path: frontend-network-policy-patch.yaml
|
||||
Reference in New Issue
Block a user