Aracılığıyla paylaş

Öğretici: Azure Uygulaması Hizmetine PHP, MySQL ve Redis uygulaması dağıtma

  • Makale

Bu öğreticide, MySQL veritabanına (MySQL için Azure Veritabanı Esnek Sunucu kullanılarak) bağlı Azure Uygulaması Hizmetinde güvenli bir PHP uygulamasının nasıl oluşturulacağı gösterilmektedir. Ayrıca uygulamanızda önbelleğe alma kodunu etkinleştirmek için bir Redis için Azure Cache dağıtacaksınız. Azure Uygulaması Hizmeti, Windows veya Linux'ta kolayca uygulama dağıtabilen yüksek oranda ölçeklenebilir, kendi kendine düzeltme eki uygulamalı bir web barındırma hizmetidir. İşiniz bittiğinde, Linux'ta Azure Uygulaması Hizmeti üzerinde çalışan bir Laravel uygulamasına sahip olursunuz.

Eklenen yeni görevleri gösteren Görev Listesi başlıklı Azure uygulaması örneğinin ekran görüntüsü.

Azure aboneliğiniz yoksa başlamadan önce birücretsiz Azure hesabı oluşturun.

Örnek uygulama

Bu öğreticiyi takip etmek için depodan örnek Laravel uygulamasını 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'de, yerel MySQL veritabanınızdaki ayarları kullanarak veritabanı ayarlarını (, ve DB_PASSWORDgibiDB_DATABASEDB_USERNAME) yapılandırın. Bu örneği çalıştırmak için yerel bir MySQL sunucusuna 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 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ı yapılandırması oluşturur. Oluşturma işlemi için şunları belirteceksiniz:

  • Web uygulamasının Adı. Web uygulamanızın DNS adının bir parçası olarak biçiminde kullanılan addır https://<app-name>.azurewebsites.net.
  • 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.

1. Adım: Azure portalında:

  1. Azure portalının üst kısmındaki arama çubuğuna "web uygulaması veritabanı" yazın.
  2. Market başlığının altında Web Uygulaması + Veritabanı etiketli öğeyi seçin. Doğrudan oluşturma sihirbazına da gidebilirsiniz.

Web Uygulaması + Veritabanı oluşturma sihirbazını bulmak için üst araç çubuğundaki arama kutusunun nasıl kullanılacağını gösteren ekran görüntüsü.

2. Adım:Web Uygulaması + Veritabanı Oluştur sayfasında, formu aşağıdaki gibi doldurun.

  1. Kaynak Grubu → Yeni oluştur'u seçin ve msdocs-laravel-mysql-tutorial adını kullanın.
  2. Bölge → Yakınınızda herhangi bir Azure bölgesi.
  3. msdocs-laravel-mysql-XYZ →, burada XYZ herhangi bir rastgele karakterdir. Bu ad Azure genelinde benzersiz olmalıdır.
  4. PHP 8.2 → çalışma zamanı yığını.
  5. Redis için Azure Cache eklensin mi? → Evet.
  6. Barındırma planı → Basic. Hazır olduğunuzda, daha sonra bir üretim fiyatlandırma katmanına ölçek artırabilirsiniz.
  7. 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.
  8. Gözden geçir ve oluştur’u seçin.
  9. Doğrulama tamamlandıktan sonra Oluştur'u seçin.

Web Uygulaması + Veritabanı sihirbazında yeni bir uygulama ve veritabanını yapılandırmayı gösteren ekran görüntüsü.

3. Adım: Dağıtımın tamamlanması birkaç dakika sürer. Dağıtım tamamlandıktan sonra Kaynağa git düğmesini seçin. Doğrudan App Service uygulamasına yönlendirilirsiniz, ancak aşağıdaki kaynaklar oluşturulur:

  • Kaynak grubu → Oluşturulan tüm kaynaklar için kapsayıcı.
  • App Service planı → App Service için işlem kaynaklarını tanımlar. Temel katmanda 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.
  • Özel uç noktalar , veritabanı sunucusu ve sanal ağdaki Redis önbelleği için Erişim uç noktaları →.
  • ağ arabirimleri → Özel IP adreslerini temsil eder ve özel uç noktaların her biri için bir tane olur.
  • MySQL için Azure Veritabanı Esnek Sunucu → Yalnızca özel uç noktasının arkasından erişilebilir. Sunucuda sizin için bir veritabanı ve kullanıcı oluşturulur.
  • Redis için Azure Cache → Yalnızca özel uç noktasının arkasından erişilebilir.
  • Özel DNS bölgeleri → Sanal ağda veritabanı sunucusunun ve Redis önbelleğinin DNS çözümlemesini etkinleştirin.

