Udostępnij za pośrednictwem


Samouczek: kopiowanie danych do usługi Azure Data Box Blob Storage za pośrednictwem interfejsów API REST

Uwaga

W tym artykule odwołuje się do systemu CentOS — dystrybucji systemu Linux, która jest stanem End Of Life (EOL). Rozważ odpowiednie użycie i planowanie. Aby uzyskać więcej informacji, zobacz wskazówki dotyczące zakończenia życia systemu CentOS.

W tym samouczku opisano procedury łączenia się z magazynem obiektów blob usługi Azure Data Box za pośrednictwem protokołu HTTP lub HTTPS przy użyciu interfejsów API REST. Po nawiązaniu połączenia opisane są kroki wymagane do skopiowania danych do usługi Data Box Blob Storage.

Z tego samouczka dowiesz się, jak wykonywać następujące czynności:

  • Wymagania wstępne
  • Łączenie się z magazynem obiektów blob usługi Data Box za pośrednictwem protokołu HTTP lub HTTPS
  • Kopiowanie danych na urządzenie Data Box Heavy

Wymagania wstępne

Przed rozpoczęciem upewnij się, że:

  1. Ukończono samouczek : konfigurowanie urządzenia Azure Data Box Heavy.
  2. Urządzenie Data Box Heavy zostało do Ciebie dostarczone, a stan zamówienia w portalu to Dostarczono.
  3. Znasz wymagania systemowe magazynu obiektów blob usługi Data Box oraz obsługiwane wersje interfejsów API, zestawów SDK i narzędzi.
  4. Masz dostęp do komputera hosta zawierającego dane, które chcesz skopiować do urządzenia Data Box Heavy. Komputer-host musi
    • Korzystanie z obsługiwanego systemu operacyjnego.
    • Połączenie z siecią o dużej szybkości. Aby uzyskać największe szybkości kopiowania, można użyć dwóch równoległych połączeń 40-GbE (po jednym na węzeł). Jeśli nie masz dostępnego połączenia 40-GbE, zalecamy skorzystanie z co najmniej dwóch połączeń 10-GbE (po jednym na węzeł).
  5. Pobierz narzędzie AzCopy 7.1.0 na komputer hosta. Użyjesz narzędzia AzCopy do skopiowania danych z komputera hosta do magazynu obiektów blob usługi Azure Data Box.

Nawiązywanie połączenia za pośrednictwem protokołu HTTP lub https

Możesz nawiązać połączenie z magazynem obiektów blob usługi Data Box za pośrednictwem protokołu HTTP lub HTTPS.

  • Https to bezpieczny i zalecany sposób nawiązywania połączenia z usługą Data Box Blob Storage.
  • Protokół HTTP jest używany, gdy połączenie jest nawiązywane za pośrednictwem zaufanych sieci.

Kroki nawiązywania połączenia różnią się w przypadku nawiązywania połączenia z usługą Data Box Blob Storage za pośrednictwem protokołu HTTP lub https.

Nawiązywanie połączenia za pośrednictwem protokołu HTTP

Aby nawiązać połączenie z interfejsami API REST magazynu obiektów blob usługi Data Box za pośrednictwem protokołu HTTP, należy wykonać następujące czynności:

  • Dodawanie adresu IP urządzenia i punktu końcowego usługi obiektów blob do hosta zdalnego
  • Konfigurowanie oprogramowania innych firm i weryfikowanie połączenia

Wszystkie wymienione kroki zostały opisane poniżej.

Ważne

W przypadku urządzenia Data Box Heavy należy powtórzyć wszystkie instrukcje połączenia, aby nawiązać połączenie z drugim węzłem.

