Özel bir kapsayıcı kullanarak özel yazılımları Azure Uygulaması Hizmetine geçirme

Azure Uygulaması Hizmeti, Windows'ta ASP.NET veya Node.js gibi önceden tanımlanmış uygulama yığınları sağlar. Bu uygulama yığınları IIS üzerinde çalışır. Önceden yapılandırılmış Windows ortamı işletim sistemini aşağıdakilerden kilitler:

• Yönetim erişimi.
• Yazılım yüklemeleri.
• Genel derleme önbelleğinde yapılan değişiklikler.

Daha fazla bilgi için bkz. Azure Uygulaması Hizmetinde işletim sistemi işlevselliği.

Uygulamanızın ihtiyaç duyduğu işletim sistemi değişikliklerini yapmak için Visual Studio'dan özel olarak yapılandırılmış bir Windows görüntüsü dağıtabilirsiniz. Bu, özel işletim sistemi ve yazılım yapılandırması gerektiren bir şirket içi uygulamayı geçirmeyi kolaylaştırır. Bu öğreticide Windows yazı tipi kitaplığında yüklü olan özel yazı tiplerini kullanan bir ASP.NET uygulamasını App Service'e geçirme adımları gösterilmektedir. Visual Studio'dan Azure Container Registry'ye özel olarak yapılandırılmış bir Windows görüntüsü dağıtıp App Service'te çalıştırırsınız.

Önkoşullar

Bu öğreticiyi tamamlamak için:

• Docker Hub hesabına kaydolun.
• Docker for Windows'u yükleyin.
• Docker'ı Windows kapsayıcılarını çalıştıracak şekilde yapılandırın.
• Visual Studio 2022'yi ASP.NET, web geliştirme ve Azure geliştirme iş yükleriyle yükleyin. Visual Studio 2022'yi zaten yüklediyseniz:
  • Güncelleştirmeleri Denetleme Yardımı'nı seçerek Visual Studio'daki en son güncelleştirmeleri yükleyin.>
  • Araçlar Araçları>ve Özellikleri Al'ı seçerek Visual Studio'da iş yüklerini ekleyin.

Uygulamayı yerel ortamda oluşturma

Örneği indirme

Bu adımda yerel .NET projesini oluşturacaksınız.

• Örnek projeyi indirin.
• custom-font-win-container-master.zip dosyasını ayıklayın (sıkıştırmasını açın).

Örnek proje, Windows yazı tipi kitaplığına yüklenmiş özel bir yazı tipi kullanan basit bir ASP.NET uygulaması içerir. Yazı tiplerinin yüklenmesi gerekmez. Ancak örnek, temel işletim sistemiyle tümleştirilmiş bir uygulama örneğidir. Bu tür bir uygulamayı App Service'e geçirmek için kodunuzu yeniden düzenleyip tümleştirmeyi kaldırabilir veya özel Windows kapsayıcısında olduğu için olduğu şekilde geçirebilirsiniz.

Yazı tipini yükleme

Windows Gezgini'nde custom-font-win-container-master/CustomFontSample dizinine gidin, FrederickatheGreat-Regular.ttf dosyasına sağ tıklayın ve Yükle'yi seçin.

Bu yazı tipi Google Fonts sayfasında genel kullanıma açık bir şekilde sunulmaktadır.

Uygulamayı çalıştırma

Visual Studio'da custom-font-win-container-master/CustomFontSample.sln dosyasını açın.

Uygulamayı hata ayıklamadan çalıştırmak için Ctrl+F5 tuşlarına basın. Uygulama varsayılan tarayıcınızda görüntülenir.

Uygulama yüklü bir yazı tipi kullandığından, uygulama App Service korumalı alanında çalıştırılamaz. Ancak yazı tipini Windows kapsayıcısına yükleyebileceğiniz için uygulamayı Windows kapsayıcısı kullanarak dağıtabilirsiniz.

Windows kapsayıcısını yapılandırma

Çözüm Gezgini'nde CustomFontSample projesine sağ tıklayıp Ekle>Kapsayıcı Düzenleme Desteği'ne tıklayın.

Docker Compose>Tamam'ı seçin.

Projeniz artık bir Windows kapsayıcısında çalışacak şekilde ayarlanmıştır. Dockerfile CustomFontSample projesine ve çözüme bir docker-compose projesi eklenir.

Çözüm Gezgini'nden Dockerfile dosyasını açın.

Desteklenen bir üst görüntü kullanmanız gerekir. FROM satırını aşağıdaki kod ile değiştirerek üst görüntüyü değiştirin:

