カスタムデータベース

デフォルトでは、SambaNova はクラスター内に PostgreSQL インスタンスをプロビジョニングします。クラスター内のデプロイメントの代わりに外部の PostgreSQL データベースを使用するには、以下の手順を実行します。

SambaStack オンプレミス / エアギャップ
SambaStack Hosted

ステップ 1: Secret の作成

オプション A: base64 エンコードされた値を使用

まず、データベースの認証情報をエンコードします。

echo -n "<db-host>" | base64
echo -n "<db-name>" | base64
echo -n "<db-user>" | base64
echo -n "<db-password>" | base64

base64 エンコードされた値を使用して、Kubernetes シークレットを作成します。

apiVersion: v1
kind: Secret
metadata:
  name: pg-credentials
  namespace: sambastack
type: Opaque
data:
  DB_HOST: <Base64 encoded DB_HOST>
  DB_DATABASE: <Base64 encoded DB_DATABASE>
  DB_USER: <Base64 encoded DB_USER>
  DB_PASSWD: <Base64 encoded DB_PASSWD>

シークレットを適用します。

kubectl apply -f pg-credentials.yaml

オプション B: kubectl でリテラル値を使用

手動でエンコードする代わりに、リテラル値を使用してシークレットを作成することもできます。

kubectl create secret generic pg-credentials \
  --from-literal=DB_HOST=<host> \
  --from-literal=DB_DATABASE=<database> \
  --from-literal=DB_USER=<user> \
  --from-literal=DB_PASSWD=<password> \
  --namespace sambastack

ステップ 2: sambastack.yaml の更新

外部データベースを使用するように sambastack.yaml を設定します。

auth-and-billing:
  pgSecretName: pg-credentials

cloudnative-pg:
  enabled: false

auth-and-billing.pgSecretName: データベースの認証情報を含む Kubernetes シークレットを参照します
cloudnative-pg.enabled: false: クラスター内の PostgreSQL デプロイメントを無効化します

完全な例については、SambaStack.yaml リファレンスをご覧ください。

ステップ 3: 設定の適用

Helm デプロイメントを更新します。

オンプレミス

helm upgrade sambastack \
  -f sambastack.yaml \
  --namespace sambastack \
  oci://<REGISTRY_URL>/sambastack/sambastack

エアギャップ

OCI レジストリパスの代わりに、ローカルにある Helm チャートのコピーを使用します。

helm upgrade sambastack \
  -f sambastack.yaml \
  --namespace sambastack \
  sambastack-<VERSION>.tgz

sambastack-<VERSION>.tgz は、アップグレードに使用する Helm チャートのローカルコピーです。さらにサポートが必要な場合は、SambaNova のサポート窓口までお問い合わせください。

SambaNova は、引き渡し時に完全なレジストリ URL とバージョン番号を提供します。アクセス用の認証情報については、SambaNova の担当者にお問い合わせください。

外部の PostgreSQL データベースに Kubernetes クラスターからアクセスできること、およびネットワークポリシーがその接続を許可していることを確認してください。

1. 外部データベースのプロビジョニング

外部の PostgreSQL インスタンスを構築し、以下の認証情報を取得します。

DB_HOST
DB_DATABASE
DB_USER
DB_PASSWD

2. PostgreSQL 認証情報用の Kubernetes Secret の作成

データベースの認証情報を使用して、pg-credentials という名前のシークレットを作成します。

cat <<EOPGSECRET | kubectl apply -f -
apiVersion: v1
kind: Secret
metadata:
  name: pg-credentials
  namespace: default
type: Opaque
data:
  DB_HOST: <Base64 encoded DB_HOST>
  DB_DATABASE: <Base64 encoded DB_DATABASE>
  DB_USER: <Base64 encoded DB_USER>
  DB_PASSWD: <Base64 encoded DB_PASSWD>
EOPGSECRET

すべての認証情報の値が base64 エンコードされていることを確認してください。

3. sambastack.yaml の更新

sambastack.yaml (data → sambastack.yaml) を編集し、外部 PostgreSQL のシークレットを参照するように設定し、クラスター内データベースを無効化します。

data:
  sambastack.yaml: |
    # Auth and Billing Configuration
    auth-and-billing:
      pgSecretName: pg-credentials # Kubernetes secret with PostgreSQL credentials
    # Database Configuration
    cloudnative-pg:
      enabled: false # Disable in-cluster PostgreSQL

完全な例については、SambaStack.yaml リファレンスをご覧ください。

4. 更新した設定の適用

変更を適用します。

kubectl apply -f sambastack.yaml

これらの手順を完了すると、デプロイメントは設定した外部 PostgreSQL データベースに接続するようになります。

はじめに

サービス管理

ハードウェア管理

リファレンスアーキテクチャ

リソース

ステップ 1: Secret の作成

オプション A: base64 エンコードされた値を使用

オプション B: kubectl でリテラル値を使用

ステップ 2: sambastack.yaml の更新

ステップ 3: 設定の適用

オンプレミス

エアギャップ

1. 外部データベースのプロビジョニング

2. PostgreSQL 認証情報用の Kubernetes Secret の作成

3. sambastack.yaml の更新

4. 更新した設定の適用

​ステップ 1: Secret の作成

​オプション A: base64 エンコードされた値を使用

​オプション B: kubectl でリテラル値を使用

​ステップ 2: sambastack.yaml の更新

​ステップ 3: 設定の適用

​オンプレミス

​エアギャップ

​1. 外部データベースのプロビジョニング

​2. PostgreSQL 認証情報用の Kubernetes Secret の作成

​3. sambastack.yaml の更新

​4. 更新した設定の適用

ステップ 1: Secret の作成

オプション A: base64 エンコードされた値を使用

オプション B: kubectl でリテラル値を使用

ステップ 2: sambastack.yaml の更新

ステップ 3: 設定の適用

オンプレミス

エアギャップ

1. 外部データベースのプロビジョニング

2. PostgreSQL 認証情報用の Kubernetes Secret の作成

3. sambastack.yaml の更新

4. 更新した設定の適用