Dodawanie adresu IP urządzenia i punktu końcowego usługi blob

  1. Zaloguj się do urządzenia Data Box. Upewnij się, że jest odblokowane.

    Zrzut ekranu przedstawia pulpit nawigacyjny z urządzeniem wyświetlanym jako Odblokowano.

  2. Przejdź do pozycji Ustaw interfejsy sieciowe. Zanotuj adres IP urządzenia dla interfejsu sieciowego używanego do łączenia z klientem.

    Zrzut ekranu przedstawia ustawienia sieci, w których można zobaczyć adres I P.

  3. Przejdź do pozycji Połącz i skopiuj i kliknij pozycję Rest.

    Zrzut ekranu przedstawiający okienko Łączenie i kopiowanie, w którym można wybrać interfejs REST jako ustawienie dostępu.

  4. W oknie dialogowym Uzyskaj dostęp do konta magazynu i przekaż dane skopiuj Punkt końcowy usługi blob.

    Zrzut ekranu przedstawiający okno dialogowe Uzyskiwanie dostępu do konta magazynu i przekazywanie danych, w którym można skopiować punkt końcowy usługi Blob Service.

  5. Uruchom program Notatnik jako administrator, a następnie otwórz plik hosts znajdujący się w folderze C:\Windows\System32\Drivers\etc.

  6. Dodaj do pliku hosts następujący wpis: <device IP address> <Blob service endpoint>

  7. Powinno to wyglądać podobnie jak na poniższej ilustracji. Zapisz plik hosts.

    Zrzut ekranu przedstawia dokument Notatnika z dodanym adresem I I i punktem końcowym usługi obiektów blob.

Konfigurowanie oprogramowania partnerów i weryfikowanie połączenia

Konfiguracja oprogramowania partnerskiego pod kątem nawiązania połączenia z klientem. Aby nawiązać połączenie z oprogramowaniem partnerskim, zazwyczaj potrzebne są następujące informacje (mogą się różnić) zebrane na stronie Łączenie i kopiowanie lokalnego internetowego interfejsu użytkownika w poprzednim kroku:

  • Nazwa konta magazynu
  • Klucz dostępu
  • Punkt końcowy usługi Blob

Aby sprawdzić, czy połączenie zostało pomyślnie nawiązane, użyj Eksploratora usługi Storage w celu dołączenia do zewnętrznego konta magazynu. Jeśli nie masz Eksplorator usługi Storage, musisz pobrać i zainstalować.

Przy pierwszym użyciu Eksplorator usługi Storage należy wykonać następujące kroki:

  1. Na górnym pasku poleceń przejdź do pozycji Edytuj docelową usługę Azure Stack.>

    Zrzut ekranu przedstawiający pozycję Docelowa usługa Azure Stack wybrana z menu Edytuj.

  2. Uruchom ponownie Eksploratora usługi Storage, aby zmiany zaczęły obowiązywać.

    Zrzut ekranu przedstawia przycisk Uruchom teraz.

Wykonaj poniższe czynności, aby nawiązać i zweryfikować połączenie z kontem magazynu.

  1. W Eksploratorze usługi Storage otwórz okno dialogowe Połącz z usługą Azure Storage. W oknie dialogowym Połącz z usługą Azure Storage wybierz pozycję Użyj nazwy i klucza konta magazynu.

    Zrzut ekranu przedstawiający okno dialogowe Łączenie z usługą Azure Storage z wybraną nazwą konta magazynu i kluczem.

  2. Wklej wartości dla swojego konta w polach Nazwa konta i Klucz konta (wartość 1 klucza ze strony Połącz i skopiuj w lokalnym internetowym interfejsie użytkownika). Wybierz opcję Domena punktów końcowych magazynu w polu Inne (podaj poniżej), a następnie podaj punkt końcowy usługi obiektów blob, jak pokazano poniżej. Opcję Użyj protokołu HTTP zaznacz tylko wtedy, gdy przesyłasz za pośrednictwem protokołu http. Jeśli używasz protokołu https, nie zaznaczaj tej opcji. Wybierz Dalej.

    Zrzut ekranu przedstawia okno dialogowe Łączenie z nazwą i kluczem z wprowadzonymi wartościami.

  3. Sprawdź informacje podane w oknie dialogowym Podsumowanie połączenia. Wybierz pozycję Połącz.

    Zrzut ekranu przedstawia okno dialogowe Podsumowanie połączenia z wybraną pozycję Połącz.

  4. Pomyślnie dodane konto jest wyświetlane w lewym okienku Eksploratora usługi Storage z wartościami (Zewnętrzne, Inne) dołączonymi do jego nazwy. Kliknij pozycję Kontenery obiektów blob, aby wyświetlić kontener.

    Zrzut ekranu przedstawiający menu Eksploratora z wybranymi kontenerami obiektów blob.

