Začínáme s nástrojem AzCopy

  • Článek
  • 5 min ke čtení

AzCopy je nástroj příkazového řádku, pomocí kterého můžete kopírovat objekty blob nebo soubory do nebo z účtu úložiště. Tento článek vám pomůže se stažením nástroje AzCopy, připojením k vašemu účtu úložiště a následným přenosem souborů.

Poznámka

AzCopy V10 je aktuálně podporovaná verze AzCopy.

Pokud potřebujete použít předchozí verzi AzCopy, podívejte se na část Použití předchozí verze AzCopy tohoto článku.

Stáhnout AzCopy

Nejprve stáhněte spustitelný soubor AzCopy V10 do libovolného adresáře ve vašem počítači. AzCopy V10 je pouze spustitelný soubor, takže není nic k instalaci.

Tyto soubory jsou komprimované jako soubor ZIP (Windows a Mac) nebo soubor tar (Linux). Pokud chcete stáhnout a dekomprimovat soubor tar v Linuxu, prohlédněte si dokumentaci pro vaši linuxovou distribuci.

Poznámka

Pokud chcete kopírovat data do a ze služby Azure Table Storage, nainstalujte AzCopy verze 7.3.

Spuštění nástroje AzCopy

Pro usnadnění práce zvažte přidání umístění adresáře spustitelného souboru AzCopy do systémové cesty. Tímto způsobem můžete zadat azcopy z libovolného adresáře ve vašem systému.

Pokud se rozhodnete nepřidat adresář AzCopy do své cesty, budete muset změnit adresáře na umístění spustitelného souboru AzCopy a zadat nebo Windows PowerShell azcopy .\azcopy příkazového řádku.

Jako vlastník vašeho účtu Azure Storage nemáte automaticky přiřazená oprávnění pro přístup k datům. Než pomocí AzCopy začnete dělat něco smysluplného, musíte se rozhodnout, jak do služby úložiště zadáte přihlašovací údaje pro autorizaci.

Autorizace AzCopy

Přihlašovací údaje pro autorizaci můžete zadat Azure Active Directory (AD) nebo pomocí tokenu sdíleného přístupového podpisu (SAS).

Jako vodítko použijte tuto tabulku:

Typ úložiště Aktuálně podporovaná metoda autorizace
Blob Storage Azure AD a SAS
Blob Storage (hierarchický obor názvů) Azure AD a SAS
File Storage Pouze SAS

Možnost 1: Použití Azure Active Directory

Tato možnost je dostupná jenom pro Storage objektů blob. Pomocí Azure Active Directory můžete zadat přihlašovací údaje jednou místo toho, abyste ke každému příkazu museli připojovat token SAS.

Poznámka

Pokud máte v aktuální verzi v plánu kopírovat objekty blob mezi účty úložiště, budete muset ke každé adrese URL zdroje připojit token SAS. Token SAS můžete vynechat pouze z cílové adresy URL. Příklady najdete v tématu Kopírování objektů blob mezi účty úložiště.

Informace o autorizaci přístupu pomocí Azure AD najdete v tématu Autorizace přístupu k objektům blob pomocí AzCopy a Azure Active Directory (Azure AD).

Možnost 2: Použití tokenu SAS

Token SAS můžete připojit ke každé zdrojové nebo cílové adrese URL, která se používá v příkazech AzCopy.

Tento příklad příkazu rekurzivně kopíruje data z místního adresáře do kontejneru objektů blob. Na konec adresy URL kontejneru se připojí fiktivní token SAS.

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

Další informace o tokenech SAS a o tom, jak je získat, najdete v tématu Použití sdílených přístupových podpisů (SAS).

Poznámka

Nastavení Požadováno zabezpečený přenos účtu úložiště určuje, jestli je připojení k účtu úložiště zabezpečené protokolem TLS (Transport Layer Security). Standardně je toto nastavení povolené.

Přenos dat

Jakmile svou identitu autorizování nebo získá token SAS, můžete začít přenášet data.

Příklady příkazů najdete v těchto článcích.

Služba Článek
Azure Blob Storage Nahrání souborů do služby Azure Blob Storage
Azure Blob Storage Stažení objektů blob z Azure Blob Storage
Azure Blob Storage Kopírování objektů blob mezi účty úložiště Azure
Azure Blob Storage Synchronizace se službou Azure Blob Storage
Azure Files Přenos dat s použitím AzCopy a úložiště souborů
Amazon S3 Kopírování dat z Amazonu S3 do Azure Storage
Cloudové úložiště Googlu Kopírování dat z Google Cloud Storage do Azure Storage (Preview)
Azure Stack úložiště Přenos dat pomocí AzCopy a Azure Stack úložiště

Získání nápovědy k příkazům