FROM mcr.microsoft.com/dotnet/framework/aspnet:4.7.2-windowsservercore-ltsc2019

Dosyanın en sonuna şu satırı ekleyin ve dosyayı kaydedin:

RUN ${source:-obj/Docker/publish/InstallFont.ps1}

InstallFont.ps1 dosyasını CustomFontSample projesinde bulabilirsiniz. Yazı tipini yükleyen basit bir betiktir. Betiğin daha karmaşık bir sürümünü PowerShell Galerisi bulabilirsiniz.

Azure Container Registry'de yayımlama

Azure Container Registry, kapsayıcı dağıtımlarınızın görüntülerini depolayabilir. App Service'i Azure Container Registry'de barındırılan görüntüleri kullanacak şekilde yapılandırabilirsiniz.

Yayımlama sihirbazını açma

Çözüm Gezgini'nde CustomFontSample projesine sağ tıklayın ve Yayımla'yı seçin.

Kayıt defterini oluşturma ve yayımlama

Yayımlama sihirbazında Kapsayıcı Kayıt Defteri>Yeni Azure Azure Container Registry>Yayımla'yı seçin.

Azure hesabıyla oturum açma

Yeni Azure Container Registry oluştur iletişim kutusunda Hesap ekle'yi seçin ve Azure aboneliğinizde oturum açın. Oturumunuz zaten açıksa, açılan menüden istediğiniz aboneliği içeren hesabı seçin.

Kayıt defterini yapılandırma

Aşağıdaki tabloda önerilen değerleri kılavuz olarak kullanarak yeni kapsayıcı kayıt defterini yapılandırın. Bittiğinde Oluştur’u seçin.

Bir terminal penceresi açılır ve görüntü dağıtım ilerleme durumunu görüntüler. Dağıtımın tamamlanmasını bekleyin.

Azure'da oturum açma

Azure Portal’ında oturum açın.

Web uygulaması oluşturma

Soldaki menüden Kaynak oluştur>Web>Kapsayıcılar için Web Uygulaması'nı seçin.

Uygulama temel bilgilerini yapılandırma

Temel Bilgiler sekmesinde, ayarları aşağıdaki tabloya göre yapılandırın. Ardından İleri: Docker'ı seçin.

Temel Bilgiler sekmeniz şu şekilde görünmelidir:

Windows kapsayıcısını yapılandırma

Docker sekmesinde, aşağıdaki tabloda gösterildiği gibi özel Windows kapsayıcınızı yapılandırın ve gözden geçir ve oluştur'u seçin.

Uygulama oluşturmayı tamamlama

Oluştur'u seçin ve Azure'ın gerekli kaynakları oluşturmasını bekleyin.

Web uygulamasına göz atma

Dağıtım tamamlandığında bir bildirim kutusu görüntülenir.

1. Kaynağa git’i seçin.

2. Uygulama sayfasında URL'nin altındaki bağlantıyı seçin.

Aşağıdaki sayfayla yeni bir tarayıcı sayfası açılır:

Birkaç dakika bekleyin ve beklediğiniz yazı tipini içeren giriş sayfasını edinene kadar yeniden deneyin:

Tebrikler! Bir ASP.NET uygulamasını Windows kapsayıcısında Azure App Service'e geçirdiniz.

Kapsayıcı başlangıç günlüklerini görüntüleme

Windows kapsayıcısının yüklenmesi biraz zaman alabilir. İlerleme durumunu görmek için aşağıdaki URL'ye gidin. (Uygulama adını> uygulamanızın adıyla değiştirin<.)

https://<app-name>.scm.azurewebsites.net/api/logstream

Akışa alınan günlükler şöyle görünür:

14/09/2018 23:16:19.889 INFO - Site: fonts-win-container - Creating container for image: customfontsample20180914115836.azurecr.io/customfontsample:latest.
14/09/2018 23:16:19.928 INFO - Site: fonts-win-container - Create container for image: customfontsample20180914115836.azurecr.io/customfontsample:latest succeeded. Container Id 329ecfedbe370f1d99857da7352a7633366b878607994ff1334461e44e6f5418
14/09/2018 23:17:23.405 INFO - Site: fonts-win-container - Start container succeeded. Container: 329ecfedbe370f1d99857da7352a7633366b878607994ff1334461e44e6f5418
14/09/2018 23:17:28.637 INFO - Site: fonts-win-container - Container ready
14/09/2018 23:17:28.637 INFO - Site: fonts-win-container - Configuring container
14/09/2018 23:18:03.823 INFO - Site: fonts-win-container - Container ready
14/09/2018 23:18:03.823 INFO - Site: fonts-win-container - Container start-up and configuration completed successfully

