Öğretici: Azure Uygulama Hizmeti'nde PHP (Laravel) ve MySQL için Azure Veritabanı - Esnek Sunucu uygulaması oluşturma

Azure App Service, Linux işletim sistemini kullanan, yüksek düzeyde ölçeklenebilir ve otomatik olarak düzeltme uygulayan bir web barındırma hizmeti sunar. Bu öğreticide, Azure App Service'te bir MySQL veritabanına (MySQL için Azure Veritabanı Esnek Sunucusu kullanılarak) bağlı güvenli bir PHP uygulamasının nasıl oluşturulacağı gösterilmektedir. İşiniz bittiğinde, Linux'ta Azure Uygulaması Hizmeti üzerinde çalışan bir Laravel uygulamanız olur.

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

• Azure'da varsayılan olarak güvenli bir PHP ve MySQL uygulaması oluşturma
• Uygulama ayarlarını kullanarak MySQL için bağlantı gizli bilgilerini yapılandırma
• GitHub Actions kullanarak uygulama kodunu dağıtma
• Uygulamayı güncelleştirme ve yeniden dağıtma
• Veritabanı geçişlerini güvenli bir şekilde çalıştırma
• Azure’daki tanılama günlüklerinin akışını sağlama
• Uygulamayı Azure portalında yönetme

Önkoşullar

• Azure aboneliği Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir Azure hesabı oluşturun. Şu anda ücretsiz Azure hesabıyla 12 ay boyunca MySQL için Azure Veritabanı - Esnek Sunucu ücretsiz sürümünü deneyebilirsiniz. Daha fazla bilgi için bkz. Ücretsiz Azure hesabı kullanarak MySQL için Azure Veritabanı - Esnek Sunucuyu ücretsiz deneme.

Örnek uygulama

Bu öğreticiyi takip etmek için örnek uygulamayı depodan kopyalayın veya indirin:

git clone https://github.com/Azure-Samples/laravel-tasks.git

Uygulamayı yerel olarak çalıştırmak istiyorsanız aşağıdakileri yapın:

• .env dosyasında, yerel MySQL için Azure Veritabanı Flexible Server veritabanınızdaki ayarları kullanarak veritabanı ayarlarını (DB_DATABASE, DB_USERNAME, ve DB_PASSWORD gibi) yapılandırın. Bu örneği çalıştırmak için yerel bir MySQL için Azure Veritabanı Esnek Sunucu örneğine ihtiyacınız vardır.

• Deponun kökünden aşağıdaki komutlarla Laravel'i başlatın:

  composer install
  php artisan migrate
  php artisan key:generate
  php artisan serve
  

1 - App Service ve MySQL için Azure Veritabanı Esnek Sunucu kaynakları oluşturma

Bu adımda Azure kaynaklarını oluşturursunuz. Bu öğreticide kullanılan adımlar, varsayılan olarak güvenli bir App Service ve MySQL için Azure Veritabanı Esnek Sunucu yapılandırması oluşturur. Oluşturma işlemi için şunları belirteceksiniz:

• Web uygulamasının Adı. Bu, web uygulamanızın https://<app-name>.azurewebsites.net biçimindeki DNS adının bir parçası olarak kullanılan addır.
• Uygulama için Çalışma Zamanı . Burası, uygulamanız için kullanılacak PHP sürümünü seçtiğiniz yerdir.
• Uygulamanın Kaynak Grubu . Kaynak grubu, uygulama için gereken tüm Azure kaynaklarını gruplandırmanıza (mantıksal bir kapsayıcıda) olanak tanır.

Azure portalında oturum açın ve Azure Uygulaması Hizmeti kaynaklarınızı oluşturmak için bu adımları izleyin.

