{"id":35381620,"url":"https://github.com/tigrisdata/terraform-provider-tigris","last_synced_at":"2026-03-15T05:47:27.290Z","repository":{"id":253599947,"uuid":"843983679","full_name":"tigrisdata/terraform-provider-tigris","owner":"tigrisdata","description":null,"archived":false,"fork":false,"pushed_at":"2026-03-06T22:34:39.000Z","size":113,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":10,"default_branch":"main","last_synced_at":"2026-03-06T22:40:51.310Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tigrisdata.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-08-18T02:49:00.000Z","updated_at":"2024-08-31T01:20:38.000Z","dependencies_parsed_at":"2024-08-19T12:02:27.030Z","dependency_job_id":null,"html_url":"https://github.com/tigrisdata/terraform-provider-tigris","commit_stats":null,"previous_names":["tigrisdata/terraform-provider-tigris"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/tigrisdata/terraform-provider-tigris","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tigrisdata%2Fterraform-provider-tigris","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tigrisdata%2Fterraform-provider-tigris/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tigrisdata%2Fterraform-provider-tigris/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tigrisdata%2Fterraform-provider-tigris/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tigrisdata","download_url":"https://codeload.github.com/tigrisdata/terraform-provider-tigris/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tigrisdata%2Fterraform-provider-tigris/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30209430,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-07T05:23:27.321Z","status":"ssl_error","status_checked_at":"2026-03-07T05:00:17.256Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-02T05:10:33.943Z","updated_at":"2026-03-07T07:03:52.409Z","avatar_url":"https://github.com/tigrisdata.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Terraform Provider for Tigris Buckets\n\nThis repository contains a Terraform provider that allows you to create and manage Tigris buckets. This provider supports creating, reading, updating, deleting, and importing Tigris buckets with additional customization options like specifying access keys.\n\n## Usage\n\nBelow is an example of how to use the Tigris provider in your Terraform configuration:\n\n```hcl\nterraform {\n  required_providers {\n    tigris = {\n      source  = \"tigrisdata/tigris\"\n    }\n  }\n}\n\nprovider \"tigris\" {\n  access_key = \"your-access-key\"\n  secret_key = \"your-secret-key\"\n}\n\nresource \"tigris_bucket\" \"example_bucket\" {\n  bucket               = \"my-custom-bucket\"\n  default_storage_tier = \"STANDARD\"\n\n  location {\n    type    = \"single\"\n    regions = [\"sjc\"]\n  }\n}\n\nresource \"tigris_bucket_public_access\" \"example_bucket_public_access\" {\n  bucket              = tigris_bucket.example_bucket.bucket\n  acl                 = \"private\"\n  public_list_objects = false\n}\n\nresource \"tigris_bucket_website_config\" \"example_website_config\" {\n  bucket      = tigris_bucket.example_bucket.bucket\n  domain_name = tigris_bucket.example_bucket.bucket\n}\n\nresource \"tigris_bucket_shadow_config\" \"example_shadow_config\" {\n  bucket               = tigris_bucket.example_bucket.bucket\n  shadow_bucket        = \"my-custom-bucket-shadow\"\n  shadow_access_key    = \"your-shadow-bucket-access-key\"\n  shadow_secret_key    = \"your-shadow-bucket-secret-key\"\n  shadow_region        = \"us-west-2\"\n  shadow_endpoint      = \"https://s3.us-west-2.amazonaws.com\"\n  shadow_write_through = true\n}\n\n# Snapshots and Forks\nresource \"tigris_bucket\" \"snapshot_bucket\" {\n  bucket          = \"my-snapshot-bucket\"\n  enable_snapshot = true\n}\n\nresource \"tigris_bucket_snapshot\" \"example_snapshot\" {\n  source_bucket = tigris_bucket.snapshot_bucket.bucket\n  snapshot_name = \"my-snapshot\"\n}\n\nresource \"tigris_bucket_fork\" \"example_fork\" {\n  bucket                      = \"my-forked-bucket\"\n  fork_source_bucket          = tigris_bucket.snapshot_bucket.bucket\n  fork_source_bucket_snapshot = tigris_bucket_snapshot.example_snapshot.snapshot_version\n}\n```\n\n### Applying the Configuration\n\n1. Initialize Terraform:\n\n```shell\nterraform init\n```\n\n2. Apply the configuration:\n\n```shell\nterraform apply\n```\n\n## Provider\n\nThe Tigris provider allows you to manage Tigris buckets.\n\n### Configuration\n\nThe provider can be configured with the following parameters:\n\n- access_key: (Optional) The access key. Can also be sourced from the AWS_ACCESS_KEY_ID environment variable.\n- secret_key: (Optional) The secret key. Can also be sourced from the AWS_SECRET_ACCESS_KEY environment variable.\n\n## Resources\n\n### tigris_bucket\n\nThe tigris_bucket resource creates and manages a Tigris bucket. This resource supports the following actions:\n\n- Create: Creates a new Tigris bucket.\n- Read: Retrieves information about the existing Tigris bucket.\n- Update: Updates the bucket configuration.\n- Delete: Deletes the Tigris bucket.\n- Import: Imports an existing Tigris bucket into Terraform’s state.\n\n#### Configuration\n\n- bucket: (Required) The name of the Tigris bucket.\n- location: (Optional) The location configuration for the bucket. Controls data placement and replication.\n  - type: (Required) The location type: `global`, `multi`, `dual`, or `single`.\n  - regions: (Optional) The region codes. For `multi`: `usa` or `eur`. For `single`/`dual`: specific region codes like `sjc`, `iad`, `ams`, etc.\n- default_storage_tier: (Optional) The default storage tier for objects in the bucket. Possible values: `STANDARD`, `STANDARD_IA`, `GLACIER`, `GLACIER_IR`. Cannot be changed after creation.\n- enable_snapshot: (Optional) Enable snapshots for this bucket. Defaults to `false`. Cannot be changed after creation.\n\n```hcl\nresource \"tigris_bucket\" \"example_bucket\" {\n  bucket               = \"my-custom-bucket\"\n  default_storage_tier = \"STANDARD_IA\"\n  enable_snapshot      = true\n\n  location {\n    type    = \"single\"\n    regions = [\"sjc\"]\n  }\n}\n```\n\n### tigris_bucket_public_access\n\nThe tigris_bucket_public_access resource creates and manages a Tigris bucket public access configuration. This resource supports the following actions:\n\n- Create: Creates a new Tigris bucket public access configuration.\n- Read: Retrieves information about the existing Tigris bucket public access configuration.\n- Update: Updates the bucket public access configuration.\n- Delete: Deletes the Tigris bucket public access configuration.\n- Import: Imports an existing Tigris bucket public access configuration into Terraform’s state.\n\n#### Configuration\n\n- bucket: (Required) The name of the Tigris bucket.\n- acl: (Optional) The access control list for the bucket. Defaults to \"private\". Possible values are \"private\", and \"public-read\".\n\n```hcl\nresource \"tigris_bucket_public_access\" \"example_bucket_public_access\" {\n  bucket              = \"my-custom-bucket\"\n  acl                 = \"private\"\n  public_list_objects = false\n}\n```\n\n### tigris_bucket_website_config\n\nThe tigris_bucket_website_config resource creates and manages a Tigris bucket website configuration. This is used to configure custom domain name for the bucket.\n\nThis resource supports the following actions:\n\n- Create: Creates a new Tigris bucket website configuration.\n- Read: Retrieves information about the existing Tigris bucket website configuration.\n- Update: Updates the bucket website configuration.\n- Delete: Deletes the Tigris bucket website configuration.\n- Import: Imports an existing Tigris bucket website configuration into Terraform’s state.\n\n#### Configuration\n\n- bucket: (Required) The name of the Tigris bucket.\n- domain_name: (Required) The domain name for the bucket website.\n\n```hcl\nresource \"tigris_bucket_website_config\" \"example_website_config\" {\n  bucket      = images.example.com\n  domain_name = images.example.com\n}\n```\n\nBefore using this resource, you must have a bucket created using the tigris_bucket resource. The domain_name must match the bucket name and there must be a CNAME DNS record setup. The CNAME record should point to the Tigris bucket endpoint (e.g., images.example.com CNAME images.example.com.fly.storage.tigris.dev).\n\n### tigris_bucket_shadow_config\n\nThe tigris_bucket_shadow_config resource creates and manages a Tigris bucket shadow configuration. The shadow configuration is used to setup a source bucket (shadow bucket) that will be used to migrate data to the Tigris bucket. You can read more about how this migration works [here](https://www.tigrisdata.com/docs/migration/).\n\nThis resource supports the following actions:\n\n- Create: Creates a new Tigris bucket shadow configuration.\n- Read: Retrieves information about the existing Tigris bucket shadow configuration.\n- Update: Updates the bucket shadow configuration.\n- Delete: Deletes the Tigris bucket shadow configuration.\n- Import: Imports an existing Tigris bucket shadow configuration into Terraform’s state.\n\n#### Configuration\n\n- bucket: (Required) The name of the Tigris bucket.\n- shadow_bucket: (Required) The name of the shadow bucket.\n- shadow_access_key: (Required) The access key for the shadow bucket.\n- shadow_secret_key: (Required) The secret key for the shadow bucket.\n- shadow_region: (Optional) The region for the shadow bucket. Defaults to \"us-east-1\".\n- shadow_endpoint: (Optional) The endpoint for the shadow bucket. Defaults to \"https://s3.us-east-1.amazonaws.com\".\n- shadow_write_through: (Optional) Whether to write through to the shadow bucket. Defaults to true.\n\n```hcl\nresource \"tigris_bucket_shadow_config\" \"example_shadow_config\" {\n  bucket                = \"my-custom-bucket\"\n  shadow_bucket         = \"my-custom-bucket-shadow\"\n  shadow_access_key     = \"your-shadow-bucket-access-key\"\n  shadow_secret_key     = \"your-shadow-bucket-secret-key\"\n  shadow_region         = \"us-west-2\"\n  shadown_endpoint      = \"https://s3.us-west-2.amazonaws.com\"\n  shadow_write_through  = true\n}\n```\n\n### tigris_bucket_snapshot\n\nThe tigris_bucket_snapshot resource creates a point-in-time snapshot of a Tigris bucket. The source bucket must have snapshots enabled (`enable_snapshot = true`).\n\n\u003e **Note:** Snapshots cannot be deleted via the API. Destroying this resource will only remove it from Terraform state.\n\nThis resource supports the following actions:\n\n- Create: Creates a new snapshot of the source bucket.\n- Read: Retrieves information about the snapshot.\n- Delete: Removes the snapshot from Terraform state (no API deletion).\n- Import: Imports an existing snapshot using the format `{source_bucket}:{snapshot_version}:{snapshot_name}`.\n\n#### Configuration\n\n- source_bucket: (Required) The name of the source bucket to snapshot.\n- snapshot_name: (Required) The name for the snapshot.\n- snapshot_version: (Computed) The version identifier of the snapshot, returned by the API.\n- snapshot_created_at: (Computed) The timestamp when the snapshot was created.\n\n```hcl\nresource \"tigris_bucket_snapshot\" \"example\" {\n  source_bucket = tigris_bucket.snapshot_bucket.bucket\n  snapshot_name = \"my-snapshot\"\n}\n```\n\n### tigris_bucket_fork\n\nThe tigris_bucket_fork resource creates a new bucket as a fork of an existing bucket, optionally from a specific snapshot. A forked bucket is a regular bucket that starts with the data from the source.\n\nThis resource supports the following actions:\n\n- Create: Creates a new bucket forked from the source bucket.\n- Read: Retrieves information about the forked bucket and its fork metadata.\n- Delete: Deletes the forked bucket.\n- Import: Imports an existing forked bucket into Terraform's state.\n\n#### Configuration\n\n- bucket: (Required) The name of the new forked bucket.\n- fork_source_bucket: (Required) The name of the source bucket to fork from.\n- fork_source_bucket_snapshot: (Optional) The snapshot version to fork from. If not specified, forks from the current state.\n- fork_created_at: (Computed) The timestamp when the fork was created.\n\n```hcl\nresource \"tigris_bucket_fork\" \"example\" {\n  bucket                      = \"my-forked-bucket\"\n  fork_source_bucket          = \"my-source-bucket\"\n  fork_source_bucket_snapshot = tigris_bucket_snapshot.example.snapshot_version\n}\n```\n\n## Developing\n\n### Local Development\n\n1. Build and install the provider:\n\n```shell\nmake build    # builds the binary\nmake install  # installs to $GOPATH/bin\n```\n\n2. Create a `~/.terraformrc` file to tell Terraform to use your local build:\n\n```hcl\nprovider_installation {\n  dev_overrides {\n    \"tigrisdata/tigris\" = \"\u003coutput of go env GOPATH\u003e/bin\"\n  }\n  direct {}\n}\n```\n\n3. Set your Tigris credentials:\n\n```shell\nexport AWS_ACCESS_KEY_ID=\"your-access-key\"\nexport AWS_SECRET_ACCESS_KEY=\"your-secret-key\"\n```\n\n4. Run Terraform against the example configurations in `examples/resources/`. With `dev_overrides` configured, skip `terraform init` and run directly:\n\n```shell\ncd examples/resources/tigris_bucket\nterraform plan\nterraform apply\n```\n\n### Useful Make Targets\n\n- `make vet` - Run static analysis\n- `make fmtcheck` - Check code formatting\n- `make fmt` - Auto-format code\n- `make lint` - Run full linting (requires `make tools` first)\n- `make docs` - Regenerate documentation\n\n### Documentation\n\nThe documentation for this provider is generated using terraform-plugin-docs. To generate the documentation, run the following command:\n\n```shell\nmake docs\n```\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftigrisdata%2Fterraform-provider-tigris","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftigrisdata%2Fterraform-provider-tigris","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftigrisdata%2Fterraform-provider-tigris/lists"}