Nawiązywanie połączenia za pośrednictwem protokołu HTTPS

Aby nawiązać połączenie z interfejsami API REST usługi Azure Blob Storage za pośrednictwem protokołu HTTPS, należy wykonać następujące czynności:

  • Pobieranie certyfikatu z witryny Azure Portal
  • Importowanie certyfikatu na kliencie lub hoście zdalnym
  • Dodawanie adresu IP urządzenia i punktu końcowego usługi obiektów blob do klienta lub hosta zdalnego
  • Konfigurowanie oprogramowania innych firm i weryfikowanie połączenia

Wszystkie wymienione kroki zostały opisane poniżej.

Ważne

W przypadku urządzenia Data Box Heavy należy powtórzyć wszystkie instrukcje połączenia, aby nawiązać połączenie z drugim węzłem.

Pobieranie certyfikatu

Pobierz certyfikat z witryny Azure Portal.

  1. Zaloguj się do Azure Portal.

  2. Przejdź do zamówienia urządzenia Data Box i przejdź do pozycji Ogólne > szczegóły urządzenia.

  3. W obszarze Poświadczenia urządzenia przejdź do sekcji Dostęp za pomocą interfejsu API. Kliknij pozycję Pobierz. Ta akcja spowoduje pobranie <nazwy> zamówienia.cer pliku certyfikatu. Zapisz ten plik. Ten certyfikat zainstalujesz na komputerze klienta lub hosta, którego będziesz używać do nawiązania połączenia z urządzeniem.

    Pobieranie certyfikatu z witryny Azure Portal

Importowanie certyfikatu

Uzyskiwanie dostępu do usługi Data Box Blob Storage za pośrednictwem protokołu HTTPS wymaga certyfikatu TLS/SSL dla urządzenia. Sposób, w jaki ten certyfikat jest udostępniany aplikacji klienckiej, różni się od aplikacji do aplikacji i między systemami operacyjnymi i dystrybucjami. Niektóre aplikacje mogą uzyskać dostęp do certyfikatu po zaimportowaniu go do magazynu certyfikatów systemu, podczas gdy inne aplikacje nie korzystają z tego mechanizmu.

W tej sekcji wymieniono konkretne informacje dotyczące niektórych aplikacji. Aby uzyskać więcej informacji na temat innych aplikacji, zapoznaj się z dokumentacją aplikacji i używanego systemu operacyjnego.

Wykonaj następujące kroki, aby zaimportować .cer plik do magazynu głównego klienta systemu Windows lub Linux. W systemie Windows można użyć środowiska Windows PowerShell lub interfejsu użytkownika systemu Windows Server do zaimportowania i zainstalowania certyfikatu w systemie.

Użycie środowiska Windows PowerShell

  1. Uruchom sesję programu Windows PowerShell jako administrator.

  2. W wierszu polecenia wpisz:

    Import-Certificate -FilePath C:\temp\localuihttps.cer -CertStoreLocation Cert:\LocalMachine\Root
    

Korzystanie z interfejsu użytkownika systemu Windows Server

  1. Kliknij prawym przyciskiem .cer myszy plik i wybierz polecenie Zainstaluj certyfikat. Ta akcja powoduje uruchomienie Kreatora importu certyfikatów.

  2. W polu Lokalizacja magazynu wybierz pozycję Maszyna lokalna, a następnie kliknij przycisk Dalej.

    Importowanie certyfikatu przy użyciu programu PowerShell

  3. Wybierz pozycję Umieść wszystkie certyfikaty w następującym magazynie, a następnie kliknij przycisk Przeglądaj. Przejdź do głównego magazynu hosta zdalnego, a następnie kliknij przycisk Dalej.

    Importowanie certyfikatu przy użyciu programu PowerShell 2

  4. Kliknij przycisk Zakończ. Pojawi się komunikat informujący, że importowanie zakończyło się pomyślnie.

    Importowanie certyfikatu przy użyciu programu PowerShell 3

