Dela via


Självstudie: Kopiera data till Azure Data Box Blob Storage via REST-API:er

Varning

Den här artikeln refererar till CentOS, en Linux-distribution som har statusen End Of Life (EOL). Överväg att använda och planera i enlighet med detta. Mer information finns i CentOS End Of Life-vägledningen.

Den här självstudien beskriver procedurer för att ansluta till Azure Data Box Blob-lagring via REST-API:er genom http eller https. När du är ansluten beskrivs de steg som krävs för att kopiera data till Data Box Blob Storage.

I den här självstudien lär du dig att:

  • Förutsättningar
  • Ansluta till Data Box Blob-lagring via http eller https
  • Kopiera data till Data Box Heavy

Förutsättningar

Innan du börjar bör du kontrollera att:

  1. Du har slutfört självstudien : Konfigurera Azure Data Box Heavy.
  2. Du har fått din Data Box Heavy-enhet och orderstatusen på portalen är Levererad.
  3. Du har granskat systemkraven för Data Box Blob-lagring och känner till versioner av API:er, SDK:er och verktyg som stöds.
  4. Du har åtkomst till en värddator som har de data som du vill kopiera över till Data Box Heavy. Värddatorn måste
    • Köra ett operativsystem som stöds.
    • Vara ansluten till en höghastighetsnätverk. För snabbast kopieringshastighet kan två 40-GbE-anslutningar (en per nod) användas parallellt. Om du inte har någon tillgänglig 40-GbE-anslutning rekommenderar vi att du har minst två 10 GbE-anslutningar (en per nod).
  5. Ladda ned AzCopy 7.1.0 på värddatorn. Du använder AzCopy för att kopiera data till Azure Data Box Blob-lagring från värddatorn.

Ansluta via http eller https

Du kan ansluta till Data Box Blob-lagring genom http eller https.

  • Https är det säkra och rekommenderade sättet att ansluta till Data Box Blob Storage.
  • http används när du ansluter via betrodda nätverk.

Stegen för att ansluta skiljer sig åt när du ansluter till Data Box Blob Storage via http eller https.

Ansluta via http

För anslutning till REST-API:er för Data Box Blob-lagring genom http krävs följande steg:

  • Lägga till enhets-IP-adressen och blob-tjänstslutpunkten till fjärrvärden
  • Konfigurera programvara från tredje part och verifiera anslutningen

Vart och ett av dessa steg beskrivs i följande avsnitt.

Viktigt!

För Data Box Heavy måste du upprepa alla anslutningsinstruktioner för att ansluta till den andra noden.

Lägga till enhetens IP-adress och blobtjänstslutpunkt

  1. Logga in på Data Box-enheten. Se till att den är upplåst.

    Skärmbild som visar instrumentpanelen med enheten som olåst.

  2. Gå till Ställ in nätverksgränssnitt. Anteckna enhetens IP-adress för nätverksgränssnittet som används för att ansluta till klienten.

    Skärmbild som visar nätverksinställningarna där du kan se I P-adressen.

  3. Gå till Anslut och kopiera och klicka på Vila.

    Skärmbild som visar fönstret Anslut och kopiera där du kan välja REST som en åtkomstinställning.

  4. Från dialogrutan Öppna lagringskonto och ladda upp data kopierar du Blob Service-slutpunkt.

    Skärmbild som visar dialogrutan Åtkomstlagringskonto och uppladdning av data där du kan kopiera Blob Service-slutpunkten.

  5. Starta Anteckningar som administratör och öppna sedan värdens fil på C:\Windows\System32\Drivers\etc.

  6. Lägg till följande post för värdens fil: <device IP address> <Blob service endpoint>

  7. Använd följande bild som referens. Spara värdens fil.

    Skärmbild som visar ett Anteckningar-dokument med I P-adressen och blobtjänstens slutpunkt tillagd.

Konfigurera partnerprogramvara och verifiera anslutningen

Konfigurera partnerprogrammet så att det ansluter till klienten. För att ansluta till partnerprogramvaran behöver du vanligtvis följande information (kan variera) som du samlade in från sidan Anslut och kopiera i det lokala webbgränssnittet i föregående steg:

  • Lagringskontonamn
  • Åtkomstnyckel
  • Blob-tjänstens slutpunkt

Verifiera att anslutningen har upprättats genom att ansluta till ett externt lagringskonto med Storage Explorer. Om du inte har Storage Explorer måste du ladda ned och installera.

Första gången du använder Storage Explorer måste du utföra följande steg:

  1. I det översta kommandofältet går du till Redigera > Azure Stack för mål.

    Skärmbild som visar Mål Azure Stack valt från redigera-menyn.

  2. Starta om Storage Explorer så att ändringarna träder i kraft.

    Skärmbild som visar knappen Starta om nu.

Anslut till lagringskontot och verifiera anslutningen på följande sätt.

  1. Välj Anslut till Azure Storage i Storage Explorer. Välj Använd lagringskontonamn och nyckel i dialogrutan Anslut till Azure Storage.

    Skärmbild som visar dialogrutan Anslut till Azure Storage med Använd ett lagringskontonamn och en nyckel markerad.

  2. Klistra in ditt kontonamn och din kontonyckel (nyckel 1-värdet från sidan Anslut och kopiera i det lokala webbanvändargränssnittet). Välj Annan (ange nedan) som domän för lagringsslutpunkter och ange den blobtjänstslutpunkt som visas nedan. Markera alternativet Använd HTTP endast om du över via http. Lämna alternativet omarkerat om du använder https. Välj Nästa.

    Skärmbild som visar dialogrutan Anslut med namn och nyckel med angivna värden.

  3. Kontrollera informationen i dialogrutan Anslutningssammanfattning. Välj Anslut.

    Skärmbild som visar dialogrutan Anslutningssammanfattning med Connect markerat.

  4. Det konto som du har lagt till visas i den vänstra rutan i Storage Explorer med (extern, övrigt) i slutet av namnet. Visa containern genom att klicka på Blobcontainer.

    Skärmbild som visar Explorer-menyn med blobcontainrar markerade.

Ansluta via https

För anslutning till REST-API:er för Azure Blob-lagring genom https krävs följande steg:

  • Ladda ned certifikatet från Azure-portalen
  • Importera certifikatet på klienten eller fjärrvärden
  • Lägg till enhetens IP- och blobtjänstslutpunkt till klienten eller fjärrvärden
  • Konfigurera programvara från tredje part och verifiera anslutningen

Vart och ett av dessa steg beskrivs i följande avsnitt.

Viktigt!

För Data Box Heavy måste du upprepa alla anslutningsinstruktioner för att ansluta till den andra noden.

Ladda ned certifikat

Använda Azure-portalen för att ladda ned certifikatet.

  1. Logga in på Azure-portalen.

  2. Gå till din Data Box-beställning och gå till Allmän > enhetsinformation.

  3. Under Autentiseringsuppgifter för enheten går du till API-åtkomst till enheten. Klicka på Ladda ned. Den här åtgärden laddar ned ett <beställningsnamn>.cer certifikatfil. Spara filen. Du installerar det här certifikatet på den klient- eller värddatorn som du kommer att använda för att ansluta till enheten.

    Ladda ned certifikat i Azure-portalen

Importera certifikat

För åtkomst till Data Box Blob Storage via HTTPS krävs ett TLS/SSL-certifikat för enheten. Hur det här certifikatet görs tillgängligt för klientprogrammet varierar från program till program och mellan operativsystem och distributioner. Vissa program kan komma åt certifikatet när det har importerats till systemets certifikatarkiv, medan andra program inte använder den mekanismen.

Specifik information för vissa program nämns i det här avsnittet. Mer information om andra program finns i dokumentationen för programmet och det operativsystem som används.

Följ de här stegen för att importera .cer filen till rotarkivet för en Windows- eller Linux-klient. I ett Windows-system kan du använda Windows PowerShell eller Windows Server-användargränssnittet för att importera och installera certifikatet i systemet.

Använda Windows PowerShell

  1. Starta en Windows PowerShell-session som administratör.

  2. Skriv i kommandotolken:

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

Använda Windows Server-användargränssnittet

  1. Högerklicka på .cer filen och välj Installera certifikat. Den här åtgärden startar guiden Importera certifikat.

  2. För Store location (Lagringsplats) väljer du Lokal dator och klickar sedan på Nästa.

    Importera certifikat med hjälp av PowerShell

  3. Välj Place all certificates in the following store (Placera alla certifikat i följande lagringsplats) och klicka sedan på Bläddra. Gå till rotcertifikatarkivet på fjärrvärden och klicka på Nästa.

    Importera certifikat med PowerShell 2

  4. Klicka på Finish. Ett meddelande visas där det står att importen lyckades.

    Importera certifikat med PowerShell 3

Använda ett Linux-system

Metoden för att importera ett certifikat varierar beroende på distribution.

Viktigt!

För Data Box Heavy måste du upprepa alla anslutningsinstruktioner för att ansluta till den andra noden.

Flera, till exempel Ubuntu och Debian, använder update-ca-certificates kommandot.

  • Byt namn på den Base64-kodade certifikatfilen till att ha ett .crt tillägg och kopiera det till /usr/local/share/ca-certificates directory.
  • Kör kommandot update-ca-certificates.

De senaste versionerna av RHEL, Fedora och CentOS använder update-ca-trust kommandot .

  • Kopiera certifikatfilen till /etc/pki/ca-trust/source/anchors katalogen.
  • Kör update-ca-trust.

Mer information finns i dokumentationen som är specifik för din distribution.

Lägga till enhetens IP-adress och blobtjänstslutpunkt

Följ samma steg för att lägga till enhetens IP-adress och blobtjänstslutpunkt när du ansluter via http.

Konfigurera partnerprogramvara och verifiera anslutningen

Följ stegen för att konfigurera partnerprogramvara som du använde när du anslöt via http. Den enda skillnaden är att du låter alternativet Använd http vara avmarkerat.

Kopiera data till Data Box Heavy

När du är ansluten till Data Box-lagringen är nästa steg att kopiera data. Granska följande innan du kopierar data:

  • När du kopierar data kontrollerar du att datastorleken överensstämmer med de storleksgränser som beskrivs i gränserna för Azure Storage och Data Box Heavy.
  • Om data, som laddas upp av Data Box Heavy, laddas upp samtidigt av andra program utanför Data Box Heavy, kan detta resultera i fel i uppladdningsjobbet och skadade data.

I den här självstudien används AzCopy för att kopiera data till Data Box Blob-lagring. Du kan även använda Azure Storage Explorer (om du föredrar ett GUI-baserat verktyg) eller partnerprogramvara för att kopiera data.

Kopieringsproceduren omfattar följande steg:

  • Skapa en container
  • Ladda upp innehåll i en mapp till Data Box Blob-lagring
  • Ladda upp ändrade filer till Data Box Blob-lagring

Vart och ett av dessa steg beskrivs ingående i följande avsnitt.

Viktigt!

För Data Box Heavy måste du upprepa alla kopieringsinstruktioner för att kopiera data till den andra noden.

Skapa en container

Det första steget är att skapa en container, eftersom blobar alltid laddas upp till en container. Containrar organiserar grupper av blobar på samma sätt som du ordnar filer i mappar på datorn. Skapa en blob-container genom att följa de här stegen.

  1. Öppna Storage Explorer.

  2. I den vänstra fönsterrutan expanderar du det lagringskonto där du vill skapa blob-containern.

  3. Högerklicka på Blob-containrar och välj Skapa blob-container på snabbmenyn.

    Snabbmeny för att skapa blob-containrar

  4. En textruta visas nedanför mappen Blob Containers (Blob-containrar). Ange namnet på blob-containern. Information om regler och begränsningar vid namngivning av blob-containrar finns i Skapa containern och ange behörigheter.

  5. Tryck på Retur när du är klar så att blob-containern skapas eller på Esc om du vill avbryta. När blob-containern har skapats visas den i mappen Blob Containers (Blob-containrar) för det valda lagringskontot.

    Blob-containern har skapats

Ladda upp innehåll i en mapp till Data Box Blob-lagring

Använd AzCopy för att ladda upp alla filer i en mapp till Blob-lagring i Windows eller Linux. Överför alla blobar i en mapp genom att ange följande AzCopy-kommando:

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

Ersätt <key> med din kontonyckel. Du hämtar kontonyckeln genom att gå till Azure-portalen och sedan till ditt lagringskonto. Gå till Inställningar > Åtkomstnycklar, välj en nyckel och klistra in den i Kommandot AzCopy.

Om den angivna målcontainern inte finns, så skapar AzCopy den och överför filen till den. Uppdatera källsökvägen till datakatalogen och ersätt data-box-storage-account-name i mål-URL:en med namnet på det lagringskontot som är associerat med din Data Box-enhet.

Om du vill överföra den angivna katalogens innehåll till Blob Storage rekursivt, så ange alternativet --recursive (Linux) eller /S (Windows). När du kör AzCopy med något av följande alternativ, så överförs även alla undermappar och filer.

Ladda upp ändrade filer till Data Box Blob-lagring

Använd AzCopy för att ladda upp filer baserat på den tid då de senaste ändrades. Om du vill testa detta, så ändra eller skapa nya filer i källkatalogen i testsyfte. Om du bara vill överföra uppdaterade eller nya filer, så lägg till parametern --exclude-older (Linux) eller /XO (Windows) i AzCopy-kommandot.

Om du bara vill kopiera källresurser som inte finns i målet, så ange båda parametrarna --exclude-older och --exclude-newer (Linux) eller /XO och /XN (Windows) i AzCopy-kommandot. AzCopy överför bara uppdaterade data utifrån deras tidsstämplar.

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

Om det finns några fel under anslutnings- eller kopieringsåtgärden kan du läsa Felsöka problem med Data Box Blob Storage.

Nästa steg är att förbereda enheten för leverans.

Nästa steg

I den här kursen har du lärt dig om Azure Data Box-ämnen som att:

  • Förutsättningar
  • Ansluta till Data Box Blob-lagring via http eller https
  • Kopiera data till Data Box Heavy

Gå vidare till nästa självstudie och lär dig hur du skickar tillbaka din Data Box-enhet till Microsoft.