Öğretici: Kaynak kodu derleme ve Azure Container Apps'e dağıtma

Bu makalede, tercih ettiğiniz programlama dilinde makinenizdeki kaynak koddan Azure Container Apps'e uygulama derleme ve dağıtma adımları gösterilmektedir.

Bu öğreticide şunlarız:

• Basit bir web uygulaması oluşturun.
• Uygulamanız için ilişkili bir Dockerfile oluşturun.
• Derlenen koddan bir görüntü oluşturun ve bunu bir kapsayıcı kayıt defterine gönderin.
• Kapsayıcı kayıt defterinize güvenli bir şekilde erişmek için yönetilen kimliği kullanın.
• Kapsayıcınızı Azure Container Apps'e dağıtın.
• Dağıtımı doğrulamak için uygulamanızı tarayıcıda görüntüleyin.

Önkoşullar

Bu projeyi tamamlamak için aşağıdaki öğeler gerekir:

Gereksinim	Yönergeler
Azure hesabı	Hesabınız yoksa ücretsiz bir hesap oluşturun. Devam etmek için Azure aboneliğinde Katkıda Bulunan veya Sahip iznine sahip olmanız gerekir. Ayrıntılar için Bkz. Azure portalını kullanarak Azure rolleri atama.
Azure CLI	Azure CLI'yi yükleyin veya en son sürüme yükseltin. Azure Geliştirici CLI'sı (azd komutlar), Azure CLI aracılığıyla kullanılabilir.

Dil seçiminize bağlı olarak uygun çalışma zamanını, SDK'yı ve diğer bağımlılıkları da yüklemeniz gerekebilir.

C#

.NET SDK'sını yükleyin.

Java

• Java Geliştirme Seti'ni yükleyin.

• Apache Maven'ı yükleyin.

JavaScript

Node.js’yi yükleyin.

Python

Python'ı yükleyin.

Yerel uygulamayı oluşturma

Aşağıdaki adımlarda, Azure Container Apps'te dağıtılacak örnek bir uygulama oluşturmak için gereken kod ve bağımlılıklar gösterilmektedir.

Not

Listelenenlerden farklı bir dil kullanmak istiyorsanız tercih ettiğiniz yapay zeka modeline aşağıdaki istemi girin.

İstemi göndermeden önce öğesini seçtiğiniz dille değiştirin <LANGUAGE> .

Generate the simplest possible "hello world" web server in idiomatic <LANGUAGE>.

Make sure to include any dependencies required for the application to run locally and in production. 