Azure Uygulaması Hizmeti, hem yerleşik görüntüleri hem de özel görüntüleri barındırmak için Docker kapsayıcı teknolojisini kullanır. Yerleşik görüntülerin listesini görmek için 'az webapp list-runtimes --os linux' adlı Azure CLI komutunu çalıştırın. Bu görüntüler gereksinimlerinizi karşılamıyorsa özel görüntü derleyebilir ve dağıtabilirsiniz.

Bu öğreticide aşağıdakilerin nasıl yapılacağını öğreneceksiniz:

Bu öğreticinin tamamlanması, kapsayıcı kayıt defteri için Azure hesabınızda küçük bir ücrete neden olur ve kapsayıcıyı bir aydan uzun süre barındırıyorsanız daha fazla maliyete neden olabilir.

İlk ortamınızı ayarlama

Bu öğretici, Azure CLI'nın 2.0.80 veya sonraki bir sürümünü gerektirir. Azure Cloud Shell kullanıyorsanız en son sürüm zaten yüklüdür.

• Etkin bir aboneliği olan bir Azure hesabınız olmalıdır. Ücretsiz hesap oluşturun.

• Azure Cloud Shell'de Bash ortamını kullanın. Daha fazla bilgi için bkz . Azure Cloud Shell'de Bash için hızlı başlangıç.

  

• CLI başvuru komutlarını yerel olarak çalıştırmayı tercih ediyorsanız Azure CLI'yı yükleyin . Windows veya macOS üzerinde çalışıyorsanız Azure CLI’yi bir Docker kapsayıcısında çalıştırmayı değerlendirin. Daha fazla bilgi için bkz . Docker kapsayıcısında Azure CLI'yi çalıştırma.

  • Yerel yükleme kullanıyorsanız az login komutunu kullanarak Azure CLI ile oturum açın. Kimlik doğrulama işlemini tamamlamak için terminalinizde görüntülenen adımları izleyin. Diğer oturum açma seçenekleri için bkz . Azure CLI ile oturum açma.

  • İstendiğinde, ilk kullanımda Azure CLI uzantısını yükleyin. Uzantılar hakkında daha fazla bilgi için bkz. Azure CLI ile uzantıları kullanma.

  • Yüklü sürümü ve bağımlı kitaplıkları bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.

• Docker görüntüleri oluşturmak için kullandığınız Docker'ı yükleyin. Docker'ın yüklenmesi için bilgisayarın yeniden başlatılması gerekebilir.

Docker'ı yükledikten sonra bir terminal penceresi açın ve docker'ın yüklü olduğunu doğrulayın:

docker --version

Örnek uygulamayı kopyalama veya indirme

Bu öğreticinin örneğini git kopyalama veya indirme yoluyla edinebilirsiniz.

Git ile kopyalama

Örnek depoyu kopyalayın:

git clone https://github.com/Azure-Samples/docker-django-webapp-linux.git --config core.autocrlf=input

Linux kapsayıcısının içinde kullanılan dosyalara --config core.autocrlf=input doğru satır sonlarını garanti etmek için bağımsız değişkenini eklediğinizden emin olun.

Ardından klasöre gidin:

cd docker-django-webapp-linux

GitHub’dan indirin

Git clone kullanmak yerine adresini ziyaret https://github.com/Azure-Samples/docker-django-webapp-linux edebilir ve Kod>Yerel>İndirme ZIP'i seçebilirsiniz.

ZIP dosyasını docker-django-webapp-linux adlı bir klasöre açın.

Ardından docker-django-webapp-linux klasöründe bir terminal penceresi açın.

(İsteğe bağlı) Docker dosyasını inceleme

Bu, örnekteki Dockerfile adlı dosyadır. Docker görüntüsünü açıklar ve yapılandırma yönergelerini içerir.

FROM tiangolo/uwsgi-nginx-flask:python3.6

RUN mkdir /code
WORKDIR /code
ADD requirements.txt /code/
RUN pip install -r requirements.txt --no-cache-dir
ADD . /code/

# ssh
ENV SSH_PASSWD "root:Docker!"
RUN apt-get update \
        && apt-get install -y --no-install-recommends dialog \
        && apt-get update \
 && apt-get install -y --no-install-recommends openssh-server \
 && echo "$SSH_PASSWD" | chpasswd 

COPY sshd_config /etc/ssh/
COPY init.sh /usr/local/bin/

RUN chmod u+x /usr/local/bin/init.sh
EXPOSE 8000 2222

