feat(ql3): establish 3.0 incubation baseline

deploy/kubernetes/ql3-cluster/operations/plugin-package-management/base/deployment.yaml

@@ -0,0 +1,215 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: ql3-plugin-package-management
+  namespace: qinglong3-system
+  labels:
+    app.kubernetes.io/name: ql3-plugin-package-management
+    app.kubernetes.io/component: plugin-package-management
+    app.kubernetes.io/part-of: qinglong3
+spec:
+  replicas: 2
+  minReadySeconds: 10
+  revisionHistoryLimit: 3
+  progressDeadlineSeconds: 600
+  strategy:
+    type: RollingUpdate
+    rollingUpdate:
+      maxUnavailable: 0
+      maxSurge: 1
+  selector:
+    matchLabels:
+      app.kubernetes.io/name: ql3-plugin-package-management
+      app.kubernetes.io/component: plugin-package-management
+  template:
+    metadata:
+      labels:
+        app.kubernetes.io/name: ql3-plugin-package-management
+        app.kubernetes.io/component: plugin-package-management
+        app.kubernetes.io/part-of: qinglong3
+    spec:
+      serviceAccountName: ql3-plugin-package-management
+      automountServiceAccountToken: false
+      terminationGracePeriodSeconds: 30
+      securityContext:
+        runAsNonRoot: true
+        runAsUser: 10001
+        runAsGroup: 10001
+        fsGroup: 10001
+        seccompProfile:
+          type: RuntimeDefault
+      affinity:
+        podAntiAffinity:
+          requiredDuringSchedulingIgnoredDuringExecution:
+            - topologyKey: kubernetes.io/hostname
+              labelSelector:
+                matchLabels:
+                  app.kubernetes.io/name: ql3-plugin-package-management
+                  app.kubernetes.io/component: plugin-package-management
+      containers:
+        - name: management
+          image: qinglong3-cluster-admin:3.0.0-alpha.0
+          imagePullPolicy: IfNotPresent
+          command:
+            - node
+            - /opt/qinglong/node_modules/@qinglong/cluster-admin/dist/plugin-package/management/pluginPackageManagementCli.js
+          securityContext:
+            allowPrivilegeEscalation: false
+            readOnlyRootFilesystem: true
+            capabilities:
+              drop:
+                - ALL
+          env:
+            - name: QL3_PROFILE
+              value: cluster-admin
+            - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_ENABLED
+              value: 'true'
+            - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_HOST
+              value: 0.0.0.0
+            - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_PORT
+              value: '8443'
+            - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_TLS_CERT_FILE
+              value: /var/run/secrets/qinglong3/plugin-package-management-tls/tls.crt
+            - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_TLS_KEY_FILE
+              value: /var/run/secrets/qinglong3/plugin-package-management-tls/tls.key
+            - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_IDENTITY_KEYSET_FILE
+              value: /var/run/qinglong3/plugin-package-management-identity/keyset.json
+            - name: QL3_PLUGIN_PACKAGE_PUBLISHER_TRUST_FILE
+              value: /var/run/qinglong3/plugin-package-trust/publishers.json
+            - name: QL3_PLUGIN_PACKAGE_TRUST_AUTHORITY_PROJECT_ID
+              value: cluster-trust-authority
+            - name: QL3_PLUGIN_PACKAGE_TRUST_AUTHORITY_ID
+              value: cluster
+            - name: QL3_PLUGIN_PACKAGE_TRUST_OBSERVER_ID
+              value: cluster-package-manager
+            - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_APPROVAL_LIFETIME_MS
+              value: '900000'
+            - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_QUOTA_WINDOW_MS
+              value: '60000'
+            - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_PROPOSE_QUOTA
+              value: '30'
+            - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_DECIDE_QUOTA
+              value: '60'
+            - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_INSPECT_QUOTA
+              value: '600'
+            - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_MAX_BODY_BYTES
+              value: '65536'
+            - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_MAX_CONNECTIONS
+              value: '32'
+            - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_MAX_CONCURRENT_REQUESTS
+              value: '16'
+            - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_REQUEST_TIMEOUT_MS
+              value: '10000'
+            - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_DRAIN_TIMEOUT_MS
+              value: '10000'
+            - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_RATE_WINDOW_MS
+              value: '60000'
+            - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_PEER_REQUEST_LIMIT
+              value: '60'
+            - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_GLOBAL_REQUEST_LIMIT
+              value: '600'
+            - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_MAX_RATE_LIMIT_PEERS
+              value: '512'
+            - name: QL3_POSTGRES_PACKAGE_MANAGER_TLS_MODE
+              value: verify-full
+            - name: QL3_POSTGRES_PACKAGE_MANAGER_TLS_CA_FILE
+              value: /var/run/secrets/qinglong3/postgres-package-manager/ca.crt
+            - name: QL3_POSTGRES_PACKAGE_MANAGER_APPLICATION_NAME
+              value: qinglong3-plugin-package-manager
+            - name: QL3_POSTGRES_PACKAGE_MANAGER_MAX_CONNECTIONS
+              value: '2'
+            - name: QL3_POSTGRES_PACKAGE_MANAGER_URL
+              valueFrom:
+                secretKeyRef:
+                  name: ql3-cluster-plugin-package-management-database
+                  key: postgres-package-manager-url
+            - name: QL3_POSTGRES_PACKAGE_MANAGER_TLS_SERVERNAME
+              valueFrom:
+                secretKeyRef:
+                  name: ql3-cluster-plugin-package-management-database
+                  key: postgres-tls-servername
+          ports:
+            - name: https
+              containerPort: 8443
+              protocol: TCP
+          startupProbe:
+            httpGet:
+              path: /livez
+              port: https
+              scheme: HTTPS
+            periodSeconds: 2
+            timeoutSeconds: 1
+            failureThreshold: 30
+          readinessProbe:
+            httpGet:
+              path: /readyz
+              port: https
+              scheme: HTTPS
+            periodSeconds: 5
+            timeoutSeconds: 2
+            failureThreshold: 2
+          livenessProbe:
+            httpGet:
+              path: /livez
+              port: https
+              scheme: HTTPS
+            periodSeconds: 10
+            timeoutSeconds: 2
+            failureThreshold: 3
+          resources:
+            requests:
+              cpu: 100m
+              memory: 128Mi
+            limits:
+              cpu: '1'
+              memory: 512Mi
+          volumeMounts:
+            - name: tmp
+              mountPath: /tmp
+            - name: management-tls
+              mountPath: /var/run/secrets/qinglong3/plugin-package-management-tls
+              readOnly: true
+            - name: management-identity
+              mountPath: /var/run/qinglong3/plugin-package-management-identity
+              readOnly: true
+            - name: plugin-package-trust
+              mountPath: /var/run/qinglong3/plugin-package-trust
+              readOnly: true
+            - name: postgres-package-manager-ca
+              mountPath: /var/run/secrets/qinglong3/postgres-package-manager
+              readOnly: true
+      volumes:
+        - name: tmp
+          emptyDir:
+            medium: Memory
+            sizeLimit: 16Mi
+        - name: management-tls
+          secret:
+            secretName: ql3-plugin-package-management-tls
+            defaultMode: 288
+            items:
+              - key: tls.crt
+                path: tls.crt
+              - key: tls.key
+                path: tls.key
+        - name: management-identity
+          secret:
+            secretName: ql3-plugin-package-management-identity
+            defaultMode: 292
+            items:
+              - key: keyset.json
+                path: keyset.json
+        - name: plugin-package-trust
+          configMap:
+            name: ql3-plugin-publisher-trust
+            defaultMode: 292
+            items:
+              - key: publishers.json
+                path: publishers.json
+        - name: postgres-package-manager-ca
+          secret:
+            secretName: ql3-cluster-plugin-package-management-database
+            defaultMode: 292
+            items:
+              - key: postgres-ca.crt
+                path: ca.crt

