Použití kontejnerů Dockeru v odpojených prostředích

Článek
07/29/2023

Kontejnery umožňují spouštět rozhraní API služeb Azure AI ve vašem vlastním prostředí a jsou skvělé pro vaše specifické požadavky na zabezpečení a zásady správného řízení dat. Odpojené kontejnery umožňují používat několik z těchto rozhraní API odpojených od internetu. V současné době je možné tímto způsobem spouštět následující kontejnery:

Před pokusem o spuštění kontejneru Dockeru v offline prostředí se ujistěte, že znáte kroky pro úspěšné stažení a použití kontejneru. Příklad:

Požadavky na hostitelský počítač a doporučení
Příkaz Dockeru pull , který použijete ke stažení kontejneru.
Jak ověřit, jestli je kontejner spuštěný.
Postup odesílání dotazů do koncového bodu kontejneru po jeho spuštění

Žádost o přístup k používání kontejnerů v odpojených prostředích

Vyplňte a odešlete formulář žádosti o přístup ke kontejnerům odpojeným od internetu.

Formulář požaduje informace o vás, vaší společnosti a uživatelském scénáři, pro který kontejner použijete. Po odeslání formuláře ho tým služeb Azure AI zkontroluje a do 10 pracovních dnů vám pošle e-mail s rozhodnutím.

Důležité

Ve formuláři musíte použít e-mailovou adresu přidruženou k ID předplatného Azure.
Prostředek Azure, který použijete ke spuštění kontejneru, musí být vytvořený se schváleným ID předplatného Azure.
Zkontrolujte, jestli v e-mailu (ve složce Doručená pošta i ve složce s nevyžádanou poštou) nejsou aktuální informace o stavu vaší aplikace od Microsoftu.

Po schválení budete moct kontejner spustit po jeho stažení ze služby Microsoft Container Registry (MCR), jak je popsáno dále v tomto článku.

Pokud vaše předplatné Azure není schválené, nebudete moct kontejner spustit.

Přístup je omezený na zákazníky, kteří splňují následující požadavky:

Vaše organizace by měla být identifikována jako strategický zákazník nebo partner Microsoftu.
Očekává se, že odpojené kontejnery budou plně offline, proto vaše případy použití musí splňovat jeden z následujících nebo podobných požadavků:
- Prostředí nebo zařízení s nulovým připojením k internetu
- Vzdálené umístění, které má občas přístup k internetu.
- Organizace pod přísnými předpisy neodesílají žádný druh dat zpět do cloudu.
Žádost se dokončila podle pokynů – Věnujte prosím zvýšenou pozornost pokynům v celé aplikaci, abyste měli jistotu, že poskytnete všechny potřebné informace potřebné ke schválení.

Nákup plánu závazku pro použití kontejnerů v odpojených prostředích

Vytvoření nového prostředku

Přihlaste se k Azure Portal a vyberte Vytvořit nový prostředek pro některou z příslušných služeb Azure AI nebo služeb Azure AI uvedených výše.
Zadejte příslušné informace pro vytvoření prostředku. Nezapomeňte jako cenovou úroveň vybrat odpojené kontejnery úrovně závazku .
Poznámka
- Možnost zakoupení úrovně závazku se zobrazí jenom v případě, že jste byli schváleni Microsoftem.
- Podrobnosti o cenách jsou například pouze.
V dolní části stránky vyberte Zkontrolovat a vytvořit . Zkontrolujte informace a vyberte Vytvořit.

Konfigurace kontejneru pro odpojené využití

Postup stažení a konfigurace kontejneru pro odpojené využití najdete v následující dokumentaci:

Služba Speech

Služba jazyka

Názvy proměnných prostředí v nasazeních Kubernetes

Některé kontejnery Azure AI, například Translator, vyžadují, aby uživatelé při spuštění kontejneru předali názvy proměnných prostředí, které obsahují dvojtečky (:). Při použití Dockeru to bude fungovat správně, ale Kubernetes nepřijímá dvojtečky v názvech proměnných prostředí. Tento problém vyřešíte tak, že při nasazování do Kubernetes nahradíte dvojtečky dvojitými podtržítky (__). Projděte si následující příklad přijatelného formátu názvů proměnných prostředí:

        env:  
        - name: Mounts__License
          value: "/license"
        - name: Mounts__Output
          value: "/output"

