This page shows you how to create Google Distributed Cloud (GDC) air-gapped appliance storage buckets.
Before you begin
A project namespace manages bucket resources in the admin cluster. You must have a project to work with buckets and objects.
You must also have the appropriate bucket permissions to perform the following operation. See Grant bucket access.
Storage bucket naming guidelines
Bucket names must adhere to the following naming conventions:
- Be unique within the project. A project appends a unique prefix to the bucket
name, ensuring there aren't clashes within the organization. In the unlikely
event of a prefix and bucket name clash across organizations, the bucket
creation fails with a
bucket name in use
error. - Have at least one and no more than 57 characters.
- Refrain from including any personally identifiable information (PII).
- Be DNS-compliant.
- Start with a letter and contain only letters, numbers, and hyphens.
Create a bucket
To create a bucket, apply a bucket specification to your project namespace:
kubectl apply -f bucket.yaml
The following is an example of a bucket specification:
apiVersion: object.gdc.goog/v1alpha1
kind: Bucket
metadata:
name: BUCKET_NAME
namespace: NAMESPACE_NAME
spec:
description: DESCRIPTION
storageClass: standard-rwo
bucketPolicy :
lockingPolicy :
defaultObjectRetentionDays: RETENTION_DAY_COUNT
For more details, see the Bucket API reference.