deploy/kubernetes/ql3-cluster/operations/plugin-package-management/base/kustomization.yaml

@@ -0,0 +1,9 @@
+apiVersion: kustomize.config.k8s.io/v1beta1
+kind: Kustomization
+
+resources:
+  - service-account.yaml
+  - service.yaml
+  - deployment.yaml
+  - pod-disruption-budget.yaml
+  - network-policy.yaml

deploy/kubernetes/ql3-cluster/operations/plugin-package-management/base/network-policy.yaml

@@ -0,0 +1,38 @@
+apiVersion: networking.k8s.io/v1
+kind: NetworkPolicy
+metadata:
+  name: ql3-plugin-package-management
+  namespace: qinglong3-system
+  labels:
+    app.kubernetes.io/name: ql3-plugin-package-management
+    app.kubernetes.io/component: plugin-package-management
+    app.kubernetes.io/part-of: qinglong3
+spec:
+  podSelector:
+    matchLabels:
+      app.kubernetes.io/name: ql3-plugin-package-management
+      app.kubernetes.io/component: plugin-package-management
+  policyTypes:
+    - Ingress
+    - Egress
+  ingress:
+    - from:
+        - podSelector:
+            matchLabels:
+              qinglong.io/plugin-package-management-client: 'true'
+      ports:
+        - protocol: TCP
+          port: 8443
+  egress:
+    - to:
+        - namespaceSelector:
+            matchLabels:
+              kubernetes.io/metadata.name: kube-system
+          podSelector:
+            matchLabels:
+              k8s-app: kube-dns
+      ports:
+        - protocol: UDP
+          port: 53
+        - protocol: TCP
+          port: 53

