Docker-containers gebruiken in niet-verbonden omgevingen

Artikel
10/31/2024

Met containers kunt u API's voor Azure AI-services uitvoeren in uw eigen omgeving en zijn ze ideaal voor uw specifieke vereisten voor beveiliging en gegevensbeheer. Met niet-verbonden containers kunt u verschillende van deze API's gebruiken die zijn losgekoppeld van internet. Op dit moment kunnen de volgende containers op deze manier worden uitgevoerd:

Voordat u probeert een Docker-container uit te voeren in een offlineomgeving, moet u weten welke stappen u moet uitvoeren om de container te downloaden en te gebruiken. Voorbeeld:

Vereisten en aanbevelingen voor hostcomputers.
De Docker-opdracht pull die u gebruikt om de container te downloaden.
Controleren of een container wordt uitgevoerd.
Query's verzenden naar het eindpunt van de container zodra deze wordt uitgevoerd.

Toegang aanvragen voor het gebruik van containers in niet-verbonden omgevingen

Vul het aanvraagformulier in en verzend het om toegang tot de containers die zijn losgekoppeld van internet.

Het formulier vraagt informatie over u, uw bedrijf en het gebruikersscenario waarvoor u de container gaat gebruiken. Nadat u het formulier hebt verzonden, beoordeelt het Azure AI-servicesteam het en stuurt het u binnen 10 werkdagen een beslissing.

Belangrijk

In het formulier moet u een e-mailadres gebruiken dat is gekoppeld aan een Azure-abonnements-id.
De Azure-resource die u gebruikt om de container uit te voeren, moet zijn gemaakt met de goedgekeurde Azure-abonnements-id.
Controleer uw e-mail (zowel Postvak IN als ongewenste mappen) op updates over de status van uw toepassing van Microsoft.

Nadat u bent goedgekeurd, kunt u de container uitvoeren nadat u deze hebt gedownload uit Microsoft Container Registry (MCR), die verderop in het artikel wordt beschreven.

U kunt de container niet uitvoeren als uw Azure-abonnement niet is goedgekeurd.

Toegang is beperkt tot klanten die voldoen aan de volgende vereisten:

Uw organisatie moet worden geïdentificeerd als strategische klant of partner met Microsoft.
Van niet-verbonden containers wordt verwacht dat ze volledig offline worden uitgevoerd. Daarom moeten uw gebruiksvoorbeelden voldoen aan een van de onderstaande of vergelijkbare vereisten:
- Omgeving of apparaat(en) zonder connectiviteit met internet.
- Externe locatie die af en toe internettoegang heeft.
- Organisatie onder strikte regelgeving voor het niet verzenden van gegevens naar de cloud.
De toepassing is voltooid volgens de instructies: let goed op de richtlijnen die in de toepassing worden gegeven om ervoor te zorgen dat u alle benodigde informatie verstrekt die nodig is voor goedkeuring.

Een prijsplan voor een toezeggingscategorie aanschaffen voor niet-verbonden containers

Een nieuwe resource maken

Meld u aan bij Azure Portal en selecteer Een nieuwe resource maken voor een van de toepasselijke Azure AI-services die hierboven worden vermeld.
Voer de toepasselijke gegevens in om uw resource te maken. Zorg ervoor dat u de niet-verbonden containers van de Toezeggingslaag selecteert als uw prijscategorie.
Notitie
- U ziet alleen de optie om een toezeggingslaag aan te schaffen als u door Microsoft bent goedgekeurd.
- Prijsgegevens zijn bijvoorbeeld alleen beschikbaar.
Selecteer Controleren en maken onderaan de pagina. Controleer de informatie en selecteer Maken.

Container configureren voor niet-verbonden gebruik

Raadpleeg de volgende documentatie voor stappen voor het downloaden en configureren van de container voor niet-verbonden gebruik:

Speech Service

Taalservice

Namen van omgevingsvariabelen in Kubernetes-implementaties

Voor sommige Azure AI-containers, bijvoorbeeld Translator, moeten gebruikers namen van omgevingsvariabelen doorgeven die dubbele punten (:) bevatten bij het uitvoeren van de container. Dit werkt prima wanneer u Docker gebruikt, maar Kubernetes accepteert geen dubbele punten in namen van omgevingsvariabelen. U kunt dit oplossen door dubbele punten te vervangen door dubbele onderstrepingstekens (__) bij de implementatie in Kubernetes. Zie het volgende voorbeeld van een acceptabele indeling voor namen van omgevingsvariabelen:

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