Yönergeler	Ekran görüntüsü
Azure portalında: Azure portalının üst kısmındaki arama çubuğuna "web uygulaması veritabanı" yazın. Market başlığının altında Web Uygulaması + Veritabanı etiketli öğeyi seçin. Doğrudan oluşturma yardımcısı öğesine de gidebilirsiniz.
Web Uygulaması + Veritabanı Oluştur sayfasında, formu aşağıdaki gibi doldurun. Kaynak grubu → Yeni oluştur'u seçin ve msdocs-laravel-mysql-tutorial adını kullanın. Bölge → Yakınınızda herhangi bir Azure bölgesi. Ad → msdocs-laravel-mysql-XYZ; burada XYZ rastgele üç karakterdir. Bu ad Azure genelinde benzersiz olmalıdır. Çalışma zamanı yığını → PHP 8.0. MySQL - Esnek Sunucu , veritabanı altyapısı olarak varsayılan olarak sizin için seçilir. MySQL için Azure Veritabanı, Azure'da en son topluluk sürümleriyle uyumlu, tam olarak yönetilen bir hizmet olarak MySQL veritabanıdır. Sizin için oluşturulan veritabanı adını (<app-name-database>) not edin. Buna daha sonra ihtiyacınız olacak. Gözden geçir ve oluştur’u seçin. Doğrulama tamamlandıktan sonra Oluştur'u seçin.
Dağıtımın tamamlanması birkaç dakika sürer ve aşağıdaki kaynakları oluşturur: Kaynak grubu → Oluşturulan tüm kaynaklar için kapsayıcı. App Service planı → App Service için işlem kaynaklarını tanımlar. P1v2 katmanında bir Linux planı oluşturulur. App Service → Uygulamanızı temsil eder ve App Service planında çalışır. Sanal ağ → App Service uygulamasıyla tümleşiktir ve arka uç ağ trafiğini yalıttır. MySQL için Azure Veritabanı - Esnek Sunucu → Yalnızca sanal ağdan erişilebilir. Sunucuda sizin için bir veritabanı ve kullanıcı oluşturulur. Özel DNS bölge → Sanal ağdaki MySQL veritabanı sunucusunun DNS çözümlemesini etkinleştirir. Dağıtım tamamlandıktan sonra Kaynağa git düğmesini seçin. Doğrudan App Service uygulamasına yönlendirilirsiniz.

2 - Veritabanı bağlantısını ayarlama

Oluşturma sihirbazı, veritabanına bağlanmak için kullanabileceğiniz uygulama ayarlarını oluşturdu, ancak henüz kodunuz için kullanılabilecek bir biçimde değil. Bu adımda, uygulama ayarlarını uygulamanızın ihtiyaç duyduğu biçimde düzenler ve güncelleştirirsiniz.

Yönergeler	Ekran görüntüsü
App Service sayfasının sol menüsünde Yapılandırma'yı seçin.
Yapılandırma sayfasının Uygulama ayarları sekmesinde, aşağıdaki ayarların her biri için Düzenle'yi seçin, Ad alanını yeni değerlerle güncelleştirin ve Tamam'ı seçin. Geçerli Ad Yeni Ad AZURE_MYSQL_DBNAME DB_DATABASE AZURE_MYSQL_HOST DB_HOST AZURE_MYSQL_USERNAME DB_USERNAME AZURE_MYSQL_PASSWORD DB_PASSWORD
Yeni MYSQL_ATTR_SSL_CA bir veritabanı ayarı oluşturun: Yeni uygulama ayarı'nı seçin. Ad alanına MYSQL_ATTR_SSL_CA girin. Değer alanına /home/site/wwwroot/ssl/DigiCertGlobalRootG2.crt.pem girin. Bu uygulama ayarı, MySQL sunucusuna erişmek için ihtiyacınız olan TLS/SSL sertifikasının yolunu gösterir. Kolaylık sağlamak için örnek depo bu sertifikayı içerir. Tamam'ı seçin.
Aynı adımları izleyerek aşağıdaki ek uygulama ayarlarını oluşturun ve kaydet'i seçin. APP_DEBUG: Değer olarak true kullanın. Bu bir Laravel hata ayıklama değişkenidir. APP_KEY: base64:Dsz40HWwbCqnq0oxMsjq7fItmKIeBfCBGORfspaI1Kw= değer olarak kullanın. Bu bir Laravel şifreleme değişkenidir. Önemli Bu APP_KEY değer burada kolaylık sağlamak için kullanılır. Üretim senaryoları için, komut satırında php artisan key:generate --show kullanılarak özellikle dağıtımınız için oluşturulmalıdır.

