ほかのクラスターに構築する
GKE 以外のクラスターに、汎用のオーバーレイ deploy/kubernetes/overlays/generic から Agent Fleet を建てます。
このオーバーレイは、プロバイダー固有のものを何も足さない base そのものです。GKE なら Terraform が用意するものは、すべて自分で用意します。
| あなたがやること | 起きること |
|---|---|
| 前提条件 P1〜P14 を自分で満たし、範囲が P15 を満たすことを確かめる | クラスターがワークスペースを隔離できる状態になる。これらを代わりに確かめる仕組みはない |
overlays/generic をコピーして書き換えて適用し、AF_DATABASE_URL を入れた Secret を作る |
Namespace、CP、RBAC、NetworkPolicy ができ、CP が起動する |
自分の ingress を Service af-cp の前に置く |
Console に外から届く |
最初の適用の前に CP の Namespace の受信ポリシーを足し、af-cp-data のバックアップを用意する |
CP の最初の起動から、GKE の構成と同じ保護が効く |
前提条件の一覧は Kubernetes 構成の全体像 にあります。
シェル変数を設定し、オーバーレイをコピーします。このクローンの外に置くなら、クローンの外に置く のとおりにパスを直します。
OVERLAY=<your overlay> # overlays/generic のコピーを置く場所CP_NS=<cpNamespace> # deployment.yaml の cpNamespaceWS_NS=<wsNamespace> # deployment.yaml の wsNamespacecp -r deploy/kubernetes/overlays/generic "$OVERLAY"- コピーの
deployment.yamlをクラスターに合わせます- Namespace
cpNamespaceとwsNamespace(この配備だけの接頭辞つき) - P3 を満たす StorageClass
workspaceImageと、kustomization.yamlのimages:の CP のタグ- Pod・Service・ノード・コントロールプレーンのアドレス範囲が P15 を満たすことも確かめます
- Namespace
cp.envを書き換えます。PUBLIC_BASE_URL、PUBLIC_DOMAIN、サインインの設定、SUPER_ADMIN_EMAILSと、必要なら次です
| 必要なとき | 設定 |
|---|---|
| ワークスペースを特定のノードで動かす | cp.env の AF_K8S_NODE_SELECTOR |
| イメージにプルシークレットが要る | cp.env の AF_K8S_IMAGE_PULL_SECRET。シークレット自体は手順 5 で作る |
- 何かが起動する前に、CP への受信を絞ります。 base には CP の Namespace の受信ポリシーがないため、ポート 8099 に届く通信は、どのユーザーにでもなりすませます。
components/gke/cp-networkpolicy.yamlをオーバーレイにコピーして書き換えます- 8099 の規則の Google の
ipBlock2 つを、自分の ingress の送信元(コントローラーの Pod の Namespace とラベル、またはアドレス)に置き換えます - 8098 の規則の
af-placeholder-wsを、自分のwsNamespaceにします(このラベルはオーバーレイが書き換えません。ポリシー自体の Namespace は書き換えます)
ターミナルウィンドウ cp deploy/kubernetes/components/gke/cp-networkpolicy.yaml "$OVERLAY/cp-networkpolicy.yaml"# 上のとおりに書き換え、kustomization.yaml の resources: に `- cp-networkpolicy.yaml` を足してから:kubectl kustomize "$OVERLAY" | grep -A3 'name: cp-ingress' # namespace: が自分の cpNamespace になる - 8099 の規則の Google の
- オーバーレイを適用します。2 つの Namespace、CP、RBAC と、CP の受信ポリシーを含む NetworkPolicy ができます。CP の Pod は手順 5 まで
CreateContainerConfigErrorのまま待ちますターミナルウィンドウ kubectl config current-context # 使うつもりのクラスターkubectl apply -k "$OVERLAY" - CP の Namespace に CP の Secret を作ります。キーに加えてストアの DSN を
AF_DATABASE_URLとして入れ、ロールアウトを待ちます。使うサインインのシークレット(GOOGLE_OAUTH_CLIENT_SECRET、AF_OIDC_<ID>_CLIENT_SECRET、GITHUB_OAUTH_CLIENT_SECRET)も同じ Secret に入れます。キーの要件は 配備のキーを扱う にあります。イメージにプルシークレットが要るなら、ここで$WS_NSに、AF_K8S_IMAGE_PULL_SECRETに書いた名前で作りますターミナルウィンドウ kubectl -n "$CP_NS" create secret generic af-cp-secrets \--from-literal=AF_MASTER_KEY="$(cat master-key)" \--from-literal=AF_COOKIE_SECRET="$(openssl rand -hex 32)" \--from-literal=AF_DATABASE_URL="$(cat database-url)" \--from-literal=GOOGLE_OAUTH_CLIENT_SECRET="$(cat google-client-secret)"kubectl -n "$CP_NS" rollout status deployment/af-cp - クラスターの ingress を Service
af-cp(ポート 8099)の前に置きます。ingress は、手順 3 のポリシーが許可する送信元にします- WebSocket を通し、アイドルタイムアウトを長くします
AF_TRUSTED_PROXY_HOPSを、X-Forwarded-Forに追記するプロキシの数にします。数えるのは、そのプロキシを通らないと CP に届かないものだけです(理由は GKE に構築する)。変えたらオーバーレイを適用し直します
- claim
af-cp-dataのバックアップを用意します。GKE での例は バックアップ・復元する にあります - P1〜P14 を自分で満たします。これらを代わりに確かめる仕組みはありません
マニフェストを変えるときに守ることは Kubernetes 構成の全体像 にあります。
- GKE に構築する:その手順 8 の確認方法は、ここでも使えます
- ノードを入れ替える・止まったノードに対処する
エージェント向け
この指示をエージェントに送ると、このページを読ませられます。
https://agent-fleet.org/docs/ja/operate/kubernetes/other-clusters/index.md を読んで