Met de AWS CLI beheer je S3-compatible Object Store alsof het Amazon S3 is. In deze handleiding lees je hoe je de AWS CLI koppelt aan OpenStack Object Store.
Vereisten
Installeer eerst de AWS CLI. Gebruik hiervoor de stappen uit de officiële AWS-documentatie: de AWS CLI installeren.
Controleer daarna of de installatie succesvol is afgerond door de versie van de AWS CLI op te vragen:
aws --version
Een profiel aanmaken
Stap 1
Voor deze stap heb je een ‘Access Key ID’ en een ‘Secret Access Key’ nodig. Heb je deze nog niet, of ben je deze gegevens kwijt? Maak ze dan eerst aan of bekijk ze in het TransIP-controlepaneel. Gebruik hiervoor onze handleiding voor het beheren van S3-tokens.
Met het commando ‘aws configure’ maak je het standaardprofiel van de AWS CLI aan en vul je de Object Store S3-credentials in.
aws configureJe krijgt de volgende prompts te zien. Vervang <jouw_access_key> door de ‘Access Key ID’ en <jouw_secret_key> door de ‘Secret Access Key’ van je S3-token.
AWS Access Key ID [None]: <jouw_access_key>
AWS Secret Access Key [None]: <jouw_secret_key>
Default region name [None]: EU
Default output format [None]:Laat ‘Default output format’ leeg en druk op enter. De configuratie wordt opgeslagen in ~/.aws/config en ~/.aws/credentials.
Stap 2
Voor S3-compatible storage die niet door AWS zelf wordt geleverd, voeg je het Object Store-endpoint en de checksum-instellingen toe aan de AWS CLI-configuratie. Open het bestand ~/.aws/config en voeg de volgende regels toe aan het [default]-blok:
request_checksum_calculation = when_required
response_checksum_validation = when_required
endpoint_url = https://<jouw_project_id>.objectstore.euHet eindresultaat ziet er bijvoorbeeld als volgt uit:
[default]
region = EU
request_checksum_calculation = when_required
response_checksum_validation = when_required
endpoint_url = https://<jouw_project_id>.objectstore.eu
Basiscommando’s
Met eenvoudige commando’s maak je containers aan, upload of download je bestanden en beheer je resources. Hieronder staan een aantal basiscommando’s voor het werken met de AWS CLI.
Een container (bucket) aanmaken
aws s3 mb s3://my-container
Containers (buckets) weergeven
aws s3 ls
Een lege container (bucket) verwijderen
aws s3 rb s3://my-container
Een bestand uploaden
aws s3 cp ~/example.txt s3://my-container/
Een bestand downloaden
aws s3 cp s3://my-container/example.txt ./
Een bestand verwijderen
aws s3 rm s3://my-container/example.txt
In deze handleiding heb je de AWS CLI gekoppeld aan OpenStack Object Store en basiscommando’s gebruikt voor het beheren van containers en bestanden.