Aracılığıyla paylaş

Hızlı Başlangıç: GitHub Codespaces'tan Azure Geliştirici CLI şablonu kullanarak Azure Python web uygulaması oluşturma ve dağıtma

Bu hızlı başlangıç, Azure Python web ve veritabanı çözümü oluşturmanın ve dağıtmanın en kolay ve en hızlı yolu boyunca size yol gösterir. Bu hızlı başlangıçtaki yönergeleri izleyerek:

  • Python web çerçevesini, Azure veritabanı platformunu ve Azure web barındırma platformunu temel alan bir Azure Geliştirici CLI (azd) şablonu seçin.
  • Seçtiğiniz azd şablonundan oluşturulan kodu içeren yeni bir GitHub Codespace oluşturun.
  • GitHub Codespaces ve çevrimiçi Visual Studio Code bash terminalini kullanın. Terminal, Azure Geliştirici CLI komutlarını kullanarak bir azd şablonu çalıştırarak örnek bir web uygulaması ve veritabanı oluşturmanıza ve gerekli Azure kaynaklarını oluşturup yapılandırmanıza, ardından örnek web uygulamasını Azure'a dağıtmanıza olanak tanır.
  • Web uygulamasını bir GitHub Codespace içinde düzenleyin ve yeniden dağıtmak için bir azd komutu kullanın.
  • Azure kaynaklarını temizlemek için bir azd komutu kullanın.
  • GitHub Codespace'inizi kapatıp yeniden açın.
  • Yeni kodunuzu bir GitHub deposunda yayımlayın.

Bu eğitimi tamamlamak 25 dakikadan az sürmelidir. Tamamlandıktan sonra, özel kodunuzla yeni projeyi değiştirmeye başlayabilirsiniz.

Python web uygulaması geliştirmeye yönelik bu azd şablonları hakkında daha fazla bilgi edinmek için bkz:

Önkoşullar

Önemli

Hem Codespaces hem de Azure GitHub ücretli abonelik tabanlı hizmetlerdir. Bazı ücretsiz hizmetlerden sonra bu hizmetleri kullandığınız için ücretlendirilebilirsiniz. Bu hızlı başlangıç, bu tahsisatlar veya faturalamayı etkileyebilir. Mümkün olduğunda şablonlar azd en düşük maliyetli seçenek katmanını kullanır, ancak bazıları ücretsiz olmayabilir. Maliyetleri daha iyi anlamak için Azure Fiyatlandırma hesaplayıcısı kullanın. Daha fazla bilgi için bkz. GitHub Codespaces pricing.

Şablon seçme ve kod alanı oluşturma

Python web çerçevesi, Azure web barındırma platformu ve üzerinde oluşturmak istediğiniz Azure veritabanı platformunu temel alan bir azd şablonu seçin.

  1. Aşağıdaki şablon listesinden, yeni web uygulamanızda kullanmak istediğiniz teknolojileri kullanan bir şablon seçin.

    Şablon Web Çerçevesi Veritabanı Barındırma Platformu Yeni Codespace
    azure-django-postgres-flexible-aca Django PostgreSQL Esnek Sunucusu Azure Container Apps Yeni Codespace
    azure-django-postgres-flexible-appservice Django PostgreSQL Esnek Sunucusu Azure App Service Yeni Codespace
    Azure-Django-Cosmos-Postgres-ACA Django Cosmos DB (PostgreSQL Bağdaştırıcısı) Azure Container Apps Yeni Codespace
    azure-django-cosmos-postgres-uygulama servisi Django Cosmos DB (PostgreSQL Bağdaştırıcısı) Azure App Service Yeni Codespace
    Azure-Django-Postgres-Eklenti-ACA Django Azure Container Apps PostgreSQL Eklentisi Azure Container Apps Yeni Codespace

  1. Kolaylık olması için, her tablonun son sütunu yeni bir Codespace oluşturan ve GitHub hesabınızda azd şablonunu başlatan bir bağlantı içerir. Seçtiğiniz şablon adının yanındaki Yeni Codespace bağlantısına sağ tıklayın ve kurulum işlemini başlatmak için Yeni sekmede aç'ı seçin.

    Bu işlem sırasında, GitHub hesabınızda oturum açmanız istenebilir. Ayrıca Codespace'i oluşturmak istediğinizi onaylamanız istenir. Codespace'ınızı ayarlama sayfasını görmek için Codespace Oluştur düğmesini seçin.

  2. Birkaç dakika sonra, Visual Studio Code web tabanlı bir sürümü yeni bir tarayıcı sekmesine yüklenir ve Python web şablonu Gezgin görünümünde çalışma alanı olarak yüklenir.

Azure için kimlik doğrulaması yapın ve azd şablonunu dağıtın

