Bevezetés az AzCopy használatába

  • Cikk
  • 5 perc alatt elolvasható

Az AzCopy egy parancssori segédprogram, amellyel blobokat és fájlokat másolhat a tárfiókok között. Ez a cikk segítséget nyújt az AzCopy letöltésében, a tárfiókhoz való csatlakozásban, majd az adatok átvitelében.

Megjegyzés

Az AzCopy V10 az AzCopy jelenleg támogatott verziója.

Ha az AzCopy egy korábbi verzióját kell használnia, olvassa el a jelen cikk AzCopy előző verziójának használata című szakaszát.

Az AzCopy letöltése

Először töltse le az AzCopy V10 végrehajtható fájlt a számítógép bármely könyvtárába. Az AzCopy V10 csak egy végrehajtható fájl, így nincs mit telepíteni.

Ezek a fájlok zip-fájlként (Windows és Mac) vagy tar fájlként (Linux) vannak tömörítve. A kátrányfájl linuxos letöltéséhez és kibontásához tekintse meg a Linux-disztribúció dokumentációját.

Az AzCopy-kiadásokkal kapcsolatos részletes információkért tekintse meg az AzCopy kiadási oldalát.

Megjegyzés

Ha adatokat szeretne másolni az Azure Table Storage szolgáltatásba és onnan, telepítse az AzCopy 7.3-at.

Az AzCopy futtatása

Az egyszerű használat érdekében érdemes lehet hozzáadni az AzCopy végrehajtható fájljának helyét a rendszer elérési útjához. Így a rendszer bármely könyvtárából gépelhet azcopy .

Ha úgy dönt, hogy nem adja hozzá az AzCopy-könyvtárat az elérési úthoz, módosítania kell a könyvtárakat az AzCopy végrehajtható fájljának helyére, és be kell gépelnie vagy .\azcopy Windows PowerShell parancssorba kell beírniaazcopy.

Az Azure Storage-fiókja tulajdonosaként nem kap automatikusan engedélyeket az adatok eléréséhez. Mielőtt bármi értelmeset tudna tenni az AzCopyval, el kell döntenie, hogyan adja meg az engedélyezési hitelesítő adatokat a tárolási szolgáltatásnak.

Az AzCopy engedélyezése

Hitelesítési hitelesítő adatokat Azure Active Directory (AD) vagy közös hozzáférésű jogosultságkód (SAS) jogkivonat használatával adhat meg.

Használja ezt a táblázatot útmutatóként:

Tárolási típus Jelenleg támogatott engedélyezési módszer
Blob Storage & SAS Azure AD
Blob Storage (hierarchikus névtér) & SAS Azure AD
File Storage Csak SAS

1. lehetőség: A Azure Active Directory használata

Ez a lehetőség csak blob Storage érhető el. A Azure Active Directory használatával egyszer adhat meg hitelesítő adatokat ahelyett, hogy minden parancshoz hozzá kellene fűznie egy SAS-jogkivonatot.

2. lehetőség: SAS-jogkivonat használata

Az AzCopy-parancsokban használt minden forrás- vagy cél URL-címhez hozzáfűzhet egy SAS-jogkivonatot.

Ez a példaparancs rekurzív módon másol adatokat egy helyi könyvtárból egy blobtárolóba. A rendszer egy fiktív SAS-jogkivonatot fűz a tároló URL-címének végéhez.

azcopy copy "C:\local\path" "https://account.blob.core.windows.net/mycontainer1/?sv=2018-03-28&ss=bjqt&srt=sco&sp=rwddgcup&se=2019-05-01T05:01:17Z&st=2019-04-30T21:01:17Z&spr=https&sig=MGCXiyEzbtttkr3ewJIh2AR8KrghSy1DGM9ovN734bQF4%3D" --recursive=true

Az SAS-jogkivonatokról és azok beszerzéséről további információt a Közös hozzáférésű jogosultságkódok (SAS) használata című témakörben talál.

Megjegyzés

A tárfiók biztonságos átvitelhez szükséges beállítása határozza meg, hogy a tárfiókhoz való csatlakozást a Transport Layer Security (TLS) védi-e. Alapértelmezés szerint ez a beállítás engedélyezett.

Adatátvitel

Miután engedélyezte az identitását, vagy beszerezte az SAS-jogkivonatot, megkezdheti az adatok átvitelét.

Példaparancsok kereséséhez tekintse meg az alábbi cikkek bármelyikét.

Szolgáltatás Cikk
Azure Blob Storage Fájlok feltöltése az Azure Blob Storage-ba
Azure Blob Storage Blobok letöltése Azure Blob Storage
Azure Blob Storage Blobok másolása Azure-tárfiókok között
Azure Blob Storage Szinkronizálás az Azure Blob Storage használatával
Azure Files Adatok átvitele az AzCopy használatával és fájltárolás
Amazon S3 Adatok másolása az Amazon S3-ból az Azure Storage
Google Cloud Storage Adatok másolása a Google Cloud Storage-ból az Azure Storage-be (előzetes verzió)
Azure Stack Storage Adatok átvitele az AzCopy és az Azure Stack Storage használatával

Parancs súgójának lekérése

A parancsok listájának megtekintéséhez írja be azcopy -h , majd nyomja le az ENTER billentyűt.