1. Kaynak kodunuzu oluşturun ve çalıştırın.

   C#

   Yeni bir C# projesi oluşturun.

   dotnet new webapp --name MyAcaDemo --language C#
   

   MyAcaDemo klasörüne geçin.

   cd MyAcaDemo
   

   Bir kod düzenleyicisinde açın Program.cs ve içeriğini aşağıdaki kodla değiştirin.

   public class Program
   {
       public static void Main(string[] args)
       {
           CreateHostBuilder(args).Build().Run();
       }
   
       public static IHostBuilder CreateHostBuilder(string[] args) =>
           Host.CreateDefaultBuilder(args)
               .ConfigureWebHostDefaults(webBuilder =>
               {
                   webBuilder.UseStartup<Startup>();
                   webBuilder.UseUrls("http://*:8080");
               });
   }
   

   sınıfını Program bu kodla uygulamak bir web uygulamasının temelini oluşturur. Ardından, bir web sayfasını yanıt olarak döndürmekten sorumlu bir sınıf oluşturun.

   Aynı klasörde adlı Startup.cs yeni bir dosya oluşturun ve aşağıdaki kodu girin.

   public class Startup
   {
       public void ConfigureServices(IServiceCollection services)
       {
       }
   
       public void Configure(IApplicationBuilder app)
       {   
           app.UseRouting();
   
           app.UseEndpoints(endpoints =>
           {
               endpoints.MapGet("/", async context =>
               {
                   await context.Response.WriteAsync("Hello World!");
               });
           });
       }
   }
   

   Artık web uygulamanıza bir istek gönderildiğinde "Merhaba Dünya!" metni döndürülür. Kodunuzun yerel makinenizde doğru şekilde çalıştığını doğrulamak için projenizi yayın yapılandırmasında derleyin.

   dotnet build -c Release
   

   Ardından kodunuzun doğru uygulandığını doğrulamak için uygulamanızı çalıştırın.

   dotnet run --configuration Release
   

   Java

   İlk olarak aşağıdaki komutu kullanarak Spring Boot başlangıç uygulamasını getirerek yeni bir Java uygulaması oluşturun.

   curl https://start.spring.io/starter.zip -d dependencies=web -d name=MyAcaDemo -d artifactId=MyAcaDemo -d baseDir=MyAcaDemo -o MyAcaDemo.zip
   

   unzip Komutunu yüklemediyseniz şimdi yükleyebilirsiniz.

   sudo apt-get update && sudo apt-get install unzip
   

   Şimdi paketi MyAcaDemo adlı bir klasöre açabilirsiniz.

   unzip MyAcaDemo.zip -d MyAcaDemo
   

   Bu paketin sıkıştırmasını açarken, MyAcaDemo adlı bir klasörün MyAcaDemo adlı dış klasörde yaşadığı iç içe bir klasör yapısı oluşturur.

   Doğru MyAcaDemo klasörüne geçmek için aşağıdaki komutu kullanın.

   cd MyAcaDemo/MyAcaDemo
   

   Bazı dosyaları ekleyip düzenleyebilmeniz için bu klasörü bir kod düzenleyicisinde açın.

   klasörüne src/main/java/com/example/MyAcaDemo/ adlı MyAcaDemoController.java bir dosya oluşturun ve aşağıdaki kodu girin.

   package com.example.MyAcaDemo;
   
   import org.springframework.web.bind.annotation.GetMapping;
   import org.springframework.web.bind.annotation.RestController;
   
   @RestController
   public class MyAcaDemoController {
       @GetMapping("/")
       public String hello() {
           return "Hello, World!";
       }
   }
   

   MyAcaDemo klasöründe adlı pom.xml bir dosya oluşturun ve aşağıdaki kodu ekleyin.

   <project xmlns="http://maven.apache.org/POM/4.0.0"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
       <modelVersion>4.0.0</modelVersion>
       <groupId>com.example</groupId>
       <artifactId>MyAcaDemo</artifactId>
       <version>0.0.1-SNAPSHOT</version>
       <name>MyAcaDemo</name>
       <description>Demo project for Spring Boot</description>
       <parent>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-parent</artifactId>
           <version>3.1.0</version>
           <relativePath/> <!-- lookup parent from repository -->
       </parent>
       <properties>
           <java.version>17</java.version>
       </properties>
       <dependencies>
           <dependency>
               <groupId>org.springframework.boot</groupId>
               <artifactId>spring-boot-starter-web</artifactId>
           </dependency>
           <dependency>
               <groupId>org.springframework.boot</groupId>
               <artifactId>spring-boot-starter-test</artifactId>
               <scope>test</scope>
           </dependency>
       </dependencies>
       <build>
           <plugins>
           <plugin>
               <groupId>org.springframework.boot</groupId>
               <artifactId>spring-boot-maven-plugin</artifactId>
               <version>3.1.0</version>
               <configuration>
                   <mainClass>com.example.MyAcaDemo.MyAcaDemoApplication</mainClass>
               </configuration>
           </plugin>
           </plugins>
       </build>
   </project>
   

   Projenizin hatasız derlendiğini doğrulamak için aşağıdaki komutu çalıştırın.

   mvn clean package -DskipTests
   

   Başarılı bir derlemeye sahip olduktan sonra, uygulamanın makinenizde doğru çalıştığından emin olmak için aşağıdaki komutu çalıştırın.

   mvn spring-boot:run
   

   JavaScript

   Tanıtım uygulamasının dosyalarını tutmak için MyAcaDemo adlı bir klasör oluşturun.

   mkdir MyAcaDemo
   

   Ardından MyAcaDemo klasörüne geçin.

   cd MyAcaDemo
   

   Node.js bir uygulamanın temel dosyalarını oluşturmak için aşağıdaki komutu kullanın.

   npm init -y
   

   Bu klasörü bir kod düzenleyicisinde açın ve aşağıdaki kodla adlı index.js bir dosya oluşturun.

   const http = require('http');
   
   const server = http.createServer((req, res) => {
       res.writeHead(200, { 'Content-Type': 'text/html' });
       res.end('<html>Hello World!</html>');
   });
   
   server.listen(8080, () => {
       console.log('Server running at http://localhost:8080/');
   });
   

   Artık aşağıdaki komutu çalıştırarak uygulamanın makinenizde doğru çalıştığından emin olabilirsiniz.

   node index.js
   

   Python

   MyAcaDemo adlı bir klasör oluşturun.

   mkdir MyAcaDemo
   

   MyAcaDemo klasörüne geçin.

   cd MyAcaDemo
   

   Aşağıdaki komutu kullanarak Flask'i yükleyin.

   pip install flask
   

   Örnek uygulama Flask çerçevesini temel alır. Uygulamanızı buluta dağıtmaya çalışmadan önce makinenizde doğru şekilde çalıştığını doğrulayabilmeniz için yerel olarak yüklenmesi gerekir.

   adlı app.py yeni bir dosya oluşturun ve aşağıdaki kodu girin.

   from flask import Flask
   
   app = Flask(__name__)
   
   @app.route('/')
   def hello_world():
       return '<html>Hello World!</html>'
   
   if __name__ == '__main__':
       app.run()
   

   Bu kod, Merhaba Dünya! döndüren temel bir web sunucusu oluşturur.

   Aynı klasörde adlı requirements.txt yeni bir dosya oluşturun ve aşağıdaki kodu girin.

   Flask
   gunicorn
   

   Bu dosya Python çalışma zamanına örnek uygulamayı barındırmak için Flask web framework ve gunicorn web sunucusunu kullanma talimatı verir.

   Uygulamanın düzgün çalıştığını doğrulamak için aşağıdaki komutu çalıştırın.

   python3 app.py
   

   Uygulamanın beklendiği gibi çalıştığını doğruladıktan sonra yerel sunucuyu durdurabilir ve uygulamayı Container Apps'e dağıtabilmek için dockerfile oluşturmaya geçebilirsiniz.

2. MyAcaDemo klasöründe adlı Dockerfile bir dosya oluşturun ve aşağıdaki içeriği ekleyin.

   C#

   FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
   WORKDIR /src
   COPY . .
   RUN dotnet publish -c Release -o /app/publish
   
   FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS final
   WORKDIR /app
   COPY --from=build /app/publish .
   EXPOSE 8080
   ENTRYPOINT ["dotnet", "MyAcaDemo.dll"]
   

   Java

   FROM maven:3.8.4-openjdk-17 AS build
   WORKDIR /app
   COPY pom.xml .
   COPY src ./src
   RUN mvn clean package -DskipTests
   
   FROM openjdk:17-jdk-alpine
   WORKDIR /app
   COPY --from=build /app/target/MyAcaDemo-0.0.1-SNAPSHOT.jar /app/MyAcaDemo.jar
   EXPOSE 8080
   ENTRYPOINT ["java", "-jar", "MyAcaDemo.jar"]
   

   JavaScript

   FROM node:18
   WORKDIR /usr/src/app
   COPY ./ . 
   RUN npm install
   EXPOSE 3000
   CMD ["node", "index.js"]
   

   Python

   FROM python:3.9-slim
   WORKDIR /app
   COPY . /app
   RUN pip install --no-cache-dir -r requirements.txt
   EXPOSE 8080
   ENV FLASK_APP=app.py
   CMD ["gunicorn", "--bind", "0.0.0.0:8080", "app:app"]
   

   Kodunuz ve dockerfile'ınız hazır olduğuna göre uygulamanızı Azure Container Apps'e dağıtabilirsiniz.