3 - Örnek kodu dağıtma

Bu adımda GitHub Actions'ı kullanarak GitHub dağıtımını yapılandıracaksınız. App Service'e dağıtmanın birçok yolundan yalnızca biridir, aynı zamanda dağıtım sürecinizde sürekli tümleştirmeye sahip olmanın harika bir yoludur. Varsayılan olarak, GitHub deponuzun her git push örneği derleme ve dağıtma eylemini başlatacaktır. Doğrudan tarayıcıda Visual Studio Code ile kod tabanınızda bazı değişiklikler yapacak, ardından GitHub Actions'ın sizin için otomatik olarak dağıtılmasına izin vereceksiniz.

Yönergeler	Ekran görüntüsü
Yeni bir tarayıcı penceresinde: GitHub hesabınıza giriş yapın. Şuraya gidin: https://github.com/Azure-Samples/laravel-tasks Çatal'ı seçin. Çatallama oluştur seçeneğini belirleyin.
GitHub sayfasında, . tuşuna basarak Visual Studio Code'u tarayıcıda açın.
Tarayıcıdaki Visual Studio Code'da, Gezgin'de config/database.php dosyasını açın. mysql bağlantısında, MySQL bağlantısı için daha önce oluşturduğunuz uygulama ayarlarının (DB_HOST, DB_DATABASE, DB_USERNAME, DB_PASSWORD, MYSQL_ATTR_SSL_CA) zaten kullanıldığını görün.
App Service sayfasına geri dönün, soldaki menüde Dağıtım Merkezi'ni seçin.
Dağıtım Merkezi sayfasında: Kaynak bölümünde GitHub'ı seçin. GitHub Actions varsayılan olarak derleme sağlayıcısı olarak seçilir. GitHub hesabınızda oturum açın ve Azure'ı yetkilendirme istemini izleyin. Kuruluş'ta hesabınızı seçin. Depo'da laravel-tasks'ı seçin. Dal içinde main'i seçin. Üstteki menüde Kaydet'i seçin. App Service, .github/workflows dizindeki seçili GitHub deposuna bir iş akışı dosyası işler.
Dağıtım Merkezi sayfasında: Günlükler’i seçin. Bir dağıtım çalıştırması zaten başlatılmış. Dağıtım çalıştırmasının günlük öğesinde Derleme/Dağıtım Günlükleri'ni seçin. GitHub deponuza yönlendirilirsiniz ve GitHub eyleminin çalıştığını görürsünüz. İş akışı dosyası derleme ve dağıtma olarak iki ayrı aşama tanımlar.
Kodunuzda değişiklik yapmak için tarayıcıda Visual Studio Code'a gidin: Kaynak Denetimi uzantısını seçin. Değiştirilen dosyanın yanında, örneğin database.php, değişikliklerinizi hazırlama alanına almak için + öğesini seçin. Metin kutusuna bir işleme iletisi yazın, örneğin add certificate. İşlemek ve GitHub'a göndermek için onay işaretini seçin. Dağıtım Merkezi sayfasına geri dönerseniz, yeni bir çalışma başlatıldığı için yeni bir günlük girdisi görürsünüz. Çalıştırma işleminin tamamlanmasını bekleyin. Yaklaşık 15 dakika sürer. İpucu GitHub eylemi, .github/workflow içindeki GitHub deponuzdaki dosya tarafından tanımlanır. Dosyayı özelleştirerek daha hızlı hale getirebilirsiniz.

4 - Veritabanı şeması oluşturma

Oluşturma sihirbazı, MySQL için Azure Veritabanı Esnek Sunucu örneğini özel bir uç noktanın arkasına yerleştirir, bu nedenle yalnızca sanal ağdan erişilebilir. App Service uygulaması zaten sanal ağ ile tümleşik olduğundan veritabanı geçişlerini veritabanınızla çalıştırmanın en kolay yolu doğrudan App Service kapsayıcısının içindendir.

