GCP Storage Bucket binding spec

Detailed documentation on the GCP Storage Bucket binding component

配置

To setup GCP Storage Bucket binding create a component of type bindings.gcp.bucket. See this guide on how to create and apply a binding configuration.

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: <NAME>
  namespace: <NAMESPACE>
spec:
  type: bindings.gcp.bucket
  version: v1
  metadata:
  - name: bucket
    value: mybucket
  - name: type
    value: service_account
  - name: project_id
    value: project_111
  - name: private_key_id
    value: *************
  - name: client_email
    value: name@domain.com
  - name: client_id
    value: '1111111111111111'
  - name: auth_uri
    value: https://accounts.google.com/o/oauth2/auth
  - name: token_uri
    value: https://oauth2.googleapis.com/token
  - name: auth_provider_x509_cert_url
    value: https://www.googleapis.com/oauth2/v1/certs
  - name: client_x509_cert_url
    value: https://www.googleapis.com/robot/v1/metadata/x509/<project-name>.iam.gserviceaccount.com
  - name: private_key
    value: PRIVATE KEY

Warning

以上示例将密钥明文存储， It is recommended to use a secret store for the secrets as described here.

元数据字段规范

字段	必填	绑定支持	详情	Example
bucket	Y	输出	The bucket name	`“mybucket”`
type	Y	输出	Tge GCP credentials type	`“service_account”`
project_id	Y	输出	GCP 项目 id	`project_id`
private_key_id	Y	输出	GCP 私钥 id	`“privateKeyId”`
private_key	Y	输出	GCP凭证私钥替换为x509证书	`12345-12345`
client_email	Y	输出	GCP 客户端邮箱地址	`“client@email.com”`
client_id	Y	输出	GCP 客户端 id	`0123456789-0123456789`
auth_uri	Y	输出	Google帐户 OAuth 端点	`https://accounts.google.com/o/oauth2/auth`
token_uri	Y	输出	Google帐户token地址	`https://oauth2.googleapis.com/token`
auth_provider_x509_cert_url	Y	输出	GCP凭证证书地址	`https://www.googleapis.com/oauth2/v1/certs`
client_x509_cert_url	Y	输出	GCP凭证项目x509证书地址	`https://www.googleapis.com/robot/v1/metadata/x509/<PROJECT_NAME>.iam.gserviceaccount.com`

绑定支持

字段名为 ttlInSeconds。

create

Create file

To perform a create operation, invoke the GCP Storage Bucket binding with a POST method and the following JSON body:

注意：默认情况下，会随机生成一个UUID。参见下面所示的支持的元数据设置名称

{
  "operation": "create",
  "data": "YOUR_CONTENT"
}

示例

Save text to a random generated UUID file

Windows
Linux

在Windows上，使用cmd提示符（PowerShell有不同的转义机制）。

curl -d "{ \"operation\": \"create\", \"data\": \"Hello World\" }" http://localhost:<dapr-port>/v1.0/bindings/<binding-name>

curl -d '{ "operation": "create", "data": "Hello World" }' \
      http://localhost:<dapr-port>/v1.0/bindings/<binding-name>

curl -d "{ \"operation\": \"create\", \"data\": \"Hello World\", \"metadata\": { \"name\": \"my-test-file.txt\" } }" \
      http://localhost:<dapr-port>/v1.0/bindings/<binding-name>

curl -d '{ "operation": "create", "data": "Hello World", "metadata": { "name": "my-test-file.txt" } }' \
      http://localhost:<dapr-port>/v1.0/bindings/<binding-name>

Upload a file

To upload a file, pass the file contents as the data payload; you may want to encode this in e.g. Base64 for binary content.

然后你就可以像平常一样上传了：

Windows
Linux

curl -d "{ \"operation\": \"create\", \"data\": \"(YOUR_FILE_CONTENTS)\", \"metadata\": { \"name\": \"my-test-file.jpg\" } }" http://localhost:<dapr-port>/v1.0/bindings/<binding-name>

curl -d '{ "operation": "create", "data": "$(cat my-test-file.jpg)", "metadata": { "name": "my-test-file.jpg" } }' \
      http://localhost:<dapr-port>/v1.0/bindings/<binding-name>

GCP Storage Bucket