Azure kaynakları oluşturma

1. Aşağıdaki komutla CLI'dan Azure'da oturum açın. Kimlik doğrulama işlemini tamamlamak için tüm istemleri izlediğinden emin olun.

   az login
   

2. Azure CLI için Azure Container Apps uzantısını yükleyin veya güncelleştirin.

   az extension add --name containerapp --upgrade
   

   Not

   Komutları çalıştırdığınızda az containerapp eksik parametrelerle ilgili hatalar alırsanız Azure Container Apps uzantısının en son sürümünü yüklediğinizden emin olun.

3. Azure CLI kurulumunuz tamamlandıktan sonra bir dizi ortam değişkeni tanımlayabilirsiniz.

   Aşağıdaki komutu çalıştırmadan önce sağlanan değerleri gözden geçirin.

   Konum Orta ABD olarak yapılandırılır, ancak isterseniz size en yakın konuma geçebilirsiniz.

   LOCATION="CentralUS"
   RESOURCE_GROUP="my-demo-group"
   IDENTITY_NAME="my-demo-identity"
   ENVIRONMENT="my-demo-environment"
   REGISTRY_NAME="mydemoregistry$(openssl rand -hex 4)"
   CONTAINER_APP_NAME="my-demo-app"
   

   komutu, mydemoregistry$(openssl rand -hex 4) kapsayıcı kayıt defteri adınız olarak kullanmak üzere rastgele bir dize oluşturur. Kayıt defteri adları genel olarak benzersiz olmalıdır, bu nedenle bu dize komutlarınızın başarıyla çalıştırılmasına yardımcı olur.

4. Kapsayıcı uygulaması dağıtımınızla ilgili hizmetleri düzenlemek için bir kaynak grubu oluşturun.

   az group create \
     --name $RESOURCE_GROUP \
     --location $LOCATION \
     --output none
   

5. Kullanıcı tarafından atanan bir yönetilen kimlik oluşturun ve aşağıdaki komutlarla kimliğini alın.

   İlk olarak yönetilen kimliği oluşturun.

   az identity create \
       --name $IDENTITY_NAME \
       --resource-group $RESOURCE_GROUP \
       --output none
   

   Şimdi kimlik tanımlayıcısını daha sonra kullanmak üzere bir değişken olarak ayarlayın.

   IDENTITY_ID=$(az identity show \
     --name $IDENTITY_NAME \
     --resource-group $RESOURCE_GROUP \
     --query id \
     --output tsv)
   

6. Aşağıdaki komutu kullanarak uygulamanızı barındırmak için bir Container Apps ortamı oluşturun.

   az containerapp env create \
       --name $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --location $LOCATION \
       --mi-user-assigned $IDENTITY_ID \
       --output none
   

7. Kaynak grubunuzda bir Azure Container Registry (ACR) örneği oluşturun. Kayıt defteri kapsayıcı görüntünüzü depolar.

   az acr create \
     --resource-group $RESOURCE_GROUP \
     --name $REGISTRY_NAME \
     --sku Basic \
     --output none
   

8. Aşağıdaki komutla kullanıcı tarafından atanan yönetilen kimliğinizi kapsayıcı kayıt defteri örneğine atayın.

   az acr identity assign \
     --identities $IDENTITY_ID \
     --name $REGISTRY_NAME \
     --resource-group $RESOURCE_GROUP \
     --output none
   

Görüntüyü derleme ve kayıt defterine gönderme

Aşağıdaki komutla kapsayıcı görüntünüzü derleyin ve kapsayıcı kayıt defteri örneğine gönderin.

