Migrace vlastního softwaru do služby Aplikace Azure Service pomocí vlastního kontejneru

služba Aplikace Azure poskytuje předdefinované zásobníky aplikací, jako jsou ASP.NET nebo Node.js, ve Windows. Tyto zásobníky aplikací běží ve službě IIS. Předkonfigurované prostředí Windows uzamkne operační systém z:

• Přístup ke správě.
• Instalace softwaru.
• Změny globální mezipaměti sestavení.

Další informace naleznete v tématu Funkce operačního systému ve službě Aplikace Azure Service.

Můžete nasadit vlastní nakonfigurovanou image Windows ze sady Visual Studio, abyste mohli provádět změny operačního systému, které vaše aplikace potřebuje. To usnadňuje migraci místní aplikace, která vyžaduje vlastní konfiguraci operačního systému a softwaru. Tento kurz ukazuje, jak do služby App Service migrovat aplikaci ASP.NET, která využívá vlastní písma nainstalovaná v knihovně písem Windows. Nasadíte vlastní nakonfigurovanou image Windows ze sady Visual Studio do služby Azure Container Registry a pak ji spustíte ve službě App Service.

Požadavky

Pro absolvování tohoto kurzu potřebujete:

• Zaregistrujte si účet Docker Hubu.
• Nainstalovat Docker for Windows.
• Nakonfigurujte Docker pro spouštění kontejnerů Windows.
• Nainstalujte Visual Studio 2022 s úlohami vývoje pro ASP.NET a web a vývoj pro Azure. Pokud jste už nainstalovali Visual Studio 2022:
  • Nainstalujte nejnovější aktualizace v sadě Visual Studio výběrem možnosti Vyhledat aktualizace nápovědy>.
  • Přidejte úlohy v sadě Visual Studio výběrem nástrojů Získat nástroje>a funkce.

Místní nastavení aplikace

Stažení ukázky

V tomto kroku nastavíte místní projekt .NET.

• Stáhněte si ukázkový projekt.
• Extrahujte (rozbalte) soubor custom-font-win-container-master.zip .

Ukázkový projekt obsahuje jednoduchou ASP.NET aplikaci, která používá vlastní písmo nainstalované v knihovně písem systému Windows. Písma není nutné instalovat. Ukázka je ale příkladem aplikace, která je integrovaná se základním operačním systémem. Pokud chcete takovou aplikaci migrovat do služby App Service, buď úpravou kódu odeberete tuto integraci, nebo ji migrujete tak jak je ve vlastním kontejneru Windows.

Instalace písma

V Průzkumníku Windows přejděte na custom-font-win-container-master/CustomFontSample, klikněte pravým tlačítkem na FrederickatheGreat-Regular.ttf a vyberte Nainstalovat.

Toto písmo je veřejně dostupné na webu Google Fonts.

Spustit aplikaci

Otevřete soubor custom-font-win-container-master/CustomFontSample.sln v sadě Visual Studio.

Pokud chcete aplikaci spustit bez ladění, vyberte Ctrl+F5 . Aplikace se zobrazí ve vašem výchozím prohlížeči.

Vzhledem k tomu, že aplikace používá nainstalované písmo, aplikace nemůže běžet v sandboxu služby App Service. Můžete ji ale místo toho nasadit pomocí kontejneru Windows, protože písmo můžete nainstalovat do tohoto kontejneru Windows.

Konfigurace kontejneru Windows

V Průzkumníku řešení klikněte pravým tlačítkem na projekt CustomFontSample a vyberte Přidat>Podpora orchestrace kontejnerů.

Vyberte Docker Compose>OK.

Váš projekt je teď nastavený tak, aby běžel v kontejneru Windows. Do projektu CustomFontSample se přidá a Dockerfile do řešení se přidá projekt docker-compose.

V Průzkumníku řešení otevřete soubor Dockerfile.

Je nutné použít podporovanou nadřazenou image. Nadřazenou image změníte tak, že řádek FROM nahradíte následujícím kódem:

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

Na konec souboru přidejte následující řádek a pak tento soubor uložte:

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

