Bu hızlı başlangıçta, bir Azure Geliştirici CLI (azd) şablonu ve yalnızca birkaç azd komut kullanarak uygulama kaynaklarını sağlamayı ve Azure'a dağıtmayı öğreneceksiniz.
azd şablonlar, uygulama kaynak kodunuzun yanı sıra azd Azure kaynaklarını sağlamak için yapılandırma ve altyapı dosyalarını içeren standart kod depolarıdır. Şablonlar ve Azure sağlama ve dağıtım sürecinizi nasıl hızlandırabilecekleri hakkında azd daha fazla bilgi edinmek için bkz. Azure Geliştirici CLI şablonları nedir?
Şablonu seçme ve dağıtma
Sonraki adımlar için, Azure'da bir uygulama sağlamak ve dağıtmak için aşağıdaki şablonu kullanacaksınız:
Ayrıca, Harika AZD şablon galerisi sitesinden tercihlerinizle eşleşen bir şablon da seçebilirsiniz. Hangi şablonu kullanırsanız kullanın, geliştirme ortamınızda şablon koduyla karşılaşırsınız ve Azure'da uygulamayı derlemek, yeniden dağıtmak ve izlemek için komutlar çalıştırabilirsiniz.
Devam etmek için tercih ettiğiniz ortamı seçin:
Yerel geliştirme ortamı, geleneksel geliştirme iş akışları için harika bir seçimdir. Şablon deposunu cihazınıza kopyalayıp yerel yüklemesine azdkarşı komutlar çalıştıracaksınız.
Önkoşullar
Projeyi başlatma
Dosya Gezgini veya terminalde yeni bir boş dizin oluşturun ve bu dizine geçin.
azd init komutunu çalıştırın ve parametre olarak kullanmak istediğiniz şablonu belirtin:
azd init --template todo-nodejs-mongo
azd init --template todo-python-mongo
azd init --template todo-csharp-cosmos-sql
azd init --template todo-java-mongo-aca
İstendiğinde, Azure kaynaklarını barındıracak şekilde oluşturulacak kaynak grubu için bir adlandırma ön eki ayarlayan gibi azdquickstartbir ortam adı girin.
ortamında azdortam adı nedir?
Ortamı belirttikten sonra şablon azd projesini makinenize kopyalayıp projeyi başlatır.
Uygulama kaynaklarını sağlama ve dağıtma
azd auth login komutunu çalıştırın ve azd oturum açma işlemini tamamlamanız için bir tarayıcı başlatır.
azd auth login
azd up Komutunu çalıştırın:
azd up
Azure'da oturum açtıktan sonra aşağıdaki bilgiler istenir:
| Parametre |
Açıklama |
Azure Location |
Kaynaklarınızın dağıtılacağı Azure konumu. |
Azure Subscription |
Kaynaklarınızın dağıtılacağı Azure Aboneliği. |
İstediğiniz değerleri seçin ve Enter tuşuna basın. Komut, azd up şablon yapılandırma ve altyapı dosyalarını kullanarak aşağıdaki görevleri sizin için işler:
- Aşağıdakiler dahil olmak üzere gerekli tüm Azure kaynaklarını (
azd provision ) oluşturur ve yapılandırr:
- Hesabınız için ilkelere ve rollere erişme
- Yönetilen Kimliklerle hizmet-hizmet iletişimi
- Kodu paketler ve dağıtır (
azd deploy)
azd up Komut başarıyla tamamlandığında, CLI oluşturulan kaynakları görüntülemek için iki bağlantı görüntüler:
- ToDo API uygulaması
- ToDo web uygulaması ön ucu
Not
Güncelleştirmeleri hem sağlamak hem de uygulamanıza dağıtmak için istediğiniz kadar çağrı azd up yapabilirsiniz.
Seçilen bölgede kaynağın dağıtılamaması nedeniyle dağıtım başarısız olabilir. Bu hızlı bir başlangıç olduğundan, dizini silip .azure yeniden denemek azd up güvenlidir. sorulduğunda farklı bir bölge seçin. Daha gelişmiş bir senaryoda, bölgeyi değiştirmek için dizindeki .azure dosyaları seçmeli olarak düzenleyebilirsiniz.
Azure Geliştirici CLI'sı, özelliklerle azd çalışmayı kolaylaştırmak için bir Visual Studio Code uzantısı sağlar. Örneğin, komutları çalıştırmak azd için komut paleti arabirimini kullanabilirsiniz. İlerideki adımları tamamlamak için Visual Studio Code için Azure Geliştirici CLI uzantısını yüklemeniz gerekir.
Azure Geliştirici CLI uzantısını yükleme
Visual Studio Code'u açın.
Görünüm menüsünde Uzantılar'ı seçin.
Arama alanına yazın Azure Developer CLI.
Yükle'yi seçin ve yükleme işleminin tamamlanmasını bekleyin.
Yeni bir uygulama başlatma
Visual Studio Code'da boş bir dizin açın.
Görünümmenüsünden Komut Paleti... öğesini seçin.
komutunu arayın Azure Developer CLI (azd): Initialize app (init) ve Enter tuşuna basın.
azd up komutu, azd'e uygulama kaynaklarını sağlama ve dağıtma talimatını verir.
Şablon seçin iş akışını seçin.
Azure'da Node.js API ve MongoDB ile React Web App şablonunu arayın ve seçmek için Enter tuşuna basın.
Visual Studio Code azd şablonunu klonlar. Şablon, infra klasöründe altyapı kodu dosyaları ve src klasöründe örnek uygulama içerir. Kod dosyası olarak altyapı, dağıtıldığında uygulamanın gerektirdiği Azure'da gerekli kaynakları sağlar.
Azure'da Python API ve MongoDB ile React Web App şablonunu arayın ve seçmek için Enter tuşuna basın.
Visual Studio Code azd şablonunu klonlar. Şablon, infra klasöründe altyapı için kod dosyalarını ve src klasöründe örnek bir uygulamayı içerir. Kod olarak altyapı dosyaları, uygulama dağıtıldığında Azure'da gereken kaynakları sağlar.
Azure'da C# API ve MongoDB ile React Web App şablonunu arayın ve seçmek için Enter tuşuna basın.
Visual Studio Code azd şablonunu indirir ve kopyalar. Şablon, infra klasöründe kod dosyası olarak altyapı ve src klasöründe örnek bir uygulama içerir. Kod olarak altyapı dosyaları, uygulama dağıtıldığında gereken Azure'daki kaynakları sağlar.
Azure'da Java API ve MongoDB ile Kapsayıcılı React Web Uygulaması şablonunu arayın ve enter tuşuna basarak seçin.awesome-azd.
Visual Studio Code şablonu azd indirir ve kopyalar. Şablon, infra klasöründe kod altyapı dosyalarını ve src klasöründe örnek bir uygulamayı içerir. Kod olarak altyapı dosyaları, dağıtıldığında uygulamanın gerektirdiği Azure'daki gerekli kaynakları hazırlar.
Şablon kopyalandıktan sonra, Visual Studio Code bir ortam adı girmenizi isteyen bir terminal açar.
Seçtiğiniz azdvscode gibi kısa bir ad girin ve Enter tuşuna basın.
Enter a new environment name: [? for help] azdvscode
Ortam adı, Azure'da sağlanan kaynakların adlandırılmasını etkiler ve belirli ortam ayarlarını depolamak için şablon dizininde .azure bir klasör oluşturur.
Uygulama kaynaklarını sağlama ve dağıtma
Komut Paleti'ni açın, komutu arayın Azure Developer CLI (azd): Package, Provision and Deploy(up) ve Enter tuşuna basın.
azd up komutu, azd birime uygulama kaynaklarını sağlama ve dağıtma talimatı verir.
Visual Studio Code, sağlama ve dağıtım işleminin ilerleme durumunu görüntülemek için bir terminal penceresi açar.
azd , kaynakları dağıtırken işlem sırasında init seçtiğiniz abonelik ve konum ayarlarını kullanır.
Not
Sağlama ve dağıtım işlemi birkaç dakika sürebilir.
Dağıtım işlemi tamamlandığında, sitenizi tarayıcıda başlatmak için tarafından azd sağlanan çıkış penceresindeki bağlantıyı seçin.
Kod alanları, kapsayıcılı bulut ortamlarında çalışmayı ve araçları veya bağımlılıkları yerel olarak yüklemekten kaçınmayı tercih eden geliştiriciler için harika bir seçenektir.
Codespace'ınızı ayarlama
- Tarayıcınızda Azure'da Node.js API ve MongoDB ile React Web App şablonuna gidin (veya Harika AZD'den bir tane seçin)
- Tarayıcınızda Azure'da Java API ve MongoDB ile Kapsayıcılı React Web Uygulaması şablonuna gidin (veya Awesome AZD'den bir tane seçin)
- Dosya listesinin üst kısmında Bu şablonu>
Codespaces ile Visual Studio Code uzantısıazd tüm önkoşullar sizin için yüklenir.
Şablonu çalıştır
Codespace'ınız oluşturulduktan sonra kök dizinde azure.yaml dosyasına sağ tıklayın. Seçeneklerden öğesini seçin (kaynakları sağlayın ve Kodu Azure'a dağıtın).
Komutu çalıştırdığınızda azd up , aşağıdaki bilgileri sağlamanız ve bir web tarayıcısı ve kimlik doğrulama kodu kullanarak oturum açmanız istenir:
| Parametre |
Açıklama |
Environment Name |
Tüm Azure kaynaklarını barındıracak şekilde oluşturulacak kaynak grubunun ön eki. ortamında azdortam adı nedir? ile azd env newher zaman yeni bir ortam oluşturabilirsiniz. |
Azure Location |
Kaynaklarınızın dağıtılacağı Azure konumu. |
Azure Subscription |
Kaynaklarınızın dağıtılacağı Azure Aboneliği. |
Komut aşağıdaki görevleri işlediğinden bu azd up işlemin tamamlanması biraz zaman alabilir:
- Gerekli tüm Azure kaynaklarını (
azd provision ) oluşturur ve yapılandırr.
- Hesabınız için erişim ilkelerini ve rollerini yapılandırıyor.
- Yönetilen Kimliklerle hizmet-hizmet iletişimi uygular.
- () kodunu
azd deploy paketler ve dağıtır.
Gerekli parametreleri sağladıktan ve azd up komut tamamlandıktan sonra CodeSpaces terminali, oluşturulan kaynakları görüntülemek için iki Azure portalı bağlantısı görüntüler:
- ToDo API uygulaması
- ToDo web uygulaması ön ucu
Neler oldu?
Komutun başarıyla tamamlanmasından azd up sonra:
-
Şablonun
README.md dosyasında başvuruda bulunılan Azure kaynakları, çalıştırdıktan azd upsonra belirttiğiniz Azure aboneliğine sağlanmıştır. Artık bu Azure kaynaklarını Azure portalı üzerinden görüntüleyebilirsiniz.
- Uygulama derlendi ve Azure'a dağıtıldı. Komutun web uygulaması URL çıkışını
azd up kullanarak tam işlevsel uygulamaya göz atabilirsiniz.
DevContainer, yerel makinenizde şablonla azd çalışmak için ihtiyacınız olan tüm önkoşulları içeren bir Docker görüntüsüdür. GitHub Codespaces gibi bir bulut hizmeti yerine hala yerel bir cihazda çalışan kapsayıcılı ortamları tercih eden geliştiriciler için harika bir seçenektir.
Önkoşullar
Projeyi başlatma
Bir terminal açın, yeni bir boş dizin oluşturun ve bu dizine geçin.
Projeyi başlatmak için aşağıdaki komutu çalıştırın:
azd init --template todo-nodejs-mongo
azd init --template todo-python-mongo
azd init --template todo-csharp-cosmos-sql
azd init --template todo-java-mongo-aca
Komutu çalıştırdığınızda azd init aşağıdaki bilgileri sağlamanız istenir:
| Parametre |
Açıklama |
Environment Name |
Tüm Azure kaynaklarını barındıracak şekilde oluşturulacak kaynak grubunun ön eki. ortamında azdortam adı nedir? ile azd env newher zaman yeni bir ortam oluşturabilirsiniz. |
DevContainer'ı açma
- Projeyi VS Code'da açın.
- F1 tuşuna basın ve seçin:
Remote-Containers: Rebuild and Reopen in Container
Çalıştır up komutu
Şu komutu çalıştırın:
azd up
Komutu çalıştırdığınızda azd up aşağıdaki bilgileri sağlamanız istenir:
| Parametre |
Açıklama |
Azure Location |
Kaynaklarınızın dağıtılacağı Azure konumu. |
Azure Subscription |
Kaynaklarınızın dağıtılacağı Azure Aboneliği. |
Aşağıdaki azd up adımları tamamlayan komutun çalıştırılması biraz zaman alabilir:
- Aşağıdakiler dahil olmak üzere gerekli tüm Azure kaynaklarını (
azd provision ) oluşturur ve yapılandırr:
- Hesabınız için ilkelere ve rollere erişme
- Yönetilen Kimliklerle hizmet-hizmet iletişimi
- Kodu paketler ve dağıtır (
azd deploy)
Gerekli parametreleri sağladıktan ve azd up komut tamamlandıktan sonra CLI, oluşturulan kaynakları görüntülemek için iki Azure portalı bağlantısı görüntüler:
- ToDo API uygulaması
- ToDo web uygulaması ön ucu
Not
Uygulamanızı hem sağlamak hem de aynı bölgeye dağıtmak ve ilk çalıştırmada sağladığınız yapılandırma değerleriyle istediğiniz kadar çalıştırabilirsiniz azd up .
Kaynakları temizleme
Bu makalede oluşturulan kaynaklara artık ihtiyacınız kalmadığında, uygulamayı kapatmak için aşağıdaki komutu çalıştırın:
azd down
Farklı bir bölgeye yeniden dağıtmak istiyorsanız, yeniden çalıştırmadan .azure önce dizini silinazd up. Daha gelişmiş bir senaryoda, bölgeyi değiştirmek için dizindeki .azure dosyaları seçmeli olarak düzenleyebilirsiniz.
Yardım isteme
Azure Geliştirici CLI'sı için hata oluşturma, yardım isteme veya yeni bir özellik önerme hakkında bilgi için lütfen sorun giderme ve destek sayfasını ziyaret edin.
Sonraki adımlar