Korzystanie z systemu Linux

Metoda importowania certyfikatu różni się w zależności od dystrybucji.

Ważne

W przypadku urządzenia Data Box Heavy należy powtórzyć wszystkie instrukcje połączenia, aby nawiązać połączenie z drugim węzłem.

Kilka z nich, takich jak Ubuntu i Debian, używa update-ca-certificates polecenia .

  • Zmień nazwę pliku .crt certyfikatu zakodowanego w formacie Base64 na rozszerzenie i skopiuj go do pliku /usr/local/share/ca-certificates directory.
  • Uruchom polecenie update-ca-certificates.

Najnowsze wersje systemów RHEL, Fedora i CentOS używają update-ca-trust polecenia .

  • Skopiuj plik certyfikatu do /etc/pki/ca-trust/source/anchors katalogu.
  • Uruchom program update-ca-trust.

Aby uzyskać szczegółowe informacje, zapoznaj się z dokumentacją specyficzną dla twojej dystrybucji.

Dodawanie adresu IP urządzenia i punktu końcowego usługi blob

Wykonaj te same kroki, aby dodać adres IP urządzenia i punkt końcowy usługi blob podczas nawiązywania połączenia za pośrednictwem protokołu HTTP.

Konfigurowanie oprogramowania partnerów i weryfikowanie połączenia

Wykonaj kroki konfigurowania oprogramowania partnerskiego używanego podczas nawiązywania połączenia za pośrednictwem protokołu HTTP. Jedyną różnicą jest to, że należy pozostawić pole Użyj protokołu HTTP niezaznaczone.

Kopiowanie danych na urządzenie Data Box Heavy

Po nawiązaniu połączenia z magazynem obiektów blob usługi Data Box następnym krokiem jest skopiowanie danych. Przed rozpoczęciem kopiowania danych należy uwzględnić następujące kwestie:

  • Podczas kopiowania danych upewnij się, że rozmiar danych jest zgodny z limitami rozmiaru opisanymi w limitach usługi Azure Storage i Data Box Heavy.
  • Jeśli dane, które są przekazywane przez urządzenie Data Box Heavy, są współbieżnie przekazywane przez inne aplikacje poza urządzeniem Data Box Heavy, może to spowodować błędy zadań przekazywania i uszkodzenie danych.

W tym samouczku użyjesz narzędzia AzCopy do skopiowania danych do magazynu obiektów blob usługi Data Box. Możesz również skopiować dane za pomocą Eksploratora usługi Azure Storage (jeśli wolisz użyć narzędzia z graficznym interfejsem użytkownika) lub oprogramowania partnera.

Procedura kopiowania obejmuje następujące czynności:

  • Tworzenie kontenera
  • Przekazywanie zawartości folderu do magazynu obiektów blob usługi Data Box
  • Przekazywanie zmodyfikowanych plików do magazynu obiektów blob usługi Data Box

Wszystkie wymienione kroki zostały szczegółowo opisane poniżej.

Ważne

W przypadku urządzenia Data Box Heavy należy powtórzyć wszystkie instrukcje kopiowania, aby skopiować dane do drugiego węzła.

Tworzenie kontenera

Pierwszym krokiem jest utworzenie kontenera, ponieważ obiekty blob są zawsze przekazywane do kontenera. Kontenery umożliwiają organizowanie grup obiektów blob w sposób podobny do organizowania plików w folderach na komputerze. Wykonaj następujące czynności, aby utworzyć kontener obiektów blob.

  1. Otwórz Eksplorator usługi Storage.

  2. W okienku po lewej stronie rozwiń konto magazynu, w którym chcesz utworzyć kontener obiektów blob.

  3. Kliknij prawym przyciskiem myszy pozycję Kontenery obiektów Blob i wybierz pozycję Utwórz kontener obiektów Blob z menu kontekstowego.

    Menu kontekstowe — tworzenie kontenerów obiektów blob

  4. Poniżej folderu Kontenery obiektów Blob będzie widoczne pole tekstowe. Wprowadź nazwę kontenera obiektów blob. Informacje na temat reguł i ograniczeń dotyczących nazewnictwa kontenerów obiektów blob znajdują się w sekcji Tworzenie kontenera i ustawianie uprawnień.

  5. Po zakończeniu naciśnij klawisz Enter, aby utworzyć kontener obiektów blob, lub klawisz Esc, aby anulować. Po pomyślnym utworzeniu kontener obiektów blob zostanie wyświetlony w folderze Kontenery obiektów blob na wybranym koncie magazynu.

    Utworzony kontener obiektów blob