InstallFont.ps1 najdete v projektu CustomFontSample. Jde o jednoduchý skript, který nainstaluje toto písmo. Složitější verzi skriptu najdete v Galerie prostředí PowerShell.

Publikování do služby Azure Container Registry

Služba Azure Container Registry uchovává vaše image pro nasazení kontejnerů. Službu App Service můžete nakonfigurovat tak, aby používala image hostované ve službě Azure Container Registry.

Otevření průvodce publikováním

V Průzkumníku řešení klikněte pravým tlačítkem na projekt CustomFontSample a vyberte Publikovat.

Vytvoření a publikování registru

V průvodci publikováním vyberte Registr kontejneru>Vytvořit nový Azure Container Registry>Publikovat.

Přihlášení pomocí účtu Azure

V dialogovém okně Vytvořit nový azure Container Registry vyberte Přidat účet a pak se přihlaste ke svému předplatnému Azure. Pokud už jste přihlášení, vyberte z rozevíracího seznamu účet, který obsahuje požadované předplatné.

Konfigurace registru

Nakonfigurujte nový registr kontejneru pomocí navrhovaných hodnot v následující tabulce jako vodítko. Po dokončení vyberte Vytvořit.

Otevře se okno terminálu a zobrazí průběh nasazení image. Počkejte, až se nasazení dokončí.

Přihlášení k Azure

Přihlaste se k portálu Azure.

Vytvoření webové aplikace

V nabídce vlevo vyberte Vytvořit prostředek>Web>Web App for Containers.

Základní informace o konfiguraci aplikací

Na kartě Základy nakonfigurujte nastavení podle následující tabulky. Pak vyberte Další: Docker.

Karta Základy by měla vypadat takto:

Konfigurace kontejneru Windows

Na kartě Docker nakonfigurujte vlastní kontejner Windows, jak je znázorněno v následující tabulce, a pak vyberte Zkontrolovat a vytvořit.

Dokončení vytvoření aplikace

Vyberte Vytvořit a počkejte, až Azure vytvoří požadované prostředky.

Přechod na webovou aplikaci

Po dokončení nasazení se zobrazí okno s oznámením.

1. Vyberte Přejít k prostředku.

2. Na stránce aplikace vyberte odkaz pod adresou URL.

Na nové stránce prohlížeče se otevře následující stránka:

Počkejte několik minut a zkuste to znovu, dokud nedostanete domovskou stránku s písmem, které očekáváte:

Gratulujeme! Migrovali jste aplikaci ASP.NET do služby Azure App Service v kontejneru Windows.

Zobrazení protokolů spuštění kontejneru

Načtení kontejneru Windows může nějakou dobu trvat. Pokud chcete zobrazit průběh, přejděte na následující adresu URL. (Nahraďte <název> aplikace názvem vaší aplikace.)

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

Streamované protokoly vypadají takto:

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

Aplikace Azure Služba používá technologii kontejneru Dockeru k hostování integrovaných imagí i vlastních imagí. Pokud chcete zobrazit seznam integrovaných imagí, spusťte příkaz Azure CLI az webapp list-runtimes --os linux. Pokud tyto image nevyhovují vašim potřebám, můžete vytvořit a nasadit vlastní image.

V tomto kurzu se naučíte:

Dokončením tohoto kurzu se v účtu Azure pro registr kontejneru účtují malé poplatky a pokud kontejner hostujete déle než měsíc, může se vám účtovat více nákladů.

Nastavení počátečního prostředí

Tento kurz vyžaduje verzi 2.0.80 nebo novější azure CLI. Pokud používáte Azure Cloud Shell, je už nainstalovaná nejnovější verze.

• Mít účet Azure s aktivním předplatným. Vytvoření účtu zdarma

• Použijte prostředí Bash v Azure Cloud Shellu. Další informace najdete v tématu Rychlý start pro Bash v Azure Cloud Shellu.

  

