Indexing data from Amazon (AWS S3)#
Options currently exist that allow for a user to store, index, and retrieve data from cloud object stores, such as Amazon S3 buckets, using the open ODC. While the process is largely the same as the step by step guide there are a few additional requirements outline below.
Configuring AWS CLI Credentials#
Install the AWS CLI package and configure it with your Amazon AWS credentials.
For a more detailed tutorial on AWS CLI configurations, visit the
official AWS docs.
The only two fields required to be configured are the
Access Key, and
Secret Access Key. These keys can be found on your AWS login
security page. Try not to lose your
Secret Access Key as you will
not be able to view it again and you will have to request a new one.
Install AWS S3 Indexing Scripts#
In order to utilize the convenience of S3 indexing, we must install some tools that will help make it easier and faster. You can find the code and further detailed documentation for the tools used below in the odc-tools repository.
pip install --extra-index-url="https://packages.dea.ga.gov.au" odc_apps_dc_tools
S3 Indexing Example#
For this example we will be indexing Digital Earth Australia’s public data bucket, which you can browse at data.dea.ga.gov.au.
Run the two lines below, the first will add the product definition for the Landsat Geomedian product and the second will add all of the Geomedian datasets. This will take some time, but will add a continental product to your local Datacube.
datacube product add https://data.dea.ga.gov.au/geomedian-australia/v2.1.0/product-definition.yaml s3-to-dc --no-sign-request 's3://dea-public-data/geomedian-australia/v2.1.0/L8/**/*.yaml' ls8_nbart_geomedian_annual
Congratulations, you’ve now indexed data from the Digital Earth Australia buckets 🎉