Yeni oluşturulan kodu içeren bir GitHub Codespace'iniz olduğuna göre, kodu Azure yayımlamak için Codespace içindeki azd yardımcı programını kullanın.

  1. Web tabanlı Visual Studio Code terminal varsayılan olarak açıktır. Değilse, terminali açmak için tilde ~ tuşunu kullanın. Varsayılan olarak, terminal bir bash terminalidir. Değilse, terminal penceresinin sağ üst kısmında bash olarak değiştirin.

  2. Bash terminaline aşağıdaki komutu girin:

    azd auth login

    azd auth login Codespace'inizin kimliğini Azure hesabınızda doğrulamaya başlar.

    Start by copying the next code: XXXXXXXXX
Then press enter and continue to log in from your browser...

Waiting for you to complete authentication in the browser...

  3. Aşağıdaki yönergeleri izleyin:

    • Oluşturulan kodu kopyalama
    • Yeni bir tarayıcı sekmesi açmak için Enter'ı seçme ve kodu metin kutusuna yapıştırma
    • Listeden Azure hesabınızı seçme
    • Microsoft Azure CLI'da oturum açmaya çalıştığınızı onaylama

  4. Başarılı olduğunda, terminaldeki Codespaces sekmesinde aşağıdaki ileti yeniden görüntülenir:

    Device code authentication completed.
Logged in to Azure.

  5. Aşağıdaki komutu girerek yeni uygulamanızı Azure dağıtın:

    azd up

    Bu işlem sırasında şunları gerçekleştirmeniz istenir:

    • Yeni bir ortam adı girin
    • Kullanmak üzere bir Azure Aboneliği seçin [Taşımak için okları kullanın, filtreleme yapmak için yazın]
    • Kullanılacak Azure konumu seçin: [Taşımak için okları kullanın, filtrelemek için yazın]

    Bu soruları yanıtladıktan sonra azd çıktısı dağıtımın ilerlediğini gösterir.

    Önemli

    azd up başarıyla tamamlandığında, örnek web uygulaması genel İnternet'te kullanılabilir ve Azure Aboneliğiniz oluşturulan tüm kaynaklar için ücret tahakkuk eder. Şablonları oluşturanlar, ücretsiz katmanların azd genellikle kullanılabilirliği kısıtlanmış olduğundan, kasıtlı olarak uygun maliyetli katmanları seçtiler ancak ücretsiz katmanları seçmeleri zorunlu değildir. Örnek web uygulamasıyla çalışmayı bitirdiğinizde, azd up tarafından oluşturulan tüm hizmetleri kaldırmak için azd down kullanın.

    Ödeme için kullanılacak Azure Aboneliği seçmeniz istendiğinde yönergeleri izleyin ve ardından kullanılacak Azure konumu seçin. Coğrafi olarak size yakın bir bölge seçin.

    azd up yürütüldüğünde, birden çok Azure hizmetinin sağlanıp dağıtılması birkaç dakika sürebilir. İlerleme durumu görüntülendiğinde hataları izleyin. Hatalar görürseniz, bu belgenin en altındaki Sorun Giderme bölümüne bakın.

  6. azd up Başarıyla tamamlandığında benzer çıkış görüntülenir:

    (✓) Done: Deploying service web
- Endpoint: https://xxxxx-xxxxxxxxxxxxx-ca.example-xxxxxxxx.westus.azurecontainerapps.io/

SUCCESS: Your application was provisioned and deployed to Azure in 11 minutes 44 seconds.
You can view the resources created under the resource group xxxxx-rg in Azure portal:
https://portal.azure.com/#@/resource/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/xxxxx-rg/overview

    Varsayılan bir ekran veya hata ekranı görürseniz uygulama başlatılıyor olabilir. Sorun gidermeden önce sorunun kendi kendine çözülip çözülmediğini görmek için 5-10 dakika bekleyin.

    1. Ctrl tuşunu basılı tutarak - Endpoint: sözcüğünden sonraki ilk URL'ye tıklayarak Azure'da canlı çalışan örnek web uygulaması projesini görebilirsiniz.

  7. Azure portalında sağlanan kaynakları görüntülemek için Ctrl tuşunu basılı tutarak önceki adımdaki ikinci URL'ye tıklayın.

Düzenleme ve yeniden dağıtma

Ardından, web uygulamasında küçük bir değişiklik yapın ve sonra yeniden dağıtın.

  1. Visual Studio Code içeren tarayıcı sekmesine geri dönün. src/templates klasörüne gitmek için Visual Studio Code Explorer görünümünü kullanın. index.html dosyasını açın. Aşağıdaki kod satırını bulun:

    <h1 id="page-title">Welcome to ReleCloud</h1>

    H1 içindeki metni değiştirin:

    <h1 id="page-title">Welcome to ReleCloud - UPDATED</h1>

    Kodunuz siz yazarken kaydedilir.

  2. Değişikliğinizle uygulamayı yeniden dağıtmak için terminalde aşağıdaki komutu çalıştırın:

    azd deploy

  3. Komut tamamlandığında, güncelleştirmeyi görmek için Tarayıcı sekmesini ReleCloud web sitesiyle yenileyin. Kullandığınız web barındırma platformuna bağlı olarak, değişikliklerinizin görünmesi birkaç dakika sürebilir.

    Artık şablondaki dosyaları düzenlemeye ve silmeye hazırsınız. Daha fazla bilgi için bkz. Şablonda neleri düzenleyebilir veya silebilirim?