Egy adott parancs megismeréséhez egyszerűen adja meg a parancs nevét (például: azcopy list -h).

Inline help

Parancsok listája

Az alábbi táblázat felsorolja az összes AzCopy v10-parancsot. Minden parancs hivatkozási cikkre hivatkozik.

Parancs Leírás
azcopy bench Teljesítménytesztet futtat, ha tesztadatokat tölt fel vagy tölt le egy megadott helyre vagy onnan.
azcopy copy Forrásadatok másolása célhelyre
azcopy doc Létrehozza az eszköz dokumentációját Markdown formátumban.
azcopy env Megjeleníti azOkat a környezeti változókat, amelyek konfigurálhatják az AzCopy viselkedését.
azcopy jobs Feladatok kezelésével kapcsolatos alparancsok.
azcopy jobs clean Távolítsa el az összes feladat összes napló- és tervfájljait.
azcopy jobs list Az összes feladat adatait jeleníti meg.
azcopy jobs remove Távolítsa el a megadott feladatazonosítóhoz társított összes fájlt.
azcopy jobs resume Folytatja a meglévő feladatot a megadott feladatazonosítóval.
azcopy jobs show A megadott feladatazonosító részletes adatait jeleníti meg.
azcopy jobs Feladatok kezelésével kapcsolatos alparancsok.
azcopy list Egy adott erőforrás entitásainak felsorolása.
azcopy login Bejelentkezik a Azure Active Directory az Azure Storage-erőforrások eléréséhez.
azcopy bejelentkezési állapota Egy adott erőforrás entitásainak felsorolása.
azcopy logout Kijelentkezteti a felhasználót, és leállítja az Azure Storage-erőforrásokhoz való hozzáférést.
azcopy make Tárolót vagy fájlmegosztást hoz létre.
azcopy remove Blobok vagy fájlok törlése azure-tárfiókból.
azcopy sync Replikálja a forráshelyet a célhelyre.

Megjegyzés

Az AzCopy nem rendelkezik a fájlok átnevezésére használható paranccsal.

Használat szkriptben

Idővel az AzCopy letöltési hivatkozása az AzCopy új verzióira mutat. Ha a szkript letölti az AzCopyt, előfordulhat, hogy a szkript működése leáll, ha az AzCopy újabb verziója módosítja a szkript által kínált funkciókat.

A problémák elkerülése érdekében szerezzen be egy statikus (változatlan) hivatkozást az AzCopy aktuális verziójára. Így a szkript minden futtatáskor ugyanazt az AzCopy-verziót tölti le.

A hivatkozás beszerzéséhez futtassa az alábbi parancsot:

Operációs rendszer Parancs
Linux curl -s -D- https://aka.ms/downloadazcopy-v10-linux | grep ^Location
Windows (PowerShell Core 7) (Invoke-WebRequest https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction silentlycontinue -SkipHttpErrorCheck).headers.location[0]
Windows (PowerShell 5.1) (Invoke-WebRequest https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction silentlycontinue ).headers.location

Megjegyzés

Linux --strip-components=1 esetén a parancs eltávolítja a tar verziónevet tartalmazó legfelső szintű mappát, és ehelyett közvetlenül az aktuális mappába csomagolja ki a bináris fájlt. Ez lehetővé teszi, hogy a szkript csak az URL-cím frissítésével frissüljön egy wget új verzióvalazcopy.

Az URL-cím megjelenik a parancs kimenetében. A szkript ezután az URL-cím használatával letöltheti az AzCopyt.

Operációs rendszer Parancs
Linux wget -O azcopy_v10.tar.gz https://aka.ms/downloadazcopy-v10-linux && tar -xf azcopy_v10.tar.gz --strip-components=1
Windows Invoke-WebRequest https://azcopyvnext.azureedge.net/release20190517/azcopy_windows_amd64_10.1.2.zip -OutFile azcopyv10.zip <<Unzip here>>

Speciális karakterek feloldása SAS-jogkivonatokban

A kiterjesztéssel rendelkező .cmd kötegelt fájlokban meg kell szabadulnia az % SAS-jogkivonatokban megjelenő karakterek elől. Ezt úgy teheti meg, hogy egy további % karaktert ad hozzá a meglévő % karakterek mellé az SAS-jogkivonat sztringjében.

Szkriptek futtatása a Jenkins használatával

Ha a Jenkinst használja szkriptek futtatására, mindenképpen helyezze a következő parancsot a szkript elejére.

/usr/bin/keyctl new_session

Használat Azure Storage Explorer

Storage Explorer az AzCopy használatával hajtja végre az összes adatátviteli műveletet. A Storage Explorer akkor használhatja, ha ki szeretné használni az AzCopy teljesítménybeli előnyeit, de inkább grafikus felhasználói felületet használ, mint a parancssort a fájlok használatához.

Storage Explorer a fiókkulcsot használja a műveletek végrehajtásához, így a Storage Explorer való bejelentkezés után nem kell további hitelesítési hitelesítő adatokat megadnia.

Konfigurálás, optimalizálás és javítás

Tekintse meg az alábbi források bármelyikét:

Előző verzió használata

Ha az AzCopy előző verzióját kell használnia, tekintse meg az alábbi hivatkozások egyikét:

Következő lépések

Ha kérdése, problémája vagy általános visszajelzése van, küldje el őket GitHub oldalon.