Yönergeler	Ekran görüntüsü
App Service sayfasında: Soldaki menüden SSH'yi seçin. Git'i seçin. Tarayıcıda App Service kapsayıcınızla bir SSH oturumu başlatılır. İsterseniz bunun yerine doğrudan https://<app-name>.scm.azurewebsites.net/webssh/host adresine gidebilirsiniz.
SSH terminalinde: Uygulama kodunuzun köküne CD: cd /home/site/wwwroot Uygulama kökünden veritabanı geçişlerini çalıştırın. php artisan migrate --force Not Yalnızca /home içindeki dosyalarda yapılan değişiklikler uygulama yeniden başlatıldıktan sonra da kalıcı olabilir. dışındaki /home değişiklikler kalıcı olmaz.

5 - Site kökünü değiştirme

Laravel uygulama yaşam döngüsü bunun yerine /public dizininde başlar. App Service için varsayılan PHP 8.0 kapsayıcısı, uygulamanın kök dizininde başlayan Nginx'i kullanır. Site kökünü değiştirmek için PHP 8.0 kapsayıcısında (/etc/nginx/sites-available/default) Nginx yapılandırma dosyasını değiştirmeniz gerekir. Kolaylık sağlamak için örnek depo varsayılan adlı özel bir yapılandırma dosyası içerir. Daha önce de belirtildiği gibi, bir uygulama yeniden başlatıldıktan sonra değişiklikleriniz kaybolacağından bu dosyayı SSH kabuğunu kullanarak değiştirmek istemezsiniz.

Yönergeler	Ekran görüntüsü
App Service sayfasında: Soldaki menüden Yapılandırma'yı seçin. Genel ayarlar sekmesini seçin.
Genel ayarlar sekmesinde: Başlangıç Komutu kutusuna şu komutu girin: cp /home/site/wwwroot/default /etc/nginx/sites-available/default && service nginx reload. PHP 8.0 kapsayıcısında Nginx yapılandırma dosyasının yerini alır ve Nginx'i yeniden başlatır. Bu yapılandırma, kapsayıcı her başlatıldığında bu değişikliğin kapsayıcıya uygulanmasını sağlar. Kaydet'i seçin.

6 - Uygulamaya göz atın

Yönergeler	Ekran görüntüsü
App Service sayfasında: Sol menüden Genel Bakış'ı seçin. Uygulamanızın URL'sini seçin. Ayrıca doğrudan https://<app-name>.azurewebsites.net adresine de gidebilirsiniz.
Listeye birkaç görev ekleyin. Tebrikler, Azure Uygulaması Hizmeti'nde veri temelli bir PHP uygulaması çalıştırıyorsunuz.

7 - Tanılama günlüklerini akışla aktarma

Yönergeler	Ekran görüntüsü
App Service sayfasında: Sol menüden App Service günlükleri'ni seçin. Uygulama günlüğü altında, Dosya Sistemi'ni seçin.
Sol menüden Günlük akışı seçeneğini belirleyin. Uygulamanızın günlüklerini, platform günlükleri ile kapsayıcı içindeki günlükler dahil, görürsünüz.

Kaynakları temizleme

İşiniz bittiğinde, kaynak grubunu silerek Azure aboneliğinizdeki tüm kaynakları silebilirsiniz.

Yönergeler	Ekran görüntüsü
Azure portalının üst kısmındaki arama çubuğunda: Kaynak grubu adını girin. Kaynak grubunu seçin.
Kaynak grubu sayfasında Kaynak grubunu sil'i seçin.
Silme işleminizi onaylamak için kaynak grubu adını girin. Sil'i seçin.

Sık sorulan sorular

• Bu kurulumun maliyeti ne kadardır?
• Sanal ağın arkasında güvenliği sağlanan MySQL için Azure Veritabanı Esnek Sunucu veritabanına nasıl bağlanabilirim?
• Yerel uygulama geliştirme GitHub Actions ile nasıl çalışır?
• GitHub Actions dağıtımı neden bu kadar yavaş?

Bu kurulumun maliyeti ne kadardır?

Kaynak oluşturma ücretlendirmesi aşağıdaki gibidir:

• App Service planı Premium V2 katmanında oluşturulur ve ölçeği artırılabilir veya azaltılabilir. Bkz. App Service fiyatlandırması.
• MySQL için Azure Veritabanı Esnek Sunucu örneği B1ms katmanında oluşturulur ve ölçeği artırılabilir veya azaltılabilir. Ücretsiz Azure hesabıyla B1ms katmanı, aylık sınırlara kadar 12 ay boyunca ücretsizdir. Bkz. MySQL için Azure Veritabanı Esnek Sunucu fiyatlandırması.
• Eşleme gibi ek işlevler yapılandırmadığınız sürece sanal ağ ücret ödemez. Bkz. Azure Sanal Ağ fiyatlandırması.
• Özel DNS bölgesi küçük bir ücrete tabi. Bkz. Azure DNS fiyatlandırması.

Sanal ağın arkasında güvenliği sağlanan MySQL için Azure Veritabanı Esnek Sunucu veritabanına nasıl bağlanabilirim?

MySQL için Azure Veritabanı Esnek Sunucu veritabanına bağlanmak için, kullanabileceğiniz araçlara ve ortamlara göre çeşitli yöntemler kullanabilirsiniz:

• Komut satırı aracı erişimi:
  • mysql Temel erişim için uygulamanın SSH terminalinden komutunu kullanın.
• Masaüstü araçları (örneğin, MySQL Workbench):
  • Azure CLI ile SSH tüneli kullanma:
    • Azure CLI kullanarak web uygulamasında bir SSH oturumu oluşturun.
    • Trafiği MySQL'e tünel olarak eklemek için SSH oturumunu kullanın.
  • Siteden siteye VPN'yi veya Azure VM'yi kullanma:
    • Makineniz sanal ağın parçası olmalıdır.
    • Aşağıdakileri kullanmayı göz önünde bulundurun:
      • Alt ağlardan birine bağlı bir Azure VM.
      • Azure sanal ağına siteden siteye VPN bağlantısı olan şirket içi ağdaki bir makine.
• Azure Cloud Shell tümleştirmesi:
  • Doğrudan erişim için Azure Cloud Shell'i sanal ağ ile tümleştirin.

Yerel uygulama geliştirme GitHub Actions ile nasıl çalışır?

App Service'ten otomatik olarak oluşturulan iş akışı dosyasını örnek olarak alın; her git push birinde yeni bir derleme ve dağıtım çalıştırması başlar. GitHub deposunun yerel bir kopyasından, istenen güncelleştirmelerin GitHub'a göndermesini sağlarsınız. Örneğin:

git add .
git commit -m "<some-message>"
git push origin main

GitHub Actions dağıtımı neden bu kadar yavaş?

App Service tarafından otomatik olarak oluşturulan iş akışı dosyası, önce derleme sonra dağıtım yapan iki işli bir çalıştırma tanımlar. Her iş kendi temiz ortamında çalıştığından, iş akışı dosyası deploy işinin build işindeki dosyalara erişebilmesini sağlar:

• İşin sonunda build dosyaları artifact olarak yükleyin.
• İşin başında deploy yapıtları indirin.

İki işten oluşan süreçte harcanan sürenin çoğu, artefaktları yükleme ve indirme işlemlerine ayrılır. İsterseniz, iki işi tek bir işte birleştirerek iş akışı dosyasını basitleştirebilir ve bu sayede karşıya yükleme ve indirme adımları gereksinimi ortadan kalkar.

Özet

Bu öğreticide, şunların nasıl yapıldığını öğrendiniz:

• Azure'da varsayılan olarak güvenli bir PHP ve MySQL için Azure Veritabanı Esnek Sunucu uygulaması oluşturma
• Uygulama ayarlarını kullanarak MySQL için Azure Veritabanı Esnek Sunucusu'na bağlantı gizli bilgilerini yapılandır
• GitHub Actions kullanarak uygulama kodunu dağıtma
• Uygulamayı güncelleştirme ve yeniden dağıtma
• Veritabanı geçişlerini güvenli bir şekilde çalıştırma
• Azure’daki tanılama günlüklerinin akışını sağlama
• Uygulamayı Azure portalında yönetme

İlgili içerik

• Öğretici: Özel DNS adını uygulamanıza eşleme
• Azure portalında kaynaklarınızı yönetme
• MySQL için Azure Veritabanı Yönetme - Azure CLI kullanarak Esnek Sunucu