Kaynakları temizle

azd down komutunu çalıştırarak şablonun oluşturduğu kaynakları temizleyin.

azd down

azd down komutu Azure kaynaklarını ve GitHub Actions iş akışını siler. İstendiğinde, kaynak grubuyla ilişkili tüm kaynakları silmeyi kabul edin.

İsteğe bağlı: Codespace'inizi bulma

Bu bölümde kodunuzun codespace'te geçici olarak nasıl çalıştığı ve kısa süreli olarak nasıl kalıcı olduğu gösterilmektedir. Kod üzerinde çalışmaya devam etmek istiyorsanız, kodu yeni bir depoda yayımlayın.

  1. Bu Hızlı Başlangıç makalesi ile ilgili tüm sekmeleri kapatın veya web tarayıcınızı tamamen kapatın.

  2. Web tarayıcınızı ve yeni bir sekmeyi açın ve adresine https://github.com/codespacesgidin.

  3. Alt kısımda en son Codespaces listesini görürsünüz. "Azure-Samples'a ait" başlıklı bölümde oluşturduğunuz bölümü arayın.

  4. Bu Codespace öğesinin bağlam menüsünü görüntülemek için sağındaki elipsi seçin. Buradan codespace'i yeniden adlandırabilir, yeni bir depoda yayımlayabilir, makine türünü değiştirebilir, codespace'i durdurabilir ve daha fazlasını yapabilirsiniz.

İsteğe bağlı: Codespaces'tan GitHub deposu yayımlama

Bu noktada, azd şablonundan oluşturulan yeni kodunuzla Visual Studio Code geliştirme ortamınızı çalıştıran GitHub tarafından barındırılan bir kapsayıcı olan bir Codespace'iniz vardır. Ancak kod bir GitHub deposunda depolanmaz. Kod üzerinde çalışmaya devam etmek istiyorsanız, kodu bir depoda depolamaya öncelik verme.

  1. Kod alanının bağlam menüsünden Yeni bir depoya yayımla'yı seçin.
  2. Yeni bir depoda yayımla iletişim kutusunda yeni deponuzu yeniden adlandırın ve bunun genel veya özel depo olmasını isteyip istemediğinizi seçin. Depo oluştur'u seçin.
  3. Birkaç dakika sonra depo oluşturulur ve bu Hızlı Başlangıçta daha önce oluşturduğunuz kod yeni depoya gönderilir. Yeni depoya gitmek için Depoyu gör düğmesini seçin.
  4. Kodu yeniden açmak ve düzenlemeye devam etmek için yeşil "<> Kod" açılan listesini seçin, Codespaces sekmesine geçin ve daha önce üzerinde çalıştığınız Codespace'in adını seçin. Codespace Visual Studio Code geliştirme ortamınıza geri dönersiniz.
  5. Yeni dallar oluşturmak ve kodunuzda yeni değişiklikler hazırlamak ve işlemek için Kaynak Denetimi bölmesini kullanın.

Sorun giderme

sırasında azd uphatalar görürseniz aşağıdaki adımları deneyin:

  • komutunun oluşturduğu kaynakları kaldırmak için komutunu çalıştırın azd down . Alternatif olarak, Azure portalında oluşturduğunuz kaynak grubunu silebilirsiniz.
  • GitHub hesabınızın Codespaces sayfasına gidin, bu Hızlı Başlangıç sırasında oluşturulan Codespace'ı bulun, sağdaki üç noktayı seçin ve bağlam menüsünden Delete seçin.
  • Azure portalında Anahtar Kasaları'nı arayın. Silinen kasaları yönet'i seçin, aboneliğinizi seçin, azdtest adını veya ortamınızı adlandırdığınız her şeyi içeren tüm anahtar kasalarını seçin ve Temizle'yi seçin.
  • Bu hızlı başlangıçtaki adımları yeniden deneyin. Bu kez istendiğinde ortamınız için daha basit bir ad seçin. Kısa bir ad deneyin, küçük harf kullanın, sayı, büyük harf ve özel karakterlerden kaçının.
  • Hızlı başlangıç adımlarını yeniden denerken farklı bir konum seçin.

Olası sorunların ve çözümlerin daha kapsamlı bir listesi için bkz. SSS.

İlgili içerik

  • Last updated on