secrets-store-csi-driver-provider-sakuracloud

module
v0.2.3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 12, 2026 License: MIT

README

secrets-store-csi-driver-provider-sakuracloud

This is a provider for the Kubernetes Secrets Store CSI Driver, allowing you to fetch secrets from Sakura Cloud Secret Manager and mount them into your pods.

Features

  • Fetches secrets from Sakura Cloud Secret Manager.
  • Mounts secrets as files into pods.

Requirements

Installation

  1. Install the Provider

    Apply the pre-built manifest from the GitHub releases:

    kubectl apply -f https://github.com/tosuke/secrets-store-csi-driver-provider-sakuracloud/releases/download/v0.2.3/deploy.yaml
    
  2. Create Sakura Cloud Credentials Secret

    The provider needs your Sakura Cloud API credentials to fetch secrets. Create a Kubernetes secret named sakuracloud-credentials in the kube-system namespace.

    kubectl create secret generic sakuracloud-credentials \
      --from-literal=access-token="YOUR_SAKURACLOUD_ACCESS_TOKEN" \
      --from-literal=access-token-secret="YOUR_SAKURACLOUD_ACCESS_TOKEN_SECRET" \
      -n kube-system
    

Usage

  1. Create a SecretProviderClass

    Create a SecretProviderClass resource to define which secrets to fetch.

    apiVersion: secrets-store.csi.x-k8s.io/v1
    kind: SecretProviderClass
    metadata:
      name: my-sakuracloud-secrets
    spec:
      provider: sakuracloud
      parameters:
        vaultID: "your-vault-id" # Specify your Vault ID
        secrets: |
          - name: "my-secret-1"
          - name: "my-secret-2"
    
  2. Mount Secrets in a Pod

    Reference the SecretProviderClass in your pod's volume mounts.

    apiVersion: v1
    kind: Pod
    metadata:
      name: my-pod
    spec:
      containers:
        - name: my-container
          image: nginx
          volumeMounts:
            - name: secrets-store-inline
              mountPath: "/mnt/secrets-store"
              readOnly: true
      volumes:
        - name: secrets-store-inline
          csi:
            driver: secrets-store.csi.k8s.io
            readOnly: true
            volumeAttributes:
              secretProviderClass: "my-sakuracloud-secrets"
    

    The secrets will be mounted as files in the /mnt/secrets-store directory inside the container. Each secret will be available as a separate file using either its name or the specified path from the secret configuration.

Parameters Reference

The SecretProviderClass supports the following parameters:

Root Parameters
Parameter Type Required Description
vaultID string No* Default Vault ID to use for all secrets. Can be overridden per secret. Required if not specified per secret.
secrets YAML string Yes YAML-formatted list of secrets to fetch from Sakura Cloud Secret Manager.
Secrets Configuration

The secrets parameter accepts a YAML string containing a list of secret configurations. Each secret supports the following fields:

Field Type Required Description
name string Yes Name of the secret in Sakura Cloud Secret Manager.
vaultID string No Vault ID for this specific secret. If not specified, uses the root vaultID parameter.
version integer No Specific version of the secret to fetch. If not specified, fetches the latest version.
path string No Relative path where the secret should be mounted. If not specified, uses the secret name.
Path Validation Rules

The path parameter has the following constraints:

  • Must be a relative path (cannot start with /)
  • Cannot contain path traversal sequences (../)
  • Can be empty (use name if path is not specified)

Examples

Basic Usage
apiVersion: secrets-store.csi.x-k8s.io/v1
kind: SecretProviderClass
metadata:
  name: basic-secrets
spec:
  provider: sakuracloud
  parameters:
    vaultID: "123456"
    secrets: |
      - name: "database-password"
      - name: "api-key"
Per-Secret Vault ID
apiVersion: secrets-store.csi.x-k8s.io/v1
kind: SecretProviderClass
metadata:
  name: multi-vault-secrets
spec:
  provider: sakuracloud
  parameters:
    vaultID: "123456"  # Default vault
    secrets: |
      - name: "common-secret"           # Uses default vault 123456
      - name: "special-secret"
        vaultID: "789012"               # Uses different vault
Version-Specific Secrets
apiVersion: secrets-store.csi.x-k8s.io/v1
kind: SecretProviderClass
metadata:
  name: versioned-secrets
spec:
  provider: sakuracloud
  parameters:
    vaultID: "123456"
    secrets: |
      - name: "config-file"
        version: 2                      # Fetch version 2 specifically
      - name: "current-token"           # Uses latest version
Custom Mount Paths
apiVersion: secrets-store.csi.x-k8s.io/v1
kind: SecretProviderClass
metadata:
  name: custom-path-secrets
spec:
  provider: sakuracloud
  parameters:
    vaultID: "123456"
    secrets: |
      - name: "db-config"
        path: "config/database.json"    # Mounted as config/database.json
      - name: "ssl-cert"
        path: "certs/server.crt"        # Mounted as certs/server.crt
      - name: "simple-secret"           # Mounted as simple-secret (uses name)
Advanced Configuration
apiVersion: secrets-store.csi.x-k8s.io/v1
kind: SecretProviderClass
metadata:
  name: advanced-secrets
spec:
  provider: sakuracloud
  parameters:
    vaultID: "123456"
    secrets: |
      - name: "prod-database-url"
        version: 3
        path: "config/db.url"
      - name: "staging-api-key"
        vaultID: "789012"
        version: 1
        path: "keys/staging.key"
      - name: "shared-certificate"
        path: "ssl/shared.crt"

Development

Prerequisites
Running Tests

End-to-end tests use sakumock inside a kind cluster. The tests create their own vault and secrets and use dummy credentials; no Sakura Cloud account or real API credentials are needed. Docker must be running, and curl, jq, and envsubst must be available in addition to the Aqua tools.

aqua install
kind create cluster --config e2e/kind.yaml --wait 300s
make e2e-test
kind delete cluster

License

This project is licensed under the MIT License - see the LICENSE file for details.

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL