Oktatóanyag: Adatok másolása az Azure Data Box Blob Storage-ba REST API-k használatával

Ez az oktatóanyag az Azure Data Box Blob Storage-hoz REST API-kon keresztül HTTP-en vagy https-en keresztüli csatlakozás eljárásait ismerteti. A csatlakozás után az adatok Data Box Blob Storage-ba másolásához és a Data Box szállításra való előkészítéséhez szükséges lépéseket is ismertetjük.

Eben az oktatóanyagban az alábbiakkal fog megismerkedni:

  • Előfeltételek
  • Csatlakozás a Data Box Blob Storage-ba HTTP-en vagy https-en keresztül
  • Adatok másolása a Data Boxra

Előfeltételek

Mielőtt hozzákezd, győződjön meg az alábbiakról:

  1. Az Az Azure Data Box beállítása című oktatóanyagot.
  2. Megkapta a Data Boxot, és a portálon a megrendelés Kézbesítve állapotú.
  3. Áttekintette a Data Box Blob Storage rendszerkövetelményeit , és ismeri az API-k, SDK-k és eszközök támogatott verzióit.
  4. Olyan gazdagéphez fér hozzá, amely a Data Boxba másolni kívánt adatokat tartalmazza. A gazdaszámítógépen:
    • egy támogatott operációs rendszernek kell futnia;
    • egy nagy sebességű hálózathoz kell csatlakoznia. Határozottan javasoljuk, hogy legalább 10 GbE sebességű kapcsolattal rendelkezzen. Ha egy 10 GbE-os kapcsolat nem érhető el, egy 1 GbE-os adatkapcsolat használható, de a másolási sebességre ez hatással lesz.
  5. Töltse le az AzCopy 7.1.0-t a gazdaszámítógépre. Az AzCopy használatával másol adatokat az Azure Data Box Blob Storage-ba a gazdaszámítógépről.

Csatlakozás HTTP-en vagy https-en keresztül

A Data Box Blob Storage-hoz http vagy https protokollon keresztül csatlakozhat.

  • A Data Box Blob Storage-hoz való csatlakozás biztonságos és ajánlott módja a Https.
  • A HTTP-t megbízható hálózatokon keresztüli csatlakozáskor használja a rendszer.

A csatlakozás lépései eltérőek, ha a Data Box Blob Storage-hoz http-en vagy https-en keresztül csatlakozik.

Csatlakozás http-en keresztül

A Data Box Blob Storage REST API-kkal http-kapcsolathoz a következő lépések szükségesek:

  • Az eszköz IP- és blobszolgáltatás-végpontjának hozzáadása a távoli gazdagéphez
  • Külső szoftver konfigurálása és a kapcsolat ellenőrzése

Ezeket a lépéseket a következő szakaszok ismertetik.

Eszköz IP-címének és blobszolgáltatás-végpontnak a hozzáadása

  1. Jelentkezzen be a Data Box-eszközre. Győződjön meg arról, hogy a zárolás feloldva van.

    Screenshot shows your dashboard with the device displayed as Unlocked.

  2. Lépjen a Hálózati adapterek beállítása elemre. Jegyezze fel az ügyfélhez való csatlakozáshoz használt hálózati adapter eszköz IP-címét.

    Screenshot shows the Network Settings where you can see the I P address.

  3. Nyissa meg a Csatlakozás, majd másolja, majd kattintson a Rest gombra.

    Screenshot shows the Connect and copy pane where you can select REST as an access setting.

  4. Az Access-Storage-fiókból és az adatok feltöltése párbeszédpanelről másolja ki a Blob Szolgáltatásvégpontot.

    Screenshot shows the Access storage account and upload data dialog box where you can copy the Blob Service Endpoint.

  5. Indítsa el a Jegyzettömb rendszergazdaként, majd nyissa meg a következő helyen található gazdagépfájltC:\Windows\System32\Drivers\etc: .

  6. Adja hozzá a következő bejegyzést a gazdagépfájlhoz : <device IP address> <Blob service endpoint>

  7. Referenciaként használja az alábbi képet. Mentse a gazdagépfájlt .

    Screenshot shows a Notepad document with the I P address and blob service endpoint added.

A kapcsolat ellenőrzése és a partnerszoftver konfigurálása

Konfigurálja a partnerszoftvert az ügyfélhez való csatlakozáshoz. A partnerszoftverhez való csatlakozáshoz általában a helyi webes felhasználói felület Csatlakozás és másolási oldaláról az előző lépésben gyűjtött alábbi információkra van szüksége (eltérő lehet):

  • Tárfiók neve
  • Hozzáférési kulcs
  • Blob-szolgáltatásvégpont

A kapcsolat sikeres létrehozásának ellenőrzéséhez használja a Storage Explorer egy külső tárfiókhoz való csatoláshoz. Ha nem rendelkezik Storage Explorer, töltse le Storage Explorer.

Ha először használja a Storage Explorer, az alábbi lépéseket kell végrehajtania.

  1. A felső parancssávon lépjen a Cél Azure Stack szerkesztése >elemre.

    Screenshot shows Target Azure Stack selected from the Edit menu.

  2. Indítsa újra a Storage Explorer a módosítások érvénybe lépéséhez.

    Screenshot shows the Restart Now button.

Kövesse az alábbi lépéseket a tárfiókhoz való csatlakozáshoz és a kapcsolat ellenőrzéséhez.

  1. Az Storage Explorer nyissa meg a Csatlakozás az Azure Storage párbeszédpanelen. Az Csatlakozás az Azure-ba Storage párbeszédpanelen válassza a Tárfiók nevének és kulcsának használata lehetőséget.

    Screenshot shows the Connect to Azure Storage dialog box with Use a storage account name and key selected.

  2. Illessze be a fióknevet és a fiókkulcsot (az 1. kulcs értéke a Csatlakozás és a másolás lapról a helyi webes felhasználói felületen). Válassza Storage végponttartományt egyébként (írja be alább), majd adja meg a blobszolgáltatás végpontját az alább látható módon. Jelölje be a HTTP használata beállítást, ha http-en keresztül történik az átvitel. Https használata esetén hagyja bejelöletlenül a beállítást. Kattintson a Tovább gombra.

    Screenshot shows the Connect with Name and Key dialog box with values entered.

  3. A Kapcsolat összegzése párbeszédpanelen tekintse át a megadott információkat. Válassza a Kapcsolódás lehetőséget.

    Screenshot shows the Connection Summary dialog box with Connect selected.

  4. A sikeresen hozzáadott fiók megjelenik a Storage Explorer bal oldali paneljén, és hozzá van fűzve a (Külső, Egyéb) névhez. Kattintson a BlobTárolók elemre a tároló megtekintéséhez.

    Screenshot shows the Explorer menu with Blob Containers selected.

Csatlakozás https-en keresztül

Az Azure Blob Storage REST API-kkal https-en keresztüli csatlakozáshoz a következő lépések szükségesek:

  • A tanúsítvány letöltése a Azure Portal
  • A tanúsítvány importálása az ügyfélen vagy távoli gazdagépen
  • Az eszköz IP- és blobszolgáltatás-végpontjának hozzáadása az ügyfélhez vagy távoli gazdagéphez
  • Külső szoftver konfigurálása és a kapcsolat ellenőrzése

Ezeket a lépéseket a következő szakaszok ismertetik.

Tanúsítvány letöltése

A tanúsítvány letöltéséhez használja a Azure Portal.

  1. Jelentkezzen be az Azure Portalra.

  2. Nyissa meg a Data Box-rendelést, és navigáljon az általános > eszközadatokhoz.

  3. Az Eszköz hitelesítő adatai területen nyissa meg az ESZKÖZ API-hozzáférését . Kattintson a Letöltés gombra. Ez a művelet letölt egy <rendelésnév.cer> tanúsítványfájlt. Mentse a fájlt. Ezt a tanúsítványt arra az ügyfélre vagy gazdaszámítógépre fogja telepíteni, amelyet az eszközhöz való csatlakozáshoz fog használni.

    Download certificate in Azure portal

Tanúsítvány importálása

A Data Box Blob Storage HTTPS-en keresztüli eléréséhez TLS-/SSL-tanúsítvány szükséges az eszközhöz. A tanúsítvány az ügyfélalkalmazás számára való elérhetővé terjesztésének módja alkalmazásonként és operációs rendszereken és disztribúciókon belül változik. Egyes alkalmazások a rendszer tanúsítványtárolójába történő importálás után hozzáférhetnek a tanúsítványhoz, míg más alkalmazások nem használják ezt a mechanizmust.

Ebben a szakaszban néhány alkalmazásra vonatkozó konkrét információkat említünk. A többi alkalmazással kapcsolatos további információkért tekintse meg az alkalmazás és a használt operációs rendszer dokumentációját.

Az alábbi lépéseket követve importálhatja a .cer fájlt egy Windows vagy Linux-ügyfél gyökértárolójába. Egy Windows rendszeren a Windows PowerShell vagy a Windows Server felhasználói felületén importálhatja és telepítheti a tanúsítványt a rendszerére.

A Windows PowerShell használata

  1. Windows PowerShell munkamenet indítása rendszergazdaként.

  2. A parancssorba írja be a következőt:

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

Windows kiszolgáló felhasználói felületének használata

  1. Kattintson a jobb gombbal a fájlra, .cer és válassza a Tanúsítvány telepítése parancsot. Ez a művelet elindítja a Tanúsítványimportáló varázslót.

  2. Áruház helyeként válassza a Helyi gép lehetőséget, majd kattintson a Tovább gombra.

    Certificate Import Wizard, Windows Server

  3. Válassza az Összes tanúsítvány elhelyezése az alábbi tárolóban lehetőséget, majd kattintson a Tallózás gombra. Keresse meg a távoli gazdagép gyökértárolóját, majd kattintson a Tovább gombra.

    Certificate Import Wizard, Certificate Store

  4. Kattintson a Finish (Befejezés) gombra. Megjelenik egy üzenet, amely arról tájékoztatja, hogy az importálás sikeres volt.

    Certificate Import Wizard, finish import

Linux-rendszer használata

A tanúsítvány importálásának módja elosztás szerint változik.

Többen, például az Ubuntu és a Debian, használják a update-ca-certificates parancsot.

  • Nevezze át a Base64 kódolású tanúsítványfájlt kiterjesztésre .crt , és másolja a /usr/local/share/ca-certificates directoryfájlba.
  • Futtassa a következő parancsot: update-ca-certificates.

Az RHEL, a Fedora és a CentOS legújabb verziói a update-ca-trust parancsot használják.

  • Másolja a tanúsítványfájlt a /etc/pki/ca-trust/source/anchors könyvtárba.
  • Futtassa az update-ca-trust parancsot.

A részletekért tekintse meg a disztribúcióra vonatkozó dokumentációt.

Eszköz IP-címének és blobszolgáltatás-végpontnak a hozzáadása

Kövesse ugyanezeket a lépéseket az eszköz IP-címének és a blobszolgáltatás végpontjának http-kapcsolaton keresztüli hozzáadásához.

Partnerszoftver konfigurálása és a kapcsolat ellenőrzése

Kövesse az alábbi lépéseket a HTTP-kapcsolaton keresztüli csatlakozáskor használt partnerszoftver konfigurálásához. Az egyetlen különbség az, hogy ne jelölje be a HTTP használata jelölőnégyzetet .

Adatok másolása a Data Boxra

Miután csatlakozott a Data Box Blob Storage-hoz, a következő lépés az adatok másolása. Az adatok másolása előtt tekintse át a következő szempontokat:

  • Adatok másolása közben győződjön meg arról, hogy az adatok mérete megfelel az Azure Storage és a Data Box korlátaival foglalkozó cikkben ismertetett méretkorlátoknak.
  • Ha a Data Box által feltöltött adatokat a Data Boxon kívüli más alkalmazások egyidejűleg töltik fel, az a feltöltési feladat meghiúsulását és az adatok sérülését eredményezheti.

Fontos

Gondoskodjon róla, hogy megtartja a forrásadatok egy másolatát addig, amíg ellenőrizheti, hogy a Data Box valóban átvitte-e az adatokat az Azure Storage-ba.

Ebben az oktatóanyagban az AzCopy használatával másolunk adatokat a Data Box Blob Storage-ba. Az adatok másolásához Azure Storage Explorer (ha inkább grafikus felhasználói felületre épülő eszközt szeretne használni) vagy egy partnerszoftvert is használhat.

A másolási eljárás lépései a következők:

  • Tároló létrehozása
  • Mappa tartalmának feltöltése a Data Box Blob Storage-ba
  • Módosított fájlok feltöltése a Data Box Blob Storage-ba

Az alábbi szakaszok részletesen ismertetik ezeket a lépéseket.

Tároló létrehozása

Az első lépés egy tároló létrehozása, mivel a blobok mindig egy tárolóba lesznek feltöltve. A tárolók úgy rendszerezik a blobok csoportjait, mint a fájlokat a számítógép mappáiban. Blobtároló létrehozásához kövesse az alábbi lépéseket.

  1. Nyissa meg a Storage Explorert.

  2. A bal oldali panelen bontsa ki azt a tárfiókot, amelyben létre szeretné hozni a blobtárolót.

  3. Kattintson a jobb gombbal a Blobtárolók elemre, majd a helyi menüben válassza a Blobtároló létrehozása lehetőséget.

    Blob Containers context menu, Create Blob Container

  4. A Blobtárolók mappa alatt megjelenik egy szövegmező. Adja meg a blobtároló nevét. A blobtárolók elnevezésére vonatkozó szabályokkal és korlátozásokkal kapcsolatos információkért tekintse meg a tároló létrehozását és az engedélyek beállítását ismertető témakört.

  5. Amikor elkészült, nyomja le az Enter billentyűt a blobtároló létrehozásához, vagy az Esc billentyűt a megszakításhoz. A blobtároló sikeres létrehozása után megjelenik a kiválasztott tárfiók Blobtárolók mappájában.

    Blob container created

Mappa tartalmának feltöltése a Data Box Blob Storage-ba

Az AzCopyval feltöltheti egy mappában lévő összes fájlt a Blob Storage-ba Windows vagy Linux rendszeren. Egy mappa összes blobjának feltöltéséhez írja be a következő AzCopy-parancsot:

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

Cserélje le <key> a fiókkulcsot. A fiókkulcs beszerzéséhez nyissa meg a tárfiókot a Azure Portal. Nyissa meg Gépház > Hozzáférési kulcsokat, válasszon ki egy kulcsot, és illessze be az AzCopy parancsba.

Ha a célként megadott tároló nem létezik, az AzCopy létrehozza, majd feltölti a fájlt a tárolóba. Frissítse az adatkönyvtár forráselérési útját, és cserélje le data-box-storage-account-name a cél URL-címét a Data Boxhoz társított tárfiók nevére.

A megadott könyvtár tartalmának a Blob Storage-ba való rekurzív feltöltéséhez adja meg a --recursive (Linux) vagy az /S (Windows) beállítást. Ha az AzCopyt ezen beállítások egyikével futtatja, minden almappa és a bennük tárolt fájlok is feltöltődnek.

Módosított fájlok feltöltése a Data Box Blob Storage-ba

Az AzCopy használatával feltölthet fájlokat az utolsó módosítás időpontja alapján. Ha szeretné kipróbálni ezt a funkciót, tesztelési céllal módosítson vagy hozzon létre fájlokat a forráskönyvtárban. Ha csak a frissített vagy új fájlokat szeretné feltölteni, adja hozzá az --exclude-older (Linux) vagy az /XO (Windows) paramétert az AzCopy-parancshoz.

Ha csak azokat az erőforrásokat szeretné átmásolni a forrásból, amelyek nem léteznek a célhelyen, adja meg az --exclude-older és az --exclude-newer (Linux), vagy az /XO és az /XN (Windows) paramétereket az AzCopy-parancsban. Az AzCopy az időbélyegek alapján csak a frissített adatokat tölti fel.

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 \
--exclude-older

Windows

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

Ha a kapcsolódási vagy másolási művelet során hibák merülnek fel, tekintse meg a Data Box Blob Storage-tal kapcsolatos hibák elhárítását.

A következő lépés az eszköz szállításra való előkészítése.

Következő lépések

Ebben az oktatóanyagban az Azure Data Box témaköréből ismerhette meg a következőket:

  • Előfeltételek
  • Csatlakozás a Data Box Blob Storage-ba http vagy https használatával
  • Adatok másolása a Data Boxra

Folytassa a következő oktatóanyaggal, amelyben megismerheti, hogyan küldheti vissza a Data Boxot a Microsoftnak.