In dit voorbeeld wordt de standaardindeling voor de namen van de Mounts:License omgevingsvariabelen Mounts:Output in de docker-run-opdracht vervangen.

Updates voor containerinstallatiekopieën en licenties

Containerlicentiebestanden worden gebruikt als sleutels voor het ontsleutelen van bepaalde bestanden binnen elke containerinstallatiekopieën. Als deze versleutelde bestanden in een nieuwe containerinstallatiekopieën worden bijgewerkt, kan het licentiebestand dat u hebt, de container mogelijk niet starten, zelfs niet als deze met de vorige versie van de containerinstallatiekopieën werkte. Om dit probleem te voorkomen, raden we u aan een nieuw licentiebestand te downloaden van het resource-eindpunt voor uw container die is opgegeven in Azure Portal nadat u nieuwe installatiekopieversies hebt opgehaald uit mcr.microsoft.com.

Als u een nieuw licentiebestand wilt downloaden, kunt u de opdracht docker-run toevoegen DownloadLicense=True , samen met een licentiekoppeling, uw API-sleutel en uw factureringseindpunt. Raadpleeg de documentatie van uw container voor gedetailleerde instructies.

Gebruiksrecords

Wanneer u Docker-containers in een niet-verbonden omgeving gebruikt, schrijft de container gebruiksrecords naar een volume waar ze na verloop van tijd worden verzameld. U kunt ook een REST-eindpunt aanroepen om een rapport over servicegebruik te genereren.

Argumenten voor het opslaan van logboeken

Wanneer deze wordt uitgevoerd in een niet-verbonden omgeving, moet er een uitvoerkoppeling beschikbaar zijn voor de container om gebruikslogboeken op te slaan. U kunt bijvoorbeeld het pad waarin de logboeken worden opgeslagen, opnemen -v /host/output:{OUTPUT_PATH} en Mounts:Output={OUTPUT_PATH} in het onderstaande voorbeeld vervangen {OUTPUT_PATH} door het pad waarin de logboeken worden opgeslagen:

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

Records ophalen met behulp van de containereindpunten

De container biedt twee eindpunten voor het retourneren van records over het gebruik ervan.

Alle records ophalen

Het volgende eindpunt bevat een rapport met een overzicht van al het gebruik dat is verzameld in de gekoppelde factureringsrecordmap.

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

Er wordt JSON geretourneerd die vergelijkbaar is met het onderstaande voorbeeld.

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

Records ophalen voor een specifieke maand

Het volgende eindpunt bevat een rapport met een overzicht van het gebruik gedurende een specifieke maand en een bepaald jaar.

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

er wordt een JSON-antwoord geretourneerd dat vergelijkbaar is met het onderstaande voorbeeld:

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

Een toezeggingsplan aanschaffen voor het gebruik van containers in niet-verbonden omgevingen

Toezeggingsplannen voor niet-verbonden containers hebben een toezeggingsperiode van het kalenderjaar. Wanneer u een abonnement aanschaft, wordt de volledige prijs onmiddellijk in rekening gebracht. Tijdens de toezeggingsperiode kunt u uw toezeggingsplan niet wijzigen, maar u kunt extra eenheden aanschaffen tegen een ratoprijs voor de resterende dagen in het jaar. U hebt tot middernacht (UTC) op de laatste dag van uw toezegging om een toezeggingsplan te beëindigen.

U kunt een ander toezeggingsplan kiezen in de prijsinstellingen voor de toezeggingslaag van uw resource.

Een toezeggingsplan beëindigen

Als u besluit dat u niet wilt doorgaan met het aanschaffen van een toezeggingsplan, kunt u de automatische verlenging van uw resource instellen op Niet automatisch verlengen. Uw toezeggingsplan verloopt op de weergegeven einddatum van de toezegging. Na deze datum worden er geen kosten in rekening gebracht voor het toezeggingsplan. U kunt de Azure-resource blijven gebruiken om API-aanroepen te doen, die in rekening worden gebracht tegen betalen per gebruik. U hebt tot middernacht (UTC) op de laatste dag van het jaar om een toezeggingsplan voor niet-verbonden containers te beëindigen en worden niet in rekening gebracht voor het volgende jaar.

Probleemoplossing

Als u de container uitvoert waarvoor uitvoerkoppeling en logboekregistratie zijn ingeschakeld, genereert de container logboekbestanden die handig zijn om problemen op te lossen die optreden tijdens het starten of uitvoeren van de container.

Tip

Zie Veelgestelde vragen over niet-verbonden containers voor meer informatie en richtlijnen voor probleemoplossing.

Volgende stappen

Overzicht van Azure AI-containers

Delen via