Docker kapsayıcılarını bağlantısız ortamlarda kullanma

Makale
11/15/2023

Kapsayıcılar, Azure AI hizmetleri API'lerini kendi ortamınızda çalıştırmanıza olanak tanır ve özel güvenlik ve veri idaresi gereksinimleriniz için mükemmeldir. Bağlantısı kesilmiş kapsayıcılar, İnternet bağlantısı kesilmiş bu API'lerin birkaçını kullanmanıza olanak tanır. Şu anda aşağıdaki kapsayıcılar bu şekilde çalıştırılabilir:

Docker kapsayıcısını çevrimdışı bir ortamda çalıştırmayı denemeden önce kapsayıcıyı başarıyla indirme ve kullanma adımlarını bildiğinizden emin olun. Örneğin:

Bilgisayar gereksinimlerini ve önerilerini barındır.
Kapsayıcıyı indirmek için kullanacağınız Docker pull komutu.
Kapsayıcının çalıştığını doğrulama.
Çalıştırıldıktan sonra kapsayıcının uç noktasına sorgu gönderme.

Bağlantısız ortamlarda kapsayıcıları kullanmak için erişim isteme

İnternet bağlantısı kesilmiş kapsayıcılara erişim istemek için istek formunu doldurun ve gönderin.

Form, siz, şirketiniz ve kapsayıcıyı kullanacağınız kullanıcı senaryosu hakkında bilgi istemektedir. Formu gönderdikten sonra Azure AI hizmetleri ekibi formu inceler ve 10 iş günü içinde bir kararla size e-posta gönderir.

Önemli

Formda, Azure abonelik kimliğiyle ilişkilendirilmiş bir e-posta adresi kullanmanız gerekir.
Kapsayıcıyı çalıştırmak için kullandığınız Azure kaynağı onaylı Azure abonelik kimliğiyle oluşturulmuş olmalıdır.
Microsoft'tan uygulamanızın durumuyla ilgili güncelleştirmeler için e-postanızı (gelen kutusu ve gereksiz klasörler) denetleyin.

Onayladıktan sonra, kapsayıcıyı makalenin ilerleyen bölümlerinde açıklanan Microsoft Container Registry'den (MCR) indirdikten sonra çalıştırabilirsiniz.

Azure aboneliğiniz onaylanmamışsa kapsayıcıyı çalıştıramazsınız.

Erişim, aşağıdaki gereksinimleri karşılayan müşterilerle sınırlıdır:

Kuruluşunuz stratejik müşteri veya Microsoft iş ortağı olarak tanımlanmalıdır.
Bağlantısı kesilmiş kapsayıcıların tamamen çevrimdışı çalışması beklenir, bu nedenle kullanım örneklerinizin aşağıdaki veya benzer gereksinimlerden birini karşılaması gerekir:
- İnternet bağlantısı sıfır olan ortam veya cihazlar.
- Zaman zaman İnternet erişimi olan uzak konum.
- Kuruluş, herhangi bir veri türünü buluta geri göndermeme konusunda sıkı bir düzenleme kapsamındadır.
Uygulama belirtildiği gibi tamamlandı - Onay için gerekli tüm bilgileri sağladığınızı güvence altına almak için lütfen uygulama genelinde sağlanan yönergelere dikkat edin.

Bağlantısı kesilmiş kapsayıcılar için taahhüt katmanı fiyatlandırma planı satın alma

Yeni kaynak oluşturma

Azure portalında oturum açın ve yukarıda listelenen geçerli Azure AI hizmetlerinden biri için yeni kaynak oluştur'u seçin.
Kaynağınızı oluşturmak için geçerli bilgileri girin. Fiyatlandırma katmanınız olarak Taahhüt katmanı bağlantısı kesilmiş kapsayıcılar'ı seçtiğinizden emin olun.
Dekont
- Taahhüt katmanı satın alma seçeneğini yalnızca Microsoft tarafından onaylandıysanız görürsünüz.
- Fiyatlandırma ayrıntıları yalnızca örnektir.
Sayfanın alt kısmındaki Gözden Geçir + Oluştur'u seçin. Bilgileri gözden geçirin ve Oluştur'u seçin.

Kapsayıcıyı bağlantısız kullanım için yapılandırma

Kapsayıcıyı bağlantısız kullanım için indirme ve yapılandırma adımları için aşağıdaki belgelere bakın:

Konuşma hizmeti

Dil hizmeti

Kubernetes dağıtımlarında ortam değişkeni adları

Örneğin Çeviri bazı Azure AI Kapsayıcıları, kullanıcıların kapsayıcıyı çalıştırırken iki nokta üst üste (:) içeren ortam değişkeni adlarını geçirmesini gerektirir. Docker kullanılırken bu işlem sorunsuz çalışır, ancak Kubernetes ortam değişkeni adlarında iki nokta üst üsteleri kabul etmez. Bu sorunu çözmek için Kubernetes'e dağıtırken iki nokta üst üstelerini çift alt çizgi karakterleriyle (__) değiştirebilirsiniz. Ortam değişkeni adları için aşağıdaki kabul edilebilir biçim örneğine bakın:

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

