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
. 请参阅本指南,了解如何创建和应用绑定配置。
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
以上示例将 Secret 明文存储。 更推荐的方式是使用 Secret 组件, 这里。
元数据字段规范
字段 | 必填 | 绑定支持 | 详情 | 示例 |
---|---|---|---|---|
bucket | Y | Output | The bucket name | “mybucket” |
type | Y | Output | Tge GCP credentials type | “service_account” |
project_id | Y | Output | GCP 项目 id | project_id |
private_key_id | Y | Output | GCP 私钥 id | “privateKeyId” |
private_key | Y | Output | GCP凭证私钥 替换为x509证书 | 12345-12345 |
client_email | Y | Output | GCP 客户端邮箱地址 | “client@email.com” |
client_id | Y | Output | GCP 客户端 id | 0123456789-0123456789 |
auth_uri | Y | Output | Google帐户 OAuth 端点 | https://accounts.google.com/o/oauth2/auth |
token_uri | Y | Output | Google帐户token地址 | https://oauth2.googleapis.com/token |
auth_provider_x509_cert_url | Y | Output | GCP凭证证书地址 | https://www.googleapis.com/oauth2/v1/certs |
client_x509_cert_url | Y | Output | GCP凭证项目x509证书地址 | https://www.googleapis.com/robot/v1/metadata/x509/<PROJECT_NAME>.iam.gserviceaccount.com |
绑定支持
该组件支持输出绑定,其操作如下:
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上,使用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>
Save text to a specific file
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.
然后你就可以像平常一样上传了:
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>