deploy/kubernetes/ql3-cluster/operations/plugin-package-management/base/pod-disruption-budget.yaml

@@ -0,0 +1,15 @@
+apiVersion: policy/v1
+kind: PodDisruptionBudget
+metadata:
+  name: ql3-plugin-package-management
+  namespace: qinglong3-system
+  labels:
+    app.kubernetes.io/name: ql3-plugin-package-management
+    app.kubernetes.io/component: plugin-package-management
+    app.kubernetes.io/part-of: qinglong3
+spec:
+  minAvailable: 1
+  selector:
+    matchLabels:
+      app.kubernetes.io/name: ql3-plugin-package-management
+      app.kubernetes.io/component: plugin-package-management

deploy/kubernetes/ql3-cluster/operations/plugin-package-management/base/service-account.yaml

@@ -0,0 +1,10 @@
+apiVersion: v1
+kind: ServiceAccount
+metadata:
+  name: ql3-plugin-package-management
+  namespace: qinglong3-system
+  labels:
+    app.kubernetes.io/name: ql3-plugin-package-management
+    app.kubernetes.io/component: plugin-package-management
+    app.kubernetes.io/part-of: qinglong3
+automountServiceAccountToken: false

deploy/kubernetes/ql3-cluster/operations/plugin-package-management/base/service.yaml

@@ -0,0 +1,19 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: ql3-plugin-package-management
+  namespace: qinglong3-system
+  labels:
+    app.kubernetes.io/name: ql3-plugin-package-management
+    app.kubernetes.io/component: plugin-package-management
+    app.kubernetes.io/part-of: qinglong3
+spec:
+  type: ClusterIP
+  selector:
+    app.kubernetes.io/name: ql3-plugin-package-management
+    app.kubernetes.io/component: plugin-package-management
+  ports:
+    - name: https
+      port: 8443
+      targetPort: https
+      protocol: TCP

deploy/kubernetes/ql3-cluster/operations/plugin-package-management/cloudnative-pg/deployment-patch.yaml

