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.
- Windows 64 bites (zip)
- Windows 32 bites (zip)
- Linux x86-64 (tar)
- Linux ARM64 előzetes verzió (tar)
- macOS (zip)
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).
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
Statikus letöltési hivatkozás beszerzése
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.