Docker kapsayıcılarını bağlantısız ortamlarda kullanma
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:
- Konuşmayı metne dönüştürme
- Özel Konuşmayı metne dönüştürme
- Nöral Metin okuma
- Metin Çevirisi (Standart)
- Azure AI Dili
- Azure AI Vision - Okuma
- Belge Yönetim Bilgileri
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.
Not
- 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:
- Görüntü İşleme - Okuma
- Language Understanding (LUIS)
- Metin Çevirisi (Standart)
- Belge Yönetim Bilgileri
Konuşma hizmeti
Dil hizmeti
Kubernetes dağıtımlarında ortam değişkeni adları
Translator gibi 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.
İpucu
Daha fazla sorun giderme bilgisi ve kılavuzu için bkz . Bağlantısı kesilmiş kapsayıcılar Sık sorulan sorular (SSS).