@@ -0,0 +1,85 @@
+- op: replace
+  path: /spec/template/spec/containers/0/env
+  value:
+    - name: QL3_PROFILE
+      value: cluster-admin
+    - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_ENABLED
+      value: 'true'
+    - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_HOST
+      value: 0.0.0.0
+    - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_PORT
+      value: '8443'
+    - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_TLS_CERT_FILE
+      value: /var/run/secrets/qinglong3/plugin-package-management-tls/tls.crt
+    - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_TLS_KEY_FILE
+      value: /var/run/secrets/qinglong3/plugin-package-management-tls/tls.key
+    - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_IDENTITY_KEYSET_FILE
+      value: /var/run/qinglong3/plugin-package-management-identity/keyset.json
+    - name: QL3_PLUGIN_PACKAGE_PUBLISHER_TRUST_FILE
+      value: /var/run/qinglong3/plugin-package-trust/publishers.json
+    - name: QL3_PLUGIN_PACKAGE_TRUST_AUTHORITY_PROJECT_ID
+      value: cluster-trust-authority
+    - name: QL3_PLUGIN_PACKAGE_TRUST_AUTHORITY_ID
+      value: cluster
+    - name: QL3_PLUGIN_PACKAGE_TRUST_OBSERVER_ID
+      value: cluster-package-manager
+    - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_APPROVAL_LIFETIME_MS
+      value: '900000'
+    - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_QUOTA_WINDOW_MS
+      value: '60000'
+    - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_PROPOSE_QUOTA
+      value: '30'
+    - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_DECIDE_QUOTA
+      value: '60'
+    - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_INSPECT_QUOTA
+      value: '600'
+    - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_MAX_BODY_BYTES
+      value: '65536'
+    - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_MAX_CONNECTIONS
+      value: '32'
+    - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_MAX_CONCURRENT_REQUESTS
+      value: '16'
+    - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_REQUEST_TIMEOUT_MS
+      value: '10000'
+    - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_DRAIN_TIMEOUT_MS
+      value: '10000'
+    - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_RATE_WINDOW_MS
+      value: '60000'
+    - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_PEER_REQUEST_LIMIT
+      value: '60'
+    - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_GLOBAL_REQUEST_LIMIT
+      value: '600'
+    - name: QL3_PLUGIN_PACKAGE_MANAGEMENT_MAX_RATE_LIMIT_PEERS
+      value: '512'
+    - name: QL3_POSTGRES_PACKAGE_MANAGER_TLS_MODE
+      value: verify-full
+    - name: QL3_POSTGRES_PACKAGE_MANAGER_TLS_CA_FILE
+      value: /var/run/secrets/qinglong3/postgres-package-manager/ca.crt
+    - name: QL3_POSTGRES_PACKAGE_MANAGER_APPLICATION_NAME
+      value: qinglong3-plugin-package-manager
+    - name: QL3_POSTGRES_PACKAGE_MANAGER_MAX_CONNECTIONS
+      value: '2'
+    - name: QL3_POSTGRES_PACKAGE_MANAGER_HOST
+      value: ql3-postgres-rw.qinglong3-system.svc
+    - name: QL3_POSTGRES_PACKAGE_MANAGER_PORT
+      value: '5432'
+    - name: QL3_POSTGRES_PACKAGE_MANAGER_DATABASE
+      value: qinglong
+    - name: QL3_POSTGRES_PACKAGE_MANAGER_USER
+      valueFrom:
+        secretKeyRef:
+          name: ql3-postgres-package-manager-auth
+          key: username
+    - name: QL3_POSTGRES_PACKAGE_MANAGER_PASSWORD
+      valueFrom:
+        secretKeyRef:
+          name: ql3-postgres-package-manager-auth
+          key: password
+    - name: QL3_POSTGRES_PACKAGE_MANAGER_TLS_SERVERNAME
+      value: ql3-postgres-rw.qinglong3-system.svc
+- op: replace
+  path: /spec/template/spec/volumes/4/secret/secretName
+  value: ql3-postgres-ca
+- op: replace
+  path: /spec/template/spec/volumes/4/secret/items/0/key
+  value: ca.crt

deploy/kubernetes/ql3-cluster/operations/plugin-package-management/cloudnative-pg/kustomization.yaml

@@ -0,0 +1,25 @@
+apiVersion: kustomize.config.k8s.io/v1beta1
+kind: Kustomization
+
+resources:
+  - ../base
+
+patches:
+  - target:
+      group: apps
+      version: v1
+      kind: Deployment
+      labelSelector: app.kubernetes.io/name=ql3-plugin-package-management
+    path: deployment-patch.yaml
+  - target:
+      group: networking.k8s.io
+      version: v1
+      kind: NetworkPolicy
+      name: ql3-plugin-package-management
+    path: network-policy-patch.yaml
+
+images:
+  - name: qinglong3-cluster-admin
+    newName: registry.example.com/qinglong/qinglong3-cluster-admin
+    # Fail closed until the independently verified release digest is supplied.
+    digest: sha256:0000000000000000000000000000000000000000000000000000000000000000