Bu örnek, docker run komutundaki Mounts:License ve Mounts:Output ortam değişkeni adları için varsayılan biçimin yerini alır.

Kapsayıcı görüntüsü ve lisans güncelleştirmeleri

Kapsayıcı lisans dosyaları, her kapsayıcı görüntüsündeki belirli dosyaların şifresini çözmek için anahtar olarak kullanılır. Bu şifrelenmiş dosyalar yeni bir kapsayıcı görüntüsü içinde güncelleştiriliyorsa, sahip olduğunuz lisans dosyası kapsayıcı görüntüsünün önceki sürümüyle çalışsa bile kapsayıcıyı başlatamayabilir. Bu sorunu önlemek için, mcr.microsoft.com yeni görüntü sürümlerini çektikten sonra Azure portalında sağlanan kapsayıcınızın kaynak uç noktasından yeni bir lisans dosyası indirmenizi öneririz.

Yeni bir lisans dosyası indirmek için docker run komutuna bir lisans bağlama, API Anahtarınız ve faturalama uç noktanızla birlikte ekleyebilirsiniz DownloadLicense=True . Ayrıntılı yönergeler için kapsayıcınızın belgelerine bakın.

Kullanım kayıtları

Docker kapsayıcılarını bağlantısız bir ortamda çalıştırırken, kapsayıcı kullanım kayıtlarını zaman içinde toplandıkları bir birime yazar. Hizmet kullanımı hakkında bir rapor oluşturmak için rest uç noktasını da çağırabilirsiniz.

Günlükleri depolamaya yönelik bağımsız değişkenler

Bağlantısı kesilmiş bir ortamda çalıştırıldığında, kullanım günlüklerini depolamak için kapsayıcıya bir çıkış bağlaması kullanılabilir olmalıdır. Örneğin, aşağıdaki örnekte ve Mounts:Output={OUTPUT_PATH} değerini günlüklerin depolanacağı yol ile değiştirerek {OUTPUT_PATH} eklersiniz-v /host/output:{OUTPUT_PATH}:

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

Kapsayıcı uç noktalarını kullanarak kayıtları alma

Kapsayıcı, kullanımıyla ilgili kayıtları döndürmek için iki uç nokta sağlar.

Tüm kayıtları alma

Aşağıdaki uç nokta, bağlı faturalama kaydı dizininde toplanan tüm kullanımı özetleyen bir rapor sağlar.

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

Aşağıdaki örneğe benzer şekilde JSON döndürür.

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

Belirli bir ayın kayıtlarını alma

Aşağıdaki uç nokta, belirli bir ay ve yıl içindeki kullanımı özetleyen bir rapor sağlar.

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

aşağıdaki örneğe benzer bir JSON yanıtı döndürür:

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

Bağlantısız ortamlarda kapsayıcıları kullanmak için taahhüt planı satın alma

Bağlantısı kesilmiş kapsayıcılar için taahhüt planlarının bir takvim yılı taahhüt süresi vardır. Bir plan satın aldığınızda, hemen tam fiyat tahsil edilir. Taahhüt süresi boyunca taahhüt planınızı değiştiremezsiniz, ancak yılın kalan günleri için eşit puanlı bir fiyatla ek birim satın alabilirsiniz. Bir taahhüt planını sonlandırmak için taahhüdünüzün son gününde gece yarısına (UTC) kadar süreniz vardır.

Kaynağınızın Taahhüt Katmanı fiyatlandırma ayarlarından farklı bir taahhüt planı seçebilirsiniz.

Taahhüt planını sonlandırma

Taahhüt planı satın almaya devam etmek istemediğinize karar verirseniz kaynağınızın otomatik yenilemesini Otomatik yenileme yapma olarak ayarlayabilirsiniz. Görüntülenen taahhüt bitiş tarihinde taahhüt planınızın süresi dolar. Bu tarihten sonra taahhüt planı için ücretlendirilmeyeceksiniz. Kullandıkça öde fiyatlandırmasıyla ücretlendirilen API çağrıları yapmak için Azure kaynağını kullanmaya devam edebilirsiniz. Bağlantısı kesilmiş kapsayıcılar için taahhüt planını sona erdirmek için yılın son günü gece yarısına (UTC) kadar süreniz vardır ve sonraki yıl için ücret alınmaz.

Sorun giderme

Kapsayıcıyı bir çıkış bağlaması ve günlüğe kaydetme etkin olarak çalıştırırsanız kapsayıcı, kapsayıcıyı başlatırken veya çalıştırırken karşılaşılan sorunları gidermeye yardımcı olan günlük dosyaları oluşturur.

Bahşiş

Daha fazla sorun giderme bilgisi ve kılavuzu için bkz . Bağlantısı kesilmiş kapsayıcılar Sık sorulan sorular (SSS).

Sonraki adımlar

Azure AI kapsayıcılara genel bakış

Share via