Tento příklad nahradí výchozí formát názvů Mounts:License proměnných prostředí a Mounts:Output v příkazu docker run.

Aktualizace imagí kontejneru a licencí

Soubory licencí kontejneru se používají jako klíče k dešifrování určitých souborů v každé imagi kontejneru. Pokud se tyto šifrované soubory aktualizují v nové imagi kontejneru, může se stát, že se vám nepodaří spustit soubor s licencí kontejneru, i když fungoval s předchozí verzí image kontejneru. Pokud se chcete tomuto problému vyhnout, doporučujeme po načtení nových verzí imagí z mcr.microsoft.com stáhnout nový licenční soubor z koncového bodu prostředku pro váš kontejner, který je k dispozici v Azure Portal.

Pokud si chcete stáhnout nový soubor licence, můžete do příkazu docker run přidat DownloadLicense=True společně s připojením licence, klíčem rozhraní API a koncovým bodem fakturace. Podrobné pokyny najdete v dokumentaci ke kontejneru .

Záznamy o využití

Při provozu kontejnerů Dockeru v odpojených prostředích bude kontejner zapisovat záznamy o využití na svazek, kde se v průběhu času shromažďují. Můžete také volat koncový bod REST a vygenerovat sestavu o využití služby.

Argumenty pro ukládání protokolů

Při spuštění v odpojené prostředí musí být pro kontejner k dispozici výstupní připojení pro ukládání protokolů využití. V následujícím příkladu byste například zahrnuli -v /host/output:{OUTPUT_PATH} a Mounts:Output={OUTPUT_PATH} a nahraďte {OUTPUT_PATH} cestou, kde se budou protokoly ukládat:

docker run -v /host/output:{OUTPUT_PATH} ... <image> ... Mounts:Output={OUTPUT_PATH}

Získání záznamů pomocí koncových bodů kontejneru

Kontejner poskytuje dva koncové body pro vrácení záznamů o jeho využití.

Získání všech záznamů

Následující koncový bod poskytne sestavu se souhrnem veškerého využití shromážděného v připojeném adresáři fakturačních záznamů.

https://<service>/records/usage-logs/

Vrátí json podobný příkladu níže.

{
  "apiType": "noop",
  "serviceName": "noop",
  "meters": [
    {
      "name": "Sample.Meter",
      "quantity": 253
    }
  ]
}

Získání záznamů pro konkrétní měsíc

Následující koncový bod poskytne sestavu se souhrnem využití za konkrétní měsíc a rok.

https://<service>/records/usage-logs/{MONTH}/{YEAR}

Vrátí odpověď JSON podobnou následujícímu příkladu:

{
  "apiType": "string",
  "serviceName": "string",
  "meters": [
    {
      "name": "string",
      "quantity": 253
    }
  ]
}

Nákup jiného plánu závazku pro odpojené kontejnery

Plány závazků pro odpojené kontejnery mají období závazku kalendářního roku. Když si koupíte plán, bude vám okamžitě naúčtována plná cena. Během období závazku nemůžete svůj plán závazku změnit, ale můžete si zakoupit další jednotky za poměrnou cenu za zbývající dny v roce. K ukončení plánu závazku máte čas do půlnoci (UTC) posledního dne vašeho závazku.

Jiný plán závazku můžete zvolit v nastavení cenových úrovní závazku vašeho prostředku.

Ukončení plánu závazku

Pokud se rozhodnete, že nechcete pokračovat v nákupu plánu závazku, můžete automatické prodlužování platnosti prostředku nastavit na Neprodlužovat automatické prodlužování platnosti. Platnost vašeho plánu závazku vyprší k zobrazenému koncovému datu závazku. Po tomto datu se vám za plán závazku nebudou účtovat poplatky. K volání rozhraní API budete moct dál používat prostředek Azure, který se bude účtovat podle cen průběžných plateb. Na ukončení plánu závazku pro odpojené kontejnery máte do půlnoci (UTC) posledního dne roku a neúčtujte se za následující rok.

Poradce při potížích

Pokud kontejner spustíte s povoleným výstupním připojením a protokolováním, vygeneruje soubory protokolů, které jsou užitečné při řešení problémů, ke kterým dochází při spouštění nebo spouštění kontejneru.

Tip

Další informace a doprovodné materiály k řešení potíží najdete v tématu Nejčastější dotazy k odpojeným kontejnerům.

Další kroky

Přehled kontejnerů Azure AI