Pokud chcete zobrazit seznam příkazů, zadejte a azcopy -h stiskněte klávesu ENTER.

Pokud chcete získat informace o konkrétním příkazu, stačí zahrnovat název příkazu azcopy list -h (například: ).

Vložené nápovědy

Seznam příkazů

Následující tabulka uvádí všechny příkazy AzCopy v10. Každý příkaz odkazuje na referenční článek.

Příkaz Popis
azcopy bench Spustí srovnávací test výkonu tím, že nahraje nebo stáhne testovací data do zadaného umístění nebo z tohoto umístění.
azcopy copy Zkopíruje zdrojová data do cílového umístění.
azcopy doc Vygeneruje dokumentaci pro nástroj ve formátu Markdown.
azcopy env Zobrazuje proměnné prostředí, které mohou nakonfigurovat chování nástroje AzCopy.
azcopy jobs Dílčí příkazy související se správou úloh
azcopy jobs clean Odeberte všechny soubory protokolů a plánování pro všechny úlohy.
azcopy jobs list Zobrazí informace o všech úlohách.
azcopy jobs remove Odeberte všechny soubory přidružené k danému ID úlohy.
azcopy jobs resume Obnoví existující úlohu s daným ID úlohy.
azcopy jobs show Zobrazí podrobné informace o daném ID úlohy.
azcopy load Dílčí příkazy související s přenosem dat v určitých formátech
azcopy load clfs Přenese místní data do kontejneru a uloží je ve formátu Avere Cloud FileSystem (CLFS) společnosti Microsoft.
azcopy list Vypíše entity v daném prostředku.
azcopy login Přihlásí se k Azure Active Directory přístup k Azure Storage prostředkům.
azcopy logout Odhlásí uživatele a ukončí přístup k Azure Storage prostředkům.
azcopy make Vytvoří kontejner nebo sdílená složku.
azcopy remove Odstraňte objekty blob nebo soubory z účtu úložiště Azure.
azcopy sync Replikuje zdrojové umístění do cílového umístění.

Poznámka

AzCopy nemá příkaz k přejmenování souborů.

Použití ve skriptu

V průběhu času bude odkaz azCopy ke stažení odkazovat na nové verze AzCopy. Pokud váš skript stáhne AzCopy, může tento skript přestat fungovat, pokud novější verze AzCopy upraví funkce, na které váš skript závisí.

Pokud se chcete těmto problémům vyhnout, získejte statický (neměnný) odkaz na aktuální verzi AzCopy. Tímto způsobem váš skript při každém spuštění stáhne stejnou přesnou verzi nástroje AzCopy.

Pokud chcete odkaz získat, spusťte tento příkaz:

Operační systém Příkaz
Linux curl -s -D- https://aka.ms/downloadazcopy-v10-linux | grep ^Location
Windows (curl https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction silentlycontinue).headers.location

Poznámka

V Linuxu příkaz odebere složku nejvyšší úrovně, která obsahuje název verze, a místo toho extrahuje binární soubor --strip-components=1 tar přímo do aktuální složky. To umožňuje, aby se skript aktualizoval novou verzí , a to azcopy jenom aktualizací adresy wget URL.

Adresa URL se zobrazí ve výstupu tohoto příkazu. Váš skript pak může stáhnout AzCopy pomocí této adresy URL.

Operační systém Příkaz
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>>

Řídicí speciální znaky v tokenech SAS

V dávkových souborech, které mají příponu , budete muset řídicí znaky, které se .cmd % zobrazují v tokenech SAS. Můžete to udělat přidáním dalšího % znaku vedle existujících % znaků v řetězci tokenu SAS.

Spouštění skriptů pomocí Jenkinse

Pokud chcete ke spouštění skriptů použít Jenkinse, nezapomeňte na začátek skriptu umístit následující příkaz.

/usr/bin/keyctl new_session

Použití v Průzkumník služby Azure Storage

Průzkumník služby Storage k provádění všech svých operací přenosu dat používá AzCopy. Pokud chcete Průzkumník služby Storage azcopy, ale dáváte přednost grafickému uživatelskému rozhraní místo příkazového řádku k interakci se soubory, můžete použít grafické uživatelské rozhraní.

Průzkumník služby Storage k provádění operací použijete klíč účtu, takže po přihlášení Průzkumník služby Storage už nebudete muset zadáte další přihlašovací údaje pro autorizaci.

Konfigurace, optimalizace a oprava

Prohlédněte si některý z následujících zdrojů informací:

Použití předchozí verze

Pokud potřebujete použít předchozí verzi Nástroje AzCopy, podívejte se na některý z následujících odkazů:

Další kroky

Pokud máte dotazy, problémy nebo obecnou zpětnou vazbu, odešlete je GitHub stránce.