diff --git a/docs/resource-collection.rst b/docs/resource-collection.rst index 0eab7bbf8..6d2c5efa9 100644 --- a/docs/resource-collection.rst +++ b/docs/resource-collection.rst @@ -50,7 +50,7 @@ S3 inventories We currently produce inventories for the core (s3://nextstrain-data) and staging (s3://nextstrain-staging) buckets which are generated daily and published to s3://nextstrain-inventories. The -s3://nextstrain-inventories bucket is a private bucket. The inventory +s3://nextstrain-inventories bucket is a private bucket with versioning enabled. The inventory configuration can be found in the AWS console for `core `__ and @@ -62,9 +62,10 @@ s3://nextstrain-inventories/nextstrain-data/config-v1 and s3://nextstrain-inventories/nextstrain-staging/config-v1, respectively. The cost of these is minimal (less than $1/bucket/year). -A lifecycle rule on the s3://nextstrain-inventories bucket (`console -link `__) -deletes all inventory-related files 30 days after they are created. +A lifecycle rule on the s3://nextstrain-inventories bucket (`console link +`__) +marks inventory-related files as deleted 30 days after they are created, and +permanently deletes them 7 days later. Index creation (Inventory access and index upload) -------------------------------------------------- @@ -93,6 +94,18 @@ s3://nextstrain-inventories/resources.json.gz. Note that if your aims are limited to local development purposes this is not necessary (see `Local development`_). +Index backups +------------- + +The ``nextstrain-inventories`` bucket is version enabled so past versions of +``s3://nextstrain-inventories/resources.json.gz`` are available. + +A lifecycle rule on the s3://nextstrain-inventories bucket (`console link +`__) +permanently deletes past versions of this file 30 days after it became +noncurrent (i.e. it was replaced with a new upload of the index.) + + Index access by the server --------------------------