Dağıtım işleminin tamamlandığını gösteren ekran görüntüsü.

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

1. Adım: App Service sayfasının sol menüsünde Yapılandırma'yı seçin.

App Service'te yapılandırma sayfasını açmayı gösteren ekran görüntüsü.

2. Adım:

  1. AZURE_MYSQL_ ile başlayan uygulama ayarlarını bulun. Oluşturma sihirbazı tarafından yeni MySQL veritabanından oluşturuldular.
  2. Ayrıca, AZURE_REDIS_ ile başlayan uygulama ayarlarını bulun. Oluşturma sihirbazı tarafından yeni Redis önbelleğinden oluşturuldular. Uygulamanızı ayarlamak için ihtiyacınız olan tek şey bu addır.
  3. İsterseniz, her ayarın sağındaki Düzenle düğmesini seçip değerini görebilir veya kopyalayabilirsiniz. Daha sonra uygulama kodunuzu bu ayarları kullanacak şekilde değiştireceksiniz.

Uygulama ayarının nasıl oluşturulacağını gösteren ekran görüntüsü.

3. Adım:Yapılandırma sayfasının Uygulama ayarları sekmesinde bir CACHE_DRIVER ayar oluşturun:

  1. Yeni uygulama ayarı'nı seçin.
  2. Ad alanına CACHE_DRIVER girin.
  3. Değer alanına redis girin.
  4. Tamam'ı seçin. CACHE_DRIVER zaten Laravel uygulama kodunda kullanılır. Bu ayar, Laravel'e önbelleği olarak Redis'i kullanmasını söyler.

Otomatik oluşturulan bağlantı dizesi nasıl göreceğinizi gösteren ekran görüntüsü.

4. Adım: 3. Adım'da aynı adımları kullanarak aşağıdaki uygulama ayarlarını oluşturun:

  • MYSQL_ATTR_SSL_CA: Değer olarak /home/site/wwwroot/ssl/DigiCertGlobalRootCA.crt.pem kullanın. 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 depoya dahildir.
  • LOG_CHANNEL: Değer olarak stderr kullanın. Bu ayar Laravel'e günlükleri stderr'a yöneltmesini ve bu sayede App Service günlüklerinin kullanımına sunulmasını sağlar.
  • APP_DEBUG: Değer olarak true kullanın. Hata ayıklama modu sayfalarını etkinleştiren bir Laravel hata ayıklama değişkenidir .
  • APP_KEY: Değer olarak base64:Dsz40HWwbCqnq0oxMsjq7fItmKIeBfCBGORfspaI1Kw= kullanın. Bu bir Laravel şifreleme değişkenidir.
  1. Üstteki menü çubuğunda Kaydet'i seçin.
  2. İstendiğinde Devam'ı seçin.

Yapılandırma sayfasında ayarları kaydetmeyi gösteren ekran görüntüsü.

Önemli

Değer APP_KEY burada kolaylık sağlamak için kullanılır. Üretim senaryoları için, komut satırında kullanılarak php artisan key:generate --show dağıtımınız için özel olarak 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şlatıyor. 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.

1. Adım: Yeni bir tarayıcı penceresinde:

  1. GitHub hesabınıza giriş yapın.
  2. Şuraya gidin: https://github.com/Azure-Samples/laravel-tasks
  3. Çatal'ı seçin.
  4. Çatal oluştur'u seçin.

Örnek GitHub deposunun çatalının nasıl oluşturulacağını gösteren ekran görüntüsü.

2. Adım: GitHub sayfasında, tuşa basarak tarayıcıda Visual Studio Code'ı . açın.

GitHub'da Visual Studio Code tarayıcı deneyimini açmayı gösteren ekran görüntüsü.

3. Adım: Tarayıcıda Visual Studio Code'da, gezginde config/database.php açın. mysql bölümünü bulun ve aşağıdaki değişiklikleri yapın:

  1. DB_HOST öğesini AZURE_MYSQL_HOST ile değiştirin.
  2. DB_DATABASE öğesini AZURE_MYSQL_DBNAME ile değiştirin.
  3. DB_USERNAME öğesini AZURE_MYSQL_USERNAME ile değiştirin.
  4. DB_PASSWORD öğesini AZURE_MYSQL_PASSWORD ile değiştirin.
  5. DB_PORT öğesini AZURE_MYSQL_PORT ile değiştirin. Bu AZURE_MYSQL_ ayarların oluşturma sihirbazı tarafından sizin için oluşturulduğunu unutmayın.

Tarayıcıda Visual Studio Code'un ve değiştirilmiş MySQL değişkenlerini içeren açık bir dosyanın gösterildiği ekran görüntüsü.

