Bevezetés az AzCopy használatába

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 cikk AzCopy előző verziójának használata című szakaszát.

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, ezért 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-címtá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 azcopy vagy .\azcopy Windows PowerShell parancssorba.

Az Azure Storage-fiók tulajdonosaként a rendszer nem rendeli hozzá automatikusan az adatokhoz való hozzáféréshez szükséges engedélyeket. Mielőtt bármi értelmeset meg tud tenni az AzCopyval, el kell döntenie, hogyan adja meg az engedélyezési hitelesítő adatokat a tárolási szolgáltatásnak.

AzCopy engedélyezése

Az engedélyezési hitelesítő adatokat az Azure Active Directory (AD) vagy a közös hozzáférésű jogosultságkód (SAS) jogkivonat használatával adhatja 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 & AZURE AD SAS
Blob Storage (hierarchikus névtér) & AZURE AD SAS
File Storage Csak SAS

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

Ez a beállítás csak a Blob Storage-hoz érhető el. Az Azure Active Directory használatával egyszer adhat meg hitelesítő adatokat, ahelyett, hogy sas-jogkivonatot kellene hozzáfűznie az egyes parancsokhoz.

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

Sas-jogkivonatot fűzhet az AzCopy-parancsokban használt forrás- vagy cél URL-címekhez.

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

Ha többet szeretne megtudni az SAS-jogkivonatokról és azok beszerzéséről, tekintse meg a közös hozzáférésű jogosultságkódok (SAS) használatát ismertető cikket.

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) biztosítja-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.

A példaparancsok megtekinté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-ba
Google Cloud Storage Adatok másolása a Google Cloud Storage-ból az Azure Storage-ba (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 a parancsot 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).

Beágyazott súgó

Parancsok listája

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

Parancs Leírás
azcopy bench Teljesítménymutatót futtat úgy, hogy feltölti vagy letölti a tesztadatokat 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 feladathoz tartozó összes napló- és tervfájlt.
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 list Egy adott erőforrás entitásainak listája.
azcopy login Bejelentkezik az Azure Active Directoryba az Azure Storage-erőforrások eléréséhez.
azcopy bejelentkezési állapota Egy adott erőforrás entitásainak listája.
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 egy Azure Storage-fiókból.
azcopy sync Replikálja a forráshelyet a célhelyre.
azcopy set-properties Módosítsa egy vagy több blob hozzáférési szintjét, és cserélje le (felülírja) egy vagy több blob metaadatait és indexcímkéit.

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 nem működik, ha az AzCopy újabb verziója módosítja azokat a funkciókat, amelyektől a szkript függ.

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 a következő parancsot:

Operációs rendszer Parancs
Linux curl -s -D- https://aka.ms/downloadazcopy-v10-linux \| grep ^Location
Windows PowerShell (Invoke-WebRequest -Uri https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction SilentlyContinue).headers.location
PowerShell 6.1+ (Invoke-WebRequest -Uri https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction SilentlyContinue -SkipHttpErrorCheck).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 a bináris fájlt közvetlenül az aktuális mappába nyeri ki. Ez lehetővé teszi, hogy a szkript csak az wget URL-cím frissítésével frissüljön egy ú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.

Linux

wget -O azcopy_v10.tar.gz https://aka.ms/downloadazcopy-v10-linux && tar -xf azcopy_v10.tar.gz --strip-components=1

Windows PowerShell

Invoke-WebRequest -Uri 'https://azcopyvnext.azureedge.net/release20220315/azcopy_windows_amd64_10.14.1.zip' -OutFile 'azcopyv10.zip'
Expand-archive -Path '.\azcopyv10.zip' -Destinationpath '.\'
$AzCopy = (Get-ChildItem -path '.\' -Recurse -File -Filter 'azcopy.exe').FullName
# Invoke AzCopy 
& $AzCopy

PowerShell 6.1+

Invoke-WebRequest -Uri 'https://azcopyvnext.azureedge.net/release20220315/azcopy_windows_amd64_10.14.1.zip' -OutFile 'azcopyv10.zip'
$AzCopy = (Expand-archive -Path '.\azcopyv10.zip' -Destinationpath '.\' -PassThru | where-object {$_.Name -eq 'azcopy.exe'}).FullName
# Invoke AzCopy
& $AzCopy

Speciális karakterek feloldása SAS-jogkivonatokban

A bővítményt .cmd tartalmazó kötegelt fájlokban meg kell szabadulnia az % SAS-jogkivonatokban megjelenő karakterek elől. Ezt úgy teheti meg, hogy hozzáad egy további % karaktert az SAS-jogkivonat-sztring meglévő % karakterei mellé.

Szkriptek futtatása a Jenkins használatával

Ha a Jenkinst szeretné használni a szkriptek futtatásához, 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 az AzCopy teljesítményelőnyeit szeretné alkalmazni, de inkább grafikus felhasználói felületet szeretne használni a parancssor helyett 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 erőforrások bármelyikét:

Korábbi verzió használata (elavult)

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

Megjegyzés

Ezek az AzCopy-verziók elavultak. A Microsoft az AzCopy 10-et javasolja.

Következő lépések

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