Szybki start¶

Ta instrukcja przeprowadzi Cię przez pierwsze uruchomienie Cloud4You Object Storage S3.

Po jej wykonaniu:

skonfigurujesz dane dostępowe,
sprawdzisz połączenie z usługą,
utworzysz pierwszy bucket,
prześlesz plik,
pobierzesz go ponownie.

Dane potrzebne do połączenia¶

Przed rozpoczęciem przygotuj:

Access Key
Secret Key

Parametry usługi:

Endpoint: https://s3.cloud4you.pl
Region:   eu-pl-1

Nie udostępniaj Secret Key

Secret Key należy traktować jak hasło.

Nie publikuj go w repozytoriach Git, dokumentacji, kodzie źródłowym ani wiadomościach dostępnych dla osób nieuprawnionych.

1. Zainstaluj AWS CLI¶

AWS CLI jest oficjalnym klientem Amazon Web Services i może być używany również z usługami kompatybilnymi z Amazon S3 API.

Windows¶

Po zainstalowaniu AWS CLI otwórz PowerShell i sprawdź:

aws --version

Jeżeli polecenie działa poprawnie, zobaczysz informację o zainstalowanej wersji.

macOS¶

Jeżeli korzystasz z Homebrew:

brew install awscli

Następnie sprawdź:

aws --version

Linux¶

Po instalacji AWS CLI sprawdź:

aws --version

2. Skonfiguruj profil Cloud4You¶

Uruchom:

aws configure --profile cloud4you

AWS CLI poprosi o podanie danych.

Wprowadź:

AWS Access Key ID:
<otrzymany Access Key>

AWS Secret Access Key:
<otrzymany Secret Key>

Default region name:
eu-pl-1

Default output format:
json

Profil zostanie zapisany lokalnie na Twoim komputerze.

W kolejnych przykładach będziemy używać profilu:

cloud4you

3. Sprawdź połączenie¶

Uruchom:

aws \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl \
  --region eu-pl-1 \
  s3api list-buckets

Jeżeli konto nie posiada jeszcze żadnych bucketów, odpowiedź może wyglądać tak:

{
  "Buckets": []
}

Połączenie działa

Pusta lista Buckets jest prawidłowym wynikiem.

Oznacza tylko, że użytkownik nie posiada jeszcze żadnego bucketa.

Jeżeli zamiast listy otrzymasz błąd, przejdź do sekcji Najczęstsze błędy w dokumentacji.

4. Utwórz pierwszy bucket¶

Bucket jest kontenerem, w którym przechowywane są obiekty.

W tym przykładzie użyjemy nazwy:

firma-backup-01

Nazwa bucketa

Zastąp firma-backup-01 własną nazwą.

Zalecamy używanie małych liter, cyfr i myślników.

Utwórz bucket:

aws \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl \
  --region eu-pl-1 \
  s3api create-bucket \
  --bucket firma-backup-01 \
  --create-bucket-configuration LocationConstraint=eu-pl-1

Jeżeli polecenie zakończy się bez błędu, bucket został utworzony.

5. Sprawdź listę bucketów¶

Ponownie wykonaj:

aws \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl \
  s3api list-buckets

Powinieneś zobaczyć utworzony bucket.

Przykład:

{
  "Buckets": [
    {
      "Name": "firma-backup-01"
    }
  ]
}

6. Utwórz plik testowy¶

Linux i macOS¶

echo "Cloud4You Object Storage S3 test" > test.txt

Windows PowerShell¶

"Cloud4You Object Storage S3 test" | Out-File test.txt

7. Prześlij plik do S3¶

Uruchom:

aws \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl \
  s3 cp test.txt s3://firma-backup-01/test.txt

Po poprawnym przesłaniu AWS CLI wyświetli informację o wykonanym uploadzie.

8. Wyświetl zawartość bucketa¶

aws \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl \
  s3 ls s3://firma-backup-01/

Powinieneś zobaczyć:

test.txt

9. Pobierz plik z S3¶

Pobierz obiekt pod nową nazwą:

aws \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl \
  s3 cp s3://firma-backup-01/test.txt ./test-pobrany.txt

Sprawdź jego zawartość.

Linux i macOS¶

cat test-pobrany.txt

Windows PowerShell¶

Get-Content .\test-pobrany.txt

Powinieneś zobaczyć:

Cloud4You Object Storage S3 test

10. Usuń plik testowy¶

Jeżeli test został zakończony, możesz usunąć obiekt:

aws \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl \
  s3 rm s3://firma-backup-01/test.txt

11. Usuń testowy bucket¶

Pusty bucket można usunąć:

aws \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl \
  s3api delete-bucket \
  --bucket firma-backup-01

Bucket musi być pusty

Nie można usunąć bucketa zawierającego obiekty.

Gotowe¶

Jeżeli wszystkie powyższe operacje zakończyły się poprawnie, masz działający dostęp do Cloud4You Object Storage S3.

Potrafisz już:

wyświetlać listę bucketów,
tworzyć buckety,
przesyłać obiekty,
pobierać obiekty,
usuwać dane.

Następnie warto zapoznać się z:

Podstawowymi pojęciami
Zarządzaniem bucketami
Wersjonowaniem
AWS CLI
Najczęstszymi błędami