deploy/kubernetes/ql3-cluster/operations/plugin-package-management/cloudnative-pg/network-policy-patch.yaml

@@ -0,0 +1,26 @@
+apiVersion: networking.k8s.io/v1
+kind: NetworkPolicy
+metadata:
+  name: ql3-plugin-package-management
+  namespace: qinglong3-system
+spec:
+  egress:
+    - to:
+        - namespaceSelector:
+            matchLabels:
+              kubernetes.io/metadata.name: kube-system
+          podSelector:
+            matchLabels:
+              k8s-app: kube-dns
+      ports:
+        - protocol: UDP
+          port: 53
+        - protocol: TCP
+          port: 53
+    - to:
+        - podSelector:
+            matchLabels:
+              cnpg.io/cluster: ql3-postgres
+      ports:
+        - protocol: TCP
+          port: 5432

deploy/kubernetes/ql3-cluster/operations/plugin-package-management/config.example.yaml

@@ -0,0 +1,84 @@
+# Example only. Copy into a private overlay and replace every placeholder.
+# This file is intentionally excluded from all committed Kustomizations.
+apiVersion: v1
+kind: Secret
+metadata:
+  name: ql3-plugin-package-management-identity
+  namespace: qinglong3-system
+type: Opaque
+stringData:
+  keyset.json: |
+    {
+      "schemaVersion": 1,
+      "generation": 1,
+      "issuer": "https://identity.example.test/",
+      "audience": "qinglong3-package-management",
+      "keys": [
+        {
+          "alg": "EdDSA",
+          "crv": "Ed25519",
+          "kid": "REPLACE_WITH_KEY_ID",
+          "kty": "OKP",
+          "use": "sig",
+          "x": "REPLACE_WITH_ED25519_PUBLIC_JWK_X"
+        }
+      ],
+      "revokedKids": [],
+      "assuranceMappings": [
+        {
+          "acr": "urn:example:mfa",
+          "assurance": "multi_factor",
+          "requiredAmr": ["pwd", "otp"]
+        }
+      ],
+      "constraints": {
+        "maxAssertionBytes": 8192,
+        "maxLifetimeMs": 300000,
+        "maxAuthenticationAgeMs": 300000,
+        "clockSkewMs": 5000
+      }
+    }
+---
+apiVersion: v1
+kind: Secret
+metadata:
+  name: ql3-plugin-package-management-tls
+  namespace: qinglong3-system
+type: kubernetes.io/tls
+stringData:
+  tls.crt: REPLACE_WITH_SERVER_CERTIFICATE_CHAIN
+  tls.key: REPLACE_WITH_SERVER_PRIVATE_KEY
+---
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: ql3-plugin-publisher-trust
+  namespace: qinglong3-system
+data:
+  publishers.json: |
+    {
+      "schema": "qinglong/plugin-package-publisher-trust@v1",
+      "keys": [
+        {
+          "publisher": "REPLACE_WITH_PUBLISHER",
+          "keyId": "REPLACE_WITH_KEY_ID",
+          "publicKeyPem": "REPLACE_WITH_ED25519_PUBLIC_KEY_PEM",
+          "notBeforeMs": 0,
+          "notAfterMs": 1
+        }
+      ]
+    }
+---
+# Non-CloudNativePG deployments only. The reviewed CloudNativePG overlay uses
+# the operator-managed ql3-postgres-package-manager-auth and ql3-postgres-ca
+# Secrets instead of this resource.
+apiVersion: v1
+kind: Secret
+metadata:
+  name: ql3-cluster-plugin-package-management-database
+  namespace: qinglong3-system
+type: Opaque
+stringData:
+  postgres-package-manager-url: REPLACE_WITH_PACKAGE_MANAGER_DSN
+  postgres-tls-servername: REPLACE_WITH_POSTGRES_DNS_NAME
+  postgres-ca.crt: REPLACE_WITH_POSTGRES_CA_CERTIFICATE