Skip to content

Commit 4190dbc

Browse files
authored
📖 Add service account doc to gcs connector readme (#9347)
* Update gcs readme about service accounts * Update doc
1 parent 3281424 commit 4190dbc

File tree

1 file changed

+29
-0
lines changed
  • airbyte-integrations/connectors/destination-gcs

1 file changed

+29
-0
lines changed

airbyte-integrations/connectors/destination-gcs/README.md

+29
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,35 @@ As a community contributor, you can follow these steps to run integration tests.
1717
- Access the `destination gcs creds` secrets on Last Pass, and put it in `sample_secrets/config.json`.
1818
- Rename the directory from `sample_secrets` to `secrets`.
1919

20+
### GCP Service Account for Testing
21+
Two service accounts have been created in our GCP for testing this destination. Both of them have access to Cloud Storage through HMAC keys. The keys are persisted together with the connector integration test credentials in LastPass.
22+
23+
- Account: `gcs-destination-connector-test@dataline-integration-testing.iam.gserviceaccount.com`
24+
- This account has the required permission to pass the integration test. Note that the uploader needs `storage.multipartUploads` permissions, which may not be intuitive.
25+
- Role: `GCS Destination User`
26+
- Permissions:
27+
```
28+
storage.multipartUploads.abort
29+
storage.multipartUploads.create
30+
storage.objects.create
31+
storage.objects.delete
32+
storage.objects.get
33+
storage.objects.list
34+
```
35+
- LastPass entry: `destination gcs creds`
36+
37+
- Account: `gcs-destination-failure-test@dataline-integration-testing.iam.gserviceaccount.com`
38+
- This account does not have the `storage.multipartUploads` permissions, and will fail the integration test. The purpose of this account is to test that the `check` command can correctly detect the lack of these permissions and return an error message.
39+
- Role: `GCS Destination User Without Multipart Permission`
40+
- Permissions:
41+
```
42+
storage.objects.create
43+
storage.objects.delete
44+
storage.objects.get
45+
storage.objects.list
46+
```
47+
- LastPass entry: `destination gcs creds (no multipart permission)`
48+
2049
## Add New Output Format
2150
- Add a new enum in `S3Format`.
2251
- Modify `spec.json` to specify the configuration of this new format.

0 commit comments

Comments
 (0)