Aracılığıyla paylaş

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

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

  • Python web çerçevesini, Azure veritabanı platformunu ve üzerinde derlemek istediğiniz Azure web barındırma platformunu temel alan bir Azure Geliştirici CLI (azd) şablonu seçin.
  • Seçtiğiniz şablondan azd oluşturulan kodu içeren yeni bir GitHub Codespace oluşturun.
  • GitHub Codespaces'ı ve çevrimiçi Visual Studio Code'un bash terminalini kullanın. Terminal, örnek bir web uygulaması ve veritabanı oluşturmak ve gerekli Azure kaynaklarını oluşturup yapılandırmak üzere bir azd şablon çalıştırmak için Azure Geliştirici CLI komutlarını kullanmanıza ve ardından örnek web uygulamasını Azure'a dağıtmanıza olanak tanır.
  • GitHub Codespace içinde web uygulamasını düzenleyin ve yeniden dağıtmak için bir azd komut kullanın.
  • Azure kaynaklarını temizlemek için bir azd komut 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:

Önkoşullar

Önemli

Hem GitHub Codespaces hem de Azure ücretli abonelik tabanlı hizmetlerdir. Bazı ücretsiz hizmetlerden sonra bu hizmetleri kullanmak 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ı kullanılarak oluşturulmuş olsa da bazıları ücretsiz olmayabilir. Maliyetleri daha iyi anlamak için Azure Fiyatlandırma hesaplayıcısını kullanın. Daha fazla bilgi için bkz. GitHub Codespaces fiyatlandırması .

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

Python web çerçevesini, Azure web barındırma platformunu ve üzerinde derlemek istediğiniz Azure veritabanı platformunu temel alan bir azd şablon 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 (Türkçe) PostgreSQL Esnek Sunucusu Azure Konteyner Uygulamaları Yeni Codespace
    azure-django-postgres-flexible-appservice Django (Türkçe) PostgreSQL Esnek Sunucusu Azure App Service Yeni Codespace
    Azure-Django-Cosmos-Postgres-ACA Django (Türkçe) Cosmos DB (PostgreSQL Bağdaştırıcısı) Azure Konteyner Uygulamaları Yeni Codespace
    azure-django-cosmos-postgres-uygulama servisi Django (Türkçe) Cosmos DB (PostgreSQL Bağdaştırıcısı) Azure App Service Yeni Codespace
    Azure-Django-Postgres-Eklenti-ACA Django (Türkçe) Azure Container Apps PostgreSQL Eklentisi Azure Konteyner Uygulamaları Yeni Codespace

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

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

  2. Birkaç dakika sonra Visual Studio Code'un 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'da kimlik doğrulaması yapın ve azd şablonunu dağıtın

Artık yeni oluşturulan kodu içeren bir GitHub Codespace'iniz olduğuna göre, kodu Azure'da yayımlamak için Codespace'in içinden yardımcı programını kullanırsınız azd .

  1. Web tabanlı Visual Studio Code'da terminal varsayılan olarak açık olmalıdır. Değilse, terminali açmak için tilde ~ tuşunu kullanın. Ayrıca, varsayılan olarak terminal bir bash terminali olmalıdır. 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'inizi Azure hesabınıza kimlik doğrulama sürecini başlatır.

    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'a 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, filtrelemek için yazın]
    • Kullanılacak Azure konumunu 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

    Başarıyla azd up tamamlandığında, örnek web uygulaması genel internette erişilebilir hale gelecek ve Azure Aboneliğiniz, oluşturulan tüm kaynaklar için ücret tahakkuk etmeye başlayacak. Ş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ı tamamladıktan sonra, azd down tarafından oluşturulan tüm hizmetleri kaldırmak için azd up kullanın.

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

    azd up çalıştırmak, birden çok Azure hizmeti sağladığı ve dağıttığı için 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 lütfen 5-10 dakika bekleyin.

    Azure'da canlı çalışan örnek web uygulaması projesini görmek için Ctrl tuşunu basılı tutarak sözcüğün - Endpoint: ardından ilk URL'ye tıklayın.

  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

Sonraki adım, web uygulamasında küçük bir değişiklik yapmak ve sonra yeniden dağıtmaktır.

  1. Visual Studio Code'un bulunduğu tarayıcı sekmesine dönün ve src/templates klasörüne gitmek için Visual Studio Code'un Explorer görünümünü kullanın ve 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ıktan sonra, güncelleştirmeyi görmek için Tarayıcı sekmesini ReleCloud web sitesiyle yenileyin. Kullanılan 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 şablon tarafından oluşturulan 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 bir Codespace içinde nasıl (geçici olarak) çalıştığını ve kısa vadeli olarak kalıcı hale nasıl alındığını gösterir. Kod üzerinde çalışmaya devam etmek istiyorsanız, kodu yeni bir depoda yayımlamanız gerekir.

  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 şu sayfaya gidin: https://github.com/codespaces

  3. En altta, yakın zamanda kullanılan Codespaces listesini göreceksiniz. "Oluşturduğunuz bölümü, "Azure-Samples'a ait" başlıklı bölümde 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, GitHub tarafından barındırılan bir kapsayıcı olan bir azd şablonundan oluşturulan yeni kodunuzla Visual Studio Code geliştirme ortamınızı çalıştıran bir Codespace'iniz var. Ancak kod bir GitHub deposunda depolanmaz. Kod üzerinde çalışmaya devam etmek istiyorsanız, bunu öncelik haline getirmelisiniz.

  1. Kod alanının bağlam menüsünden "Yeni bir depoya yayımla" seçeneğini belirleyin.
  2. "Yeni bir depoya 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 "Depoya bakın" 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. Artık Codespace Visual Studio Code geliştirme ortamınıza döndürülmelisiniz.
  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ğıdakileri deneyin:

  • Oluşturulmuş olabilecek tüm kaynakları kaldırmak için komutunu çalıştırın azd down . Alternatif olarak, Azure portalında oluşturulan 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 "Sil"i 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 harflerle, sayı yok, büyük harf yok, özel karakter yok.
  • 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 SSS bölümüne bakın.

İlgili içerik

  • Last updated on