Met de AWS CLI beheer je S3-compatibele Object Store alsof het Amazon S3 is. In deze handleiding lees je hoe je de AWS CLI koppelt aan OpenStack Object Store.
Vereisten
Om AWS CLI te gebruiken, is het uiteraard van belang dat je dit hebt geinstalleerd. Afhankelijk van je besturingssysteem, kan je de stappen op de volgende pagina gebruiken om AWS CLI te installeren.
En vervolgens kan je verifiëren of de installatie correct is verlopen door de versie op te vragen met de volgende commando:
aws --version
Maak een profiel aan
Stap 1
Voor deze stap heb je een ‘Access Key ID’ en ‘Secret Access Key’ nodig. Heb je deze nog niet of ben je je gegevens kwijt? Maak ze dan eerst aan/bekijk ze in het TransIP-controlepaneel, zie onze handleiding over het beheer van S3-tokens.
Met het commando ‘aws configure’ maak je een nieuw profiel aan en vul je Object Store S3-credentials in.
aws configureJe krijgt de volgende prompts te zien, vervang hierbij respectievelijk 1234 door de ‘Acces key’ en abcd door de ‘Secret key’ van je S3-token.
AWS Access Key ID [None]: 1234
AWS Secret Access Key [None]: abcd
Default region name [None]: EU
Default output format [None]: (laat deze leeg)De configuratie wordt opgeslagen in ~/.aws/config en ~/.aws/credentials.
Stap 2
Bij S3-compatible storage (dus niet van AWS zelf) is een kleine configuratiewijziging nodig. Open het bestand ~/.aws/config en voeg in het blokje [Default] de volgende inhoud toe:
request_checksum_calculation = when_required
response_checksum_validation = when_requiredHet eindresultaat ziet er bijvoorbeeld als volgt uit:
[default]
region = EU
request_checksum_calculation = when_required
response_checksum_validation = when_required
Basiscommando’s
Vervang in onderstaande voorbeelden de hostnaam door jouw endpoint en behoud de https://-prefix.
Bij het gebruik van AWS CLI geef je bij elk commando je Object Store endpoint-url mee met de --endpoint-url optie.
Een container (bucket) aanmaken
aws s3 mb s3://my-container --endpoint-url https://<project-id>.objectstore.eu
Containers (buckets) weergeven
aws s3 ls --endpoint-url https://<project-id>.objectstore.eu
Een container (bucket) verwijderen (hiervoor dient de container leeg te zijn)
aws s3 rb s3://my-container --endpoint-url https://jouw-project-id.objectstore.eu
Een bestand uploaden
aws s3 cp ~/example.txt s3://my-container/ --endpoint-url https://<project-id>.objectstore.eu
Een bestand downloaden
aws s3 cp s3://my-container/example.txt ./ --endpoint-url https://<project-id>.objectstore.eu
Een bestand verwijderen
aws s3 rm s3://my-container/example.txt --endpoint-url https://jouw-project-id.objectstore.eu