az acr build \
    -t $REGISTRY_NAME".azurecr.io/"$CONTAINER_APP_NAME":helloworld" \
    -r $REGISTRY_NAME .

Bu komut, etiketi helloworld kapsayıcı görüntünüze uygular.

Kapsayıcı uygulamanızı oluşturma

Aşağıdaki komutla kapsayıcı uygulamanızı oluşturun.

az containerapp create \
  --name $CONTAINER_APP_NAME \
  --resource-group $RESOURCE_GROUP \
  --environment $ENVIRONMENT \
  --image $REGISTRY_NAME".azurecr.io/"$CONTAINER_APP_NAME":helloworld" \
  --target-port 8080 \
  --ingress external \
  --user-assigned $IDENTITY_ID \
  --registry-identity $IDENTITY_ID \
  --registry-server $REGISTRY_NAME.azurecr.io \
  --query properties.configuration.ingress.fqdn

Bu komut, rolü kullanıcı tarafından atanan yönetilen kimliğinize ekler acrPull , böylece kapsayıcı kayıt defterinizden görüntü çekebilir.

Aşağıdaki tabloda, bu komut tarafından kullanılan parametreler açıklanmaktadır.

Parametre	Değer	Açıklama
name	$CONTAINER_APP_NAME	Kapsayıcı uygulamanızın adı.
resource-group	$RESOURCE_GROUP	Kapsayıcı uygulamanızın dağıtıldığı kaynak grubu.
environment	$ENVIRONMENT	Kapsayıcı uygulamanızın çalıştığı ortam.
image	$REGISTRY_NAME".azurecr.io/"$CONTAINER_APP_NAME":helloworld"	Kayıt defteri adı ve etiketi dahil olmak üzere dağıtılacak kapsayıcı görüntüsü.
target-port	8080	Uygulamanızın istekler için dinlediği bağlantı noktasıyla eşleşir.
ingress	external	Kapsayıcı uygulamanızı genel İnternet'ten erişilebilir hale getirir.
user-assigned	$IDENTITY_ID	Kapsayıcı uygulamanız için kullanıcı tarafından atanan yönetilen kimlik.
registry-identity	registry-identity	Kapsayıcı kayıt defterine erişmek için kullanılan kimlik.
registry-server	$REGISTRY_NAME.azurecr.io	Kapsayıcı kayıt defterinizin sunucu adresi.
query	properties.configuration.ingress.fqdn	Çıkışı yalnızca uygulamanın tam etki alanı adına (FQDN) göre filtreler.

Bu komut tamamlandıktan sonra yeni web uygulamanızın URL'sini döndürür.

Dağıtımı doğrulama

Uygulamanın URL'sini bir web tarayıcısına kopyalayın. Kapsayıcı uygulaması başlatıldıktan sonra Merhaba Dünya! döndürür.

Uygulamaya ilk kez erişildiğinden, uygulamanın yanıt döndürmesi birkaç dakika sürebilir.

Kaynakları temizleme

Bu öğreticide oluşturulan Azure kaynaklarını kullanmayacaksanız, bunları tek bir komutla kaldırabilirsiniz. Komutu çalıştırmadan önce, bu öğretici serisinde kodunuzda değişiklik yapmayı ve Azure'da uygulamanızı güncelleştirmeyi gösteren bir sonraki adım vardır.

İşiniz bittiyse ve bu öğreticide oluşturulan tüm Azure kaynaklarını kaldırmak istiyorsanız aşağıdaki komutu kullanarak kaynak grubunu silin.

az group delete --name aca-demo

İpucu

Sorun mu yaşıyorsunuz? Azure Container Apps deposunda bir sorun açarak GitHub'da bize bildirin.

Sonraki adımlar

Ardından, oluşturduğunuz kapsayıcı uygulamasını nasıl güncelleştireceğinizi öğrenmek için devam edin.

Kaynak koddan dağıtılan kapsayıcı uygulamasını güncelleştirme