4. Adım:Yapılandırma/database.php bölümünde Redis cache bölümüne gidin ve aşağıdaki değişiklikleri yapın:

  1. REDIS_HOST öğesini AZURE_REDIS_HOST ile değiştirin.
  2. REDIS_PASSWORD öğesini AZURE_REDIS_PASSWORD ile değiştirin.
  3. REDIS_PORT öğesini AZURE_REDIS_PORT ile değiştirin.
  4. REDIS_CACHE_DB öğesini AZURE_REDIS_DATABASE ile değiştirin.
  5. Aynı bölümde ile 'scheme' => 'tls',bir satır ekleyin. Bu yapılandırma, Laravel'e Redis'e bağlanmak için şifreleme kullanmasını söyler. Bu AZURE_REDIS_ ayarların oluşturma sihirbazı tarafından sizin için oluşturulduğunu unutmayın.

Tarayıcıda Visual Studio Code'un ve değiştirilmiş Redis değişkenlerini içeren açık bir dosyanın gösterildiği ekran görüntüsü.

5. Adım:

  1. Kaynak Denetimi uzantısını seçin.
  2. Metin kutusuna gibi Configure DB & Redis variablesbir işleme iletisi yazın.
  3. İşleme ve Gönderme'yi seçin.

İşlenen ve GitHub'a gönderilen değişiklikleri gösteren ekran görüntüsü.

6. Adım: App Service sayfasının sol menüsünde Dağıtım Merkezi'ni seçin.

App Service'te dağıtım merkezini açmayı gösteren ekran görüntüsü.

7. Adım: Dağıtım Merkezi sayfasında:

  1. Kaynak bölümünde GitHub'ı seçin. GitHub Actions varsayılan olarak derleme sağlayıcısı olarak seçilir.
  2. GitHub hesabınızda oturum açın ve Azure'ı yetkilendirme istemini izleyin.
  3. Kuruluş'ta hesabınızı seçin.
  4. Depo'da laravel-task öğesini seçin.
  5. Dal'da ana'yı seçin.
  6. Üstteki menüde Kaydet'i seçin. App Service, .github/workflows dizinde seçilen GitHub deposuna bir iş akışı dosyası işler.

GitHub Actions kullanarak CI/CD'yi yapılandırmayı gösteren ekran görüntüsü.

8. Adım: Dağıtım Merkezi sayfasında:

  1. Günlükler’i seçin. Dağıtım çalıştırması zaten başlatıldı.
  2. Dağıtım çalıştırmasının günlük öğesinde Günlükleri Derle/Dağıt'ı seçin.

Dağıtım merkezinde dağıtım günlüklerini açmayı gösteren ekran görüntüsü.

9. Adım: 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. GitHub çalıştırmasının Tamamlandı durumunu göstermesini bekleyin. Yaklaşık 15 dakika sürer.

GitHub çalıştırmanın devam etmekte olduğunu gösteren ekran görüntüsü.

4 - Veritabanı şeması oluşturma

Oluşturma sihirbazı, MySQL veritabanı sunucusunu ö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.

1. Adım: App Service sayfasında, soldaki menüdeN SSH'yi seçin.

Azure portalından uygulamanız için SSH kabuğunu açmayı gösteren ekran görüntüsü.

2. Adım: SSH terminalinde:

  1. cd /home/site/wwwroot'i çalıştırın. Dağıtılan tüm dosyalarınız aşağıdadır.
  2. php artisan migrate --force'i çalıştırın. Başarılı olursa, App Service MySQL veritabanına başarıyla bağlanıyor. Yalnızca içindeki dosyalarda /home yapılan değişiklikler uygulama yeniden başlatmalarının ötesinde kalıcı olabilir. dışındaki /home değişiklikler kalıcı olmaz.

SSH kabuğunda çalıştırılacak komutları ve bunların çıkışını gösteren ekran görüntüsü.

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 kapsayıcısı, uygulamanın kök dizininde başlayan Nginx'i kullanır. Site kökünü değiştirmek için PHP 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 belirtildiği gibi, değişiklik dışında /home olduğundan ve bir uygulama yeniden başlatıldıktan sonra kaybolacağından bu dosyayı SSH kabuğunu kullanarak değiştirmek istemezsiniz.

1. Adım:

  1. Soldaki menüden Yapılandırma'yı seçin.
  2. Genel ayarlar sekmesini seçin.

App Service'in yapılandırma sayfasında genel ayarlar sekmesini açmayı gösteren ekran görüntüsü.

2. Adım: Genel ayarlar sekmesinde:

  1. Başlangıç Komutu kutusuna şu komutu girin: cp /home/site/wwwroot/default /etc/nginx/sites-available/default && service nginx reload.
  2. Kaydet'i seçin. komutu PHP kapsayıcısındaki 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 kapsayıcıda aynı değişikliğin yapılmasını sağlar.

