Skip to content

Commit 14370aa

Browse files
authored
Merge pull request #220 from rust-lang/docs-assets-backup-extract-implementation-details
docs(assets-backup): extract implementation details
2 parents c85a013 + 62849e6 commit 14370aa

File tree

2 files changed

+18
-18
lines changed

2 files changed

+18
-18
lines changed

service-catalog/rust-assets-backup/README.md

Lines changed: 1 addition & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -70,26 +70,9 @@ This improves our security posture because compromising two accounts is harder t
7070

7171
The accidental account deletion is not a threat anymore because if either AWS or GCP delete our account, we can restore the data from the other provider.
7272

73-
## Implementation details
74-
75-
The account where we store the backup is called `rust-backup`. It contains two GCP projects: `backup-prod` and `backup-staging`.
76-
Here we have one Google [Object Storage](https://cloud.google.com/storage?hl=en) in the `europe-west1` (Belgium) region for the following AWS S3 buckets:
77-
78-
- `crates-io`. CloudFront URL: `cloudfront-static.crates.io`. It contains the crates published by the Rust community.
79-
- `static-rust-lang-org`. CloudFront Url: `cloudfront-static.rust-lang.org`. Among other things, it contains the Rust releases.
80-
81-
For the objects:
82-
83-
- The [storage class](https://cloud.google.com/storage/docs/storage-classes) is set to "archive" for all buckets.
84-
This is the cheapest class for infrequent access.
85-
- [object-versioning](https://cloud.google.com/storage/docs/object-versioning) and [soft-delete](https://cloud.google.com/storage/docs/soft-delete) are enabled,
86-
so that we can recover updates and deletes.
87-
88-
We use [Storage Transfer](https://cloud.google.com/storage-transfer/docs/overview) to automatically transfer the content of the s3 bucket into the Google Object Storage.
89-
This is a service managed by Google. We'll use it to download the S3 buckets from CloudFront to perform a daily incremental transfer. The transfers only move files that are new, updated, or deleted since the last transfer, minimizing the amount of data that needs to be transferred.
90-
9173
## Explanations
9274

75+
- [Implementation details](./implementation.md)
9376
- [FAQ](./faq.md)
9477

9578
## How-to Guides
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
# Implementation details
2+
3+
The account where we store the backup is called `rust-backup`. It contains two GCP projects: `backup-prod` and `backup-staging`.
4+
Here we have one Google [Object Storage](https://cloud.google.com/storage?hl=en) in the `europe-west1` (Belgium) region for the following AWS S3 buckets:
5+
6+
- `crates-io`. CloudFront URL: `cloudfront-static.crates.io`. It contains the crates published by the Rust community.
7+
- `static-rust-lang-org`. CloudFront Url: `cloudfront-static.rust-lang.org`. Among other things, it contains the Rust releases.
8+
9+
For the objects:
10+
11+
- The [storage class](https://cloud.google.com/storage/docs/storage-classes) is set to "archive" for all buckets.
12+
This is the cheapest class for infrequent access.
13+
- [object-versioning](https://cloud.google.com/storage/docs/object-versioning) and [soft-delete](https://cloud.google.com/storage/docs/soft-delete) are enabled,
14+
so that we can recover updates and deletes.
15+
16+
We use [Storage Transfer](https://cloud.google.com/storage-transfer/docs/overview) to automatically transfer the content of the s3 bucket into the Google Object Storage.
17+
This is a service managed by Google. We'll use it to download the S3 buckets from CloudFront to perform a daily incremental transfer. The transfers only move files that are new, updated, or deleted since the last transfer, minimizing the amount of data that needs to be transferred.

0 commit comments

Comments
 (0)