• Pokud dáváte přednost místnímu spouštění referenčních příkazů rozhraní příkazového řádku, nainstalujte Azure CLI. Pokud používáte Windows nebo macOS, zvažte spuštění Azure CLI v kontejneru Docker. Další informace najdete v tématu Jak spustit Azure CLI v kontejneru Dockeru.

  • Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login. Pokud chcete dokončit proces ověřování, postupujte podle kroků zobrazených na terminálu. Další možnosti přihlášení najdete v tématu Přihlášení pomocí Azure CLI.

  • Po zobrazení výzvy nainstalujte rozšíření Azure CLI při prvním použití. Další informace o rozšířeních najdete v tématu Využití rozšíření v Azure CLI.

  • Spuštěním příkazu az version zjistěte verzi a závislé knihovny, které jsou nainstalované. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.

• Nainstalujte Docker, který použijete k sestavení imagí Dockeru. Instalace Dockeru může vyžadovat restartování počítače.

Po instalaci Dockeru otevřete okno terminálu a ověřte, že je docker nainstalovaný:

docker --version

Klonování nebo stažení ukázkové aplikace

Ukázku pro tento kurz můžete získat prostřednictvím git cloneu nebo stažení.

Klonování pomocí Gitu

Naklonujte ukázkové úložiště:

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

Ujistěte se, že zahrnete --config core.autocrlf=input argument, který zaručuje správné konce řádků v souborech, které se používají v kontejneru Linuxu.

Pak přejděte do složky:

cd docker-django-webapp-linux

Stažení z GitHubu

Místo použití git cloneu můžete navštívit https://github.com/Azure-Samples/docker-django-webapp-linux a vybrat >kód LOCAL>Download ZIP.

Rozbalte soubor ZIP do složky s názvem docker-django-webapp-linux.

Pak otevřete okno terminálu ve složce docker-django-webapp-linux .

(Volitelné) Prozkoumání souboru Dockeru

Toto je soubor v ukázce s názvem Dockerfile. Popisuje image Dockeru a obsahuje pokyny ke konfiguraci.

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"]

• První skupina příkazů nainstaluje požadavky aplikace v prostředí.
• Druhá skupina příkazů vytvoří server SSH , který zajišťuje vylepšenou komunikaci zabezpečení mezi kontejnerem a hostitelem.
• Poslední řádek ENTRYPOINT ["init.sh"]vyvolá spuštění init.sh služby SSH a serveru Python.

Místní sestavení a otestování image

1. Spuštěním následujícího příkazu sestavte image:

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

2. Otestujte, že sestavení funguje spuštěním kontejneru Dockeru místně:

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

   Tento docker run příkaz určuje port s argumentem -p a obsahuje název image. -it umožňuje ji zastavit pomocí Ctrl+C.

   Tip

   Pokud používáte Windows a zobrazí se chyba standard_init_linux.go:211: Uživatelský proces exec způsobil ,že takový soubor nebo adresář", init.sh soubor obsahuje místo očekávaných ukončení řádků CRLF. K této chybě dochází v případě, že jste ke klonování ukázkového úložiště použili Git, ale parametr jste vynechali --config core.autocrlf=input . V tomto případě znovu naklonujte úložiště s argumentem --config . Chyba se může zobrazit také v případě, že jste upravili init.sh a uložili ji s koncovkami CRLF. V tomto případě soubor znovu uložte pouze s koncovkami LF.

3. Přejděte a http://localhost:8000 ověřte, že webová aplikace a kontejner fungují správně.

   

I. Vytvoření spravované identity přiřazené uživatelem

Služba App Service může použít výchozí spravovanou identitu nebo spravovanou identitu přiřazenou uživatelem k ověření v registru kontejneru. V tomto kurzu použijete spravovanou identitu přiřazenou uživatelem.

II. Vytvoření registru kontejneru

III. Nahrání ukázkové image do služby Azure Container Registry

V této části nahrajete image do služby Azure Container Registry, kterou bude služba App Service používat později.

1. Z místního terminálu, kde jste vytvořili ukázkovou image, použijte docker login příkaz pro přihlášení k registru kontejneru:

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

   Nahraďte <registry-name> hodnoty z předchozích kroků a <registry-username> nahraďte je. Po zobrazení výzvy zadejte jedno z hesel z předchozí části.

   Stejný název registru použijete ve všech zbývajících krocích tohoto oddílu.

2. Po úspěšném přihlášení označte místní image Dockeru do registru:

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

3. docker push Pomocí příkazu odešlete image do registru:

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

   První nahrání obrázku může trvat několik minut, protože obsahuje základní image. Následné nahrávání je obvykle rychlejší.

   Během čekání můžete dokončit kroky v další části a nakonfigurovat službu App Service tak, aby se nasadí z registru.

IV. Autorizace spravované identity pro registr

Spravovaná identita, kterou jste vytvořili, ještě nemá autorizaci pro načtení z registru kontejneru. V tomto kroku povolíte autorizaci.

V. Vytvoření webové aplikace

VI. Konfigurace webové aplikace

V tomto kroku nakonfigurujete webovou aplikaci následujícím způsobem:

• Nakonfigurujte aplikaci tak, aby odesílala požadavky na port 8000. Ukázkový kontejner naslouchá na portu 8000 pro webové požadavky.
• Řekněte aplikaci, aby používala spravovanou identitu k načtení imagí z registru kontejneru.
• Nakonfigurujte průběžné nasazování z registru kontejneru (každá nabízená image do registru aktivuje vaši aplikaci pro vyžádání nové image). Tato část není nutná, aby vaše webová aplikace načítá z registru kontejneru, ale může dát vaší webové aplikaci vědět, kdy se do registru odešle nová image. Bez něj musíte ručně aktivovat vyžádání image restartováním webové aplikace.

VII. Přechod na webovou aplikaci

Při prvním pokusu o přístup k aplikaci může nějakou dobu trvat, než aplikace odpoví, protože App Service musí stáhnout celou image z registru. Pokud vyprší časový limit prohlížeče, stačí stránku aktualizovat. Po nahrání počáteční image budou následné testy mnohem rychlejší.

VIII. Přístup k diagnostickým protokolům

IX. Úprava kódu aplikace a opětovné nasazení

V této části provedete změnu kódu webové aplikace, znovu sestavíte image a pak ji nasdílíte do registru kontejneru. App Service pak automaticky načte aktualizovanou image z registru, aby se aktualizovala spuštěná webová aplikace.

1. V místní složce docker-django-webapp-linux otevřete soubor app/templates/app/index.html.

2. Změňte první element HTML tak, aby odpovídal následujícímu kódu.

   <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. Uložte provedené změny.

4. Přejděte do složky docker-django-webapp-linux a znovu sestavte image:

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

5. Aktualizujte značku image na latest:

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

   <registry-name> nahraďte názvem vašeho registru.

6. Nasdílení image do registru:

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

7. Po dokončení nasdílení změn imagí webhook oznámí službě App Service oznámení o nabízeném oznámení a služba App Service se pokusí načíst aktualizovanou image. Počkejte několik minut a pak ověřte, že byla aktualizace nasazena, a to tak, že přejdete na https://<app-name>.azurewebsites.net.

X. Připojit se ke kontejneru pomocí SSH

SSH umožňuje vylepšenou komunikaci zabezpečení mezi kontejnerem a klientem. Pokud chcete povolit připojení SSH ke kontejneru, musíte pro něj nakonfigurovat vlastní image. Po spuštění kontejneru můžete otevřít připojení SSH.

Konfigurace kontejneru pro SSH

Ukázková aplikace použitá v tomto kurzu už má v souboru Dockerfile potřebnou konfiguraci, která nainstaluje server SSH a také nastaví přihlašovací údaje. Tato část je pouze informativní. Pokud se chcete připojit ke kontejneru, přejděte k další části.

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 

Soubor Dockerfile také zkopíruje soubor sshd_config do složky /etc/ssh/ a zpřístupňuje port 2222 v kontejneru:

COPY sshd_config /etc/ssh/

# ...

EXPOSE 8000 2222

Port 2222 je interní port přístupný pouze kontejnery v síti mostu privátní virtuální sítě.

Nakonec vstupní skript , init.sh, spustí server SSH.

#!/bin/bash
service ssh start

Otevření připojení SSH ke kontejneru

KSÍ. Vyčištění prostředků

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