App Service'te başlangıç komutunu yapılandırmayı gösteren ekran görüntüsü.

6 - Uygulamaya göz atın

1. Adım: App Service sayfasında:

  1. Sol menüden Genel Bakış'ı seçin.
  2. Uygulamanızın URL'sini seçin. Doğrudan adresine https://<app-name>.azurewebsites.netde gidebilirsiniz.

Azure portalından App Service başlatmayı gösteren ekran görüntüsü.

2. Adım: Listeye birkaç görev ekleyin. Tebrikler, Azure Uygulaması Hizmeti'nde güvenli bir veri temelli PHP uygulaması çalıştırıyorsunuz.

App Service'te çalışan Laravel uygulamasının ekran görüntüsü.

İpucu

Örnek uygulama, edilgen önbellek düzenini uygular. Veri değişiklikleri yaptıktan sonra sayfayı yeniden yüklerken, verileri veritabanı yerine önbellekten yüklediğinden web sayfasındaki Yanıt süresi çok daha hızlı bir zaman gösterir.

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

Azure Uygulaması Hizmeti, uygulamanızla ilgili sorunları tanılamanıza yardımcı olmak için konsola kaydedilen tüm iletileri yakalar. Örnek uygulama, bu özelliği göstermek için uç noktalarının her birinde konsol günlük iletilerinin çıkışını alır. Varsayılan olarak, Laravel'in günlük işlevi (örneğin, Log::info()) yerel bir dosyaya çıkış oluşturur. Önceki uygulama ayarlarınız LOG_CHANNEL , günlük girişlerine App Service günlük akışından erişilebilir hale getirir.

1. Adım: App Service sayfasında:

  1. Sol menüden App Service günlükleri'ni seçin.
  2. Uygulama günlüğü'nin altında Dosya Sistemi'ne tıklayın.

Azure portalında App Service'te yerel günlükleri etkinleştirmeyi gösteren ekran görüntüsü.

2. Adım: Soldaki menüden Günlük akışı'nı seçin. Kapsayıcının içinden platform günlükleri ve günlükler de dahil olmak üzere uygulamanızın günlüklerini görürsünüz.

Azure portalında günlük akışını görüntülemeyi gösteren ekran görüntüsü.

Kaynakları temizleme

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

1. Adım: Azure portalının üst kısmındaki arama çubuğunda:

  1. Kaynak grubu adını girin.
  2. Kaynak grubunu seçin.

Azure portalında kaynak grubu arama ve bu gruba gitme adımlarını gösteren ekran görüntüsü.

2. Adım: Kaynak grubu sayfasında Kaynak grubunu sil'i seçin.

Azure portalında Kaynak Grubunu Sil düğmesinin konumunu gösteren ekran görüntüsü.

3. Adım:

  1. Silme işleminizi onaylamak için kaynak grubu adını girin.
  2. Sil'i seçin.

Azure portalında kaynak grubunu silmeye yönelik onay iletişim kutusunun ekran görüntüsü. :

Sık sorulan sorular

Bu kurulumun maliyeti ne kadardır?

Kaynak oluşturma fiyatlandırması aşağıdaki gibidir:

  • App Service planı Temel katmanda oluşturulur ve ölçeği artırılabilir veya azaltılabilir. Bkz. App Service fiyatlandırması.
  • MySQL esnek sunucusu 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ı fiyatlandırma.
  • Redis için Azure Cache temel katmanda en düşük önbellek boyutuyla oluşturulur. Bu katmanla ilişkili küçük bir maliyet vardır. Daha yüksek kullanılabilirlik, kümeleme ve diğer özellikler için ölçeğini daha yüksek performans katmanlarına artırabilirsiniz. Bkz. Redis için Azure Cache fiyatlandırma.
  • 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ı.

Nasıl yaparım? diğer araçlarla sanal ağın arkasında güvenliği sağlanan MySQL veritabanına bağlanın?

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'ten otomatik olarak oluşturulan iş akışı dosyası, derleme ve sonra dağıtma, iki iş çalıştırmasını tanımlar. Her iş kendi temiz ortamında çalıştığından, iş akışı dosyası işin işten dosyalara erişmesini build sağlardeploy:

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

İki işli işlem tarafından geçen sürenin çoğu yapıtları karşıya yüklemek ve indirmek için harcanmıştı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.

Sonraki adımlar

Özel bir etki alanı ve sertifikayla uygulamanızın güvenliğini sağlamayı öğrenmek için sonraki öğreticiye ilerleyin.

  Özel etki alanı ve sertifika ile güvenli

Alternatif olarak, diğer kaynaklara da göz atın:

PHP uygulamasını yapılandırma