#CMD ["python", "/code/manage.py", "runserver", "0.0.0.0:8000"]
ENTRYPOINT ["init.sh"]

• İlk komut grubu, uygulamanın gereksinimlerini ortama yükler.
• İkinci komut grubu, kapsayıcı ve konak arasında gelişmiş güvenlik iletişimi sağlamak için bir SSH sunucusu oluşturur.
• Son satır olan ENTRYPOINT ["init.sh"], SSH hizmetini ve Python sunucusunu başlatmak için çağırır init.sh .

Görüntüyü yerel olarak derleme ve test etme

1. Görüntüyü oluşturmak için aşağıdaki komutu çalıştırın:

   docker build --tag appsvc-tutorial-custom-image .
   

2. Docker kapsayıcısını yerel olarak çalıştırarak derlemenin çalışıp çalışmadığını test edin:

   docker run -it -p 8000:8000 appsvc-tutorial-custom-image
   

   Bu docker run komut, bağımsız değişkeniyle -p bağlantı noktasını belirtir ve görüntünün adını içerir. -itCtrl+C ile durdurmanıza olanak tanır.

   İpucu

   Windows üzerinde çalışıyorsanız ve standard_init_linux.go:211: exec kullanıcı işleminin "böyle bir dosya veya dizin yok" hatasına neden olduğunu görürseniz, init.sh dosyası beklenen LF bitişleri yerine CRLF satır sonlarını içerir. Örnek depoyu kopyalamak için Git'i kullandıysanız ancak parametresini --config core.autocrlf=input atladığınızda bu hata oluşur. Bu durumda, depoyu bağımsız değişkeniyle --config yeniden kopyalayın. Ayrıca, init.sh düzenlediyseniz ve CRLF sonlarıyla kaydettiyseniz hatayı görebilirsiniz. Bu durumda, dosyayı yalnızca LF sonlarıyla yeniden kaydedin.

3. http://localhost:8000 Web uygulamasının ve kapsayıcının düzgün çalıştığını doğrulamak için adresine gidin.

   

I. Kullanıcı tarafından atanan yönetilen kimlik oluşturma

App Service, kapsayıcı kayıt defteriyle kimlik doğrulaması yapmak için varsayılan yönetilen kimliği veya kullanıcı tarafından atanan yönetilen kimliği kullanabilir. Bu öğreticide, kullanıcı tarafından atanan bir yönetilen kimlik kullanacaksınız.

II. Kapsayıcı kayıt defteri oluşturma

III. Örnek görüntüyü Azure Container Registry'ye gönderme

Bu bölümde, görüntüyü Daha sonra App Service tarafından kullanılacak olan Azure Container Registry'ye gönderirsiniz.

1. Örnek görüntüyü oluşturduğunuz yerel terminalden kapsayıcı kayıt defterinde oturum açmak için komutunu kullanın docker login :

   docker login <registry-name>.azurecr.io --username <registry-username>
   

   ve <registry-username> değerlerini önceki adımlarda yer alan değerlerle değiştirin<registry-name>. İstendiğinde, önceki bölümdeki parolalardan birini yazın.

   Bu bölümün kalan tüm adımlarında aynı kayıt defteri adını kullanırsınız.

2. Oturum açma işlemi başarılı olduğunda yerel Docker görüntünüzü kayıt defterine etiketleyin:

   docker tag appsvc-tutorial-custom-image <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
   

3. docker push Görüntüyü kayıt defterine göndermek için komutunu kullanın:

   docker push <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
   

   Temel görüntüyü içerdiğinden görüntüyü ilk kez karşıya yüklemek birkaç dakika sürebilir. Sonraki karşıya yüklemeler genellikle daha hızlıdır.

   Beklerken, App Service'i kayıt defterinden dağıtılacak şekilde yapılandırmak için sonraki bölümdeki adımları tamamlayabilirsiniz.

IV. Kayıt defteriniz için yönetilen kimliği yetkilendirme

Oluşturduğunuz yönetilen kimliğin henüz kapsayıcı kayıt defterinden çekme yetkisi yok. Bu adımda yetkilendirmeyi etkinleştirirsiniz.

V. Web uygulaması oluşturma

VI. Web uygulamasını yapılandırma

Bu adımda, web uygulamasını aşağıdaki gibi yapılandıracaksınız:

• Uygulamayı 8000 numaralı bağlantı noktasına istek gönderecek şekilde yapılandırın. Örnek kapsayıcı, web istekleri için 8000 numaralı bağlantı noktasında dinliyor.
• Uygulamanıza kapsayıcı kayıt defterinizden görüntü çekmek için yönetilen kimliği kullanmasını söyleyin.
• Kapsayıcı kayıt defterinden sürekli dağıtımı yapılandırın (kayıt defterine gönderilecek her görüntü uygulamanızı yeni görüntüyü çekmek için tetikler). Bu bölüm, web uygulamanızın kapsayıcı kayıt defterinizden çekmesi için gerekli değildir, ancak kayıt defterine yeni bir görüntü gönderildiğinde web uygulamanızın bunu bilmesini sağlayabilir. Bu olmadan, web uygulamasını yeniden başlatarak bir görüntü çekme işlemini el ile tetiklemeniz gerekir.

VII. Web uygulamasına göz atma

Uygulamaya ilk kez erişmeye çalıştığınızda, App Service'in görüntünün tamamını kayıt defterinden çekmesi gerektiğinden uygulamanın yanıt vermesi biraz zaman alabilir. Tarayıcı zaman aşımına uğradıysa sayfayı yenileyin. İlk görüntü çekildikten sonra, sonraki testler çok daha hızlı çalışır.

VIII. Tanılama günlüklerine erişim

IX. Uygulama kodunu değiştirme ve yeniden dağıtma

Bu bölümde web uygulaması kodunda bir değişiklik yapacak, görüntüyü yeniden derleyip kapsayıcı kayıt defterinize gönderebilirsiniz. Ardından App Service, çalışan web uygulamasını güncelleştirmek için güncelleştirilmiş görüntüyü kayıt defterinden otomatik olarak çeker.

1. Yerel docker-django-webapp-linux klasörünüzde app/templates/app/index.html dosyasını açın.

2. İlk HTML öğesini aşağıdaki kodla eşleşecek şekilde değiştirin.

   <nav class="navbar navbar-inverse navbar-fixed-top">
     <div class="container">
       <div class="navbar-header">
         <a class="navbar-brand" href="#">Azure App Service - Updated Here!</a>
       </div>
     </div>
   </nav>
   

3. Değişikliklerinizi kaydedin.

4. docker-django-webapp-linux klasörüne geçin ve görüntüyü yeniden oluşturun:

   docker build --tag appsvc-tutorial-custom-image .
   

5. Görüntünün etiketini olarak latestgüncelleştirin:

   docker tag appsvc-tutorial-custom-image <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
   

   <registry-name> değerini kayıt defterinizin adıyla değiştirin.

6. Görüntüyü kayıt defterine gönderin:

   docker push <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
   

7. Görüntü gönderme işlemi tamamlandığında web kancası, App Service'e gönderme hakkında bildirimde bulunur ve App Service güncelleştirilmiş görüntüyü çekmeye çalışır. Birkaç dakika bekleyin ve ardından adresine göz atarak https://<app-name>.azurewebsites.netgüncelleştirmenin dağıtıldığını doğrulayın.

X. SSH kullanarak kapsayıcıya bağlanma

SSH, kapsayıcı ve istemci arasında gelişmiş güvenlik iletişimi sağlar. Kapsayıcınıza SSH bağlantısını etkinleştirmek için özel görüntünüzü yapılandırmanız gerekir. Kapsayıcı çalışırken bir SSH bağlantısı açabilirsiniz.

Kapsayıcıyı SSH için yapılandırma

Bu öğreticide kullanılan örnek uygulama, SSH sunucusunu yükleyen ve oturum açma kimlik bilgilerini de ayarlayan Dockerfile'da gerekli yapılandırmaya zaten sahiptir. Bu bölüm yalnızca bilgilendirme amaçlıdır. Kapsayıcıya bağlanmak için sonraki bölüme geçin.

ENV SSH_PASSWD "root:Docker!"
RUN apt-get update \
        && apt-get install -y --no-install-recommends dialog \
        && apt-get update \
  && apt-get install -y --no-install-recommends openssh-server \
  && echo "$SSH_PASSWD" | chpasswd 

Dockerfile ayrıca sshd_config dosyasını /etc/ssh/ klasörüne kopyalar ve kapsayıcıda 2222 numaralı bağlantı noktasını kullanıma sunar:

COPY sshd_config /etc/ssh/

# ...

EXPOSE 8000 2222

Bağlantı noktası 2222, yalnızca özel bir sanal ağın köprü ağı içindeki kapsayıcılar tarafından erişilebilen bir iç bağlantı noktasıdır.

Son olarak, init.sh giriş betiği SSH sunucusunu başlatır.

#!/bin/bash
service ssh start

Kapsayıcıya SSH bağlantısını açma

XI. Kaynakları temizleme

az group delete --name msdocs-custom-container-tutorial