Przekazywanie zawartości folderu do magazynu obiektów blob usługi Data Box

Użyj narzędzia AzCopy, aby przekazać wszystkie pliki w folderze do magazynu obiektów blob w systemie Windows lub Linux. Aby przekazać wszystkie obiekty blob w folderze, wprowadź następujące polecenie narzędzia AzCopy:

Linux

azcopy \
    --source /mnt/myfolder \
    --destination https://data-box-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/files/ \
    --dest-key <key> \
    --recursive

Windows

AzCopy /Source:C:\myfolder /Dest:https://data-box-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/files/ /DestKey:<key> /S

Zastąp wartość <key> własnym kluczem konta. Aby znaleźć klucz konta, w witrynie Azure Portal przejdź do swojego konta magazynu. Przejdź do pozycji Ustawienia > Klucze dostępu, wybierz klucz i wklej go do polecenia AzCopy.

Jeśli określony kontener docelowy nie istnieje, narzędzie AzCopy utworzy go i przekaże do niego plik. Zmień ścieżkę źródłową na Twój katalog danych i zastąp wartość data-box-storage-account-name w docelowym adresie URL nazwą konta magazynu skojarzonego z Twoją usługą Data Box.

Aby przekazać zawartość określonego katalogu do magazynu obiektów blob w sposób rekursywny, określ opcję --recursive (system Linux) lub /S (system Windows). Po uruchomieniu narzędzia AzCopy z jedną z tych opcji wszystkie podfoldery i znajdujące się w nich pliki również zostaną przekazane.

Przekazywanie zmodyfikowanych plików do magazynu obiektów blob usługi Data Box

Użyj narzędzia AzCopy do przekazania plików na podstawie daty ich ostatniej modyfikacji. Aby z tego skorzystać, zmodyfikuj pliki lub utwórz nowe pliki w katalogu źródłowym do celów testowych. Aby przekazać tylko zaktualizowane lub nowe pliki, do polecenia narzędzia AzCopy dodaj parametr --exclude-older (system Linux) lub /XO (system Windows).

Jeśli chcesz skopiować tylko zasoby źródłowe, które nie istnieją w miejscu docelowym, określ zarówno parametry --exclude-older i --exclude-newer (system Linux) lub /XO i /XN (system Windows) w poleceniu narzędzia AzCopy. Narzędzie AzCopy przekazuje tylko zaktualizowane dane na podstawie ich sygnatury czasowej.

Linux

azcopy \
--source /mnt/myfolder \
--destination https://data-box-heavy-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/files/ \
--dest-key <key> \
--recursive \
--exclude-older

Windows

AzCopy /Source:C:\myfolder /Dest:https://data-box-heavy-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/files/ /DestKey:<key> /S /XO

Jeśli podczas operacji łączenia lub kopiowania występują błędy, zobacz Rozwiązywanie problemów z usługą Data Box Blob Storage.

Następnym krokiem jest przygotowanie urządzenia do wysłania.

Następne kroki

W tym samouczku przedstawiono zagadnienia dotyczące usługi Azure Data Box, takie jak:

  • Wymagania wstępne
  • Łączenie się z magazynem obiektów blob usługi Data Box za pośrednictwem protokołu HTTP lub HTTPS
  • Kopiowanie danych na urządzenie Data Box Heavy

Przejdź do następnego samouczka, aby dowiedzieć się, jak odesłać urządzenie Data Box do firmy Microsoft.