Hızlı Başlangıç: Azure Spring Apps'e ilk web uygulamanızı dağıtma
Makale
Not
Temel, Standart ve Kurumsal planları, 3 yıllık kullanımdan kaldırma süresiyle Mart 2025 ortasından itibaren kullanımdan kaldırılacaktır. Azure Container Apps'e geçiş yapmanızı öneririz. Daha fazla bilgi için bkz . Azure Spring Apps kullanımdan kaldırma duyurusu.
Bu hızlı başlangıçta Spring Boot web uygulamasının Azure Spring Apps'e nasıl dağıtılacağı gösterilmektedir. Örnek proje, görevleri eklemek, tamamlandığında işaretlemek ve sonra da silmek için basit bir ToDo uygulamasıdır. Aşağıdaki ekran görüntüsünde uygulama gösterilmektedir:
Bu uygulama, aşağıdaki katmanlara sahip tipik bir üç katmanlı web uygulamasıdır:
İlişkisel veritabanına erişmek için Spring Data JPA kullanan bir arka uç Spring web uygulaması.
İlişkisel veritabanı. Localhost için uygulama H2 Veritabanı Altyapısı'nı kullanır. Azure Spring Apps için uygulama PostgreSQL için Azure Veritabanı kullanır. PostgreSQL için Azure Veritabanı hakkında daha fazla bilgi için Esnek Sunucu belgelerine bakın.
Aşağıdaki diyagramda sistemin mimarisi gösterilmektedir:
Bu makalede Azure Spring Apps'e dağıtmak için aşağıdaki seçenekler sağlanır:
Azure portalı seçeneği, tek tıklamayla kaynak oluşturmanın ve uygulamaları dağıtmanın en kolay ve en hızlı yoludur. Bu seçenek, Uygulamaları Azure bulut hizmetlerine hızla dağıtmak isteyen Spring geliştiricileri için uygundur.
Azure portalı + Maven eklentisi seçeneği, kaynakları oluşturmak ve uygulamaları adım adım dağıtmak için daha geleneksel bir yol sağlar. Bu seçenek, Azure bulut hizmetlerini ilk kez kullanan Spring geliştiricileri için uygundur.
Azure Geliştirici CLI seçeneği, kaynakları otomatik olarak oluşturmanın ve uygulamaları basit komutlar aracılığıyla dağıtmanın daha verimli bir yoludur. Azure Geliştirici CLI'sı, gerekli Azure kaynaklarını sağlamak ve uygulama kodunu dağıtmak için bir şablon kullanır. Bu seçenek, Azure bulut hizmetlerini bilen Spring geliştiricileri için uygundur.
Bu makalede Azure Spring Apps'e dağıtmak için aşağıdaki seçenekler sağlanır:
Azure portalı seçeneği, tek tıklamayla kaynak oluşturmanın ve uygulamaları dağıtmanın en kolay ve en hızlı yoludur. Bu seçenek, Uygulamaları Azure bulut hizmetlerine hızla dağıtmak isteyen Spring geliştiricileri için uygundur.
Azure portalı + Maven eklentisi seçeneği, kaynakları oluşturmak ve uygulamaları adım adım dağıtmak için daha geleneksel bir yol sağlar. Bu seçenek, Azure bulut hizmetlerini ilk kez kullanan Spring geliştiricileri için uygundur.
Azure CLI seçeneği, Azure kaynaklarını yönetmek için güçlü bir komut satırı aracı kullanır. Bu seçenek, Azure bulut hizmetlerini bilen Spring geliştiricileri için uygundur.
Sonraki bölümdeki Azure'a Dağıt düğmesi, GitHub'daki ASA-Samples-Web-Application yayınları sayfasından JAR paketi indiren bir Azure portalı deneyimi başlatır. Yerel hazırlık adımları gerekli değildir.
Sonraki adımlarda Azure portalını kullansanız da, projeyi yerel olarak hazırlamak için Bash komut satırını kullanmanız gerekir. Uygulamayı yerel olarak kopyalamak ve çalıştırmak için aşağıdaki adımları kullanın:
GitHub'dan örnek projeyi kopyalamak için aşağıdaki komutu kullanın:
Maven ile örnek projeyi derlemek için aşağıdaki komutu kullanın:
cd ASA-Samples-Web-Application
./mvnw clean package
Örnek uygulamayı çalıştırmak için aşağıdaki komutu kullanın:
java -jar web/target/simple-todo-web.jar
Uygulamaya erişmek için http://localhost:8080 tarayıcınızda adresine gidin.
3. Bulut ortamını hazırlama
Bu örneği çalıştırmak için gereken ana kaynaklar bir Azure Spring Apps örneği ve bir PostgreSQL için Azure Veritabanı örneğidir. Bu bölümde, bu kaynakları oluşturma adımları sağlanır.
Bu bölümde, Azure portalında bir dağıtım deneyimi başlatmak için Azure'a Dağıt düğmesi kullanılır. Bu deneyim, Azure kaynakları oluşturmak için bir ARM şablonu kullanır.
3.1. Azure portalda oturum açma
Azure portalına gidin ve portalda oturum açmak için kimlik bilgilerinizi girin. Varsayılan görünüm hizmet panonuzu içerir.
3.2. Azure kaynakları oluşturma
Uygulamanın bağımlı olduğu tüm Azure kaynaklarını oluşturmak için aşağıdaki adımları kullanın:
Azure portalında dağıtım deneyimini başlatmak için aşağıdaki Azure'a dağıt düğmesini seçin:
Temel Bilgiler sekmesinde formu doldurun. Formu tamamlamak için kılavuz olarak aşağıdaki tabloyu kullanın:
Ayar
Önerilen değer
Açıklama
Abonelik
Abonelik adınız.
Sunucunuz için kullanmak istediğiniz Azure aboneliği. Birden çok aboneliğiniz varsa kaynak için faturalandırılacak aboneliği seçin.
Kaynak grubu
myresourcegroup
Yeni bir kaynak grubu adı veya aboneliğinizde var olan bir kaynak grubu.
Bölge
Kullanıcılarınıza en yakın bölge.
Bölge, kaynak grubunu oluşturmak için kullanılır.
Postgre SQL Yönetici Parolası
Yok
PostgreSQL Sunucusu yöneticisinin parolası.
Postgre SQL Kullanıcı Parolası
Yok
Uygulamada kullanılan PostgreSQL uygulama kullanıcısının parolası.
Seçimlerinizi gözden geçirmek için Gözden Geçir ve Oluştur'u seçin. Ardından Oluştur'u seçerek uygulamayı Azure Spring Apps'e dağıtın.
Araç çubuğunda, dağıtım sürecini izlemek için Bildirimler simgesini (zil) seçin. Dağıtım tamamlandıktan sonra Panoya sabitle'yi seçerek Azure portalı panonuzda hizmetin Genel Bakış sayfasının kısayolu olarak bu hizmet için bir kutucuk oluşturabilirsiniz. Hizmetin Genel Bakış sayfasını açmak için Kaynağa git'i seçin.
3.1. Azure portalda oturum açma
Azure portalına gidin, kimlik bilgilerinizi girin ve portalda oturum açın. Varsayılan görünüm hizmet panonuzu içerir.
3.2. Azure Spring Apps örneği oluşturma
Hizmet örneğini oluşturmak için aşağıdaki adımları kullanın:
Azure portalının köşesinde kaynak oluştur'u seçin.
İşlem>Azure Spring Apps'i seçin.
Temel bilgiler formunu aşağıdaki bilgilerle doldurun:
Ayar
Önerilen değer
Açıklama
Abonelik
Abonelik adınız.
Sunucunuz için kullanmak istediğiniz Azure aboneliği. Birden çok aboneliğiniz varsa kaynak için faturalandırılacak aboneliği seçin.
Kaynak grubu
myresourcegroup
Yeni bir kaynak grubu adı veya aboneliğinizde var olan bir kaynak grubu.
Ad
myasa
Azure Spring Apps hizmetinizi tanımlayan benzersiz bir ad. Ad 4 ile 32 karakter uzunluğunda olmalıdır ve yalnızca küçük harf, sayı ve kısa çizgi içerebilir. Hizmet adının ilk karakteri bir harf, son karakter ise harf veya sayı olmalıdır.
Plan
Kurumsal
Örneğinizle ilişkili kaynağı ve maliyeti belirleyen fiyatlandırma planı.
Bölge
Kullanıcılarınıza en yakın bölge.
Kullanıcılarınız için en yakın olan konum.
Alanlar Arası Yedekli
Seçili değil
Azure Spring Apps hizmetinizi bir Azure kullanılabilirlik alanında oluşturma seçeneği. Bu özellik şu anda tüm bölgelerde desteklenmiyor.
Yazılım IP planı
Kullandıkça Öde
Azure Spring Apps ile kullandıkça ödeyin.
Terim
Seçili
Market teklifiyle ilişkili sözleşme onay kutusu. Bu onay kutusunu seçmeniz gerekir.
Örnek projeyi dağıtma
Seçili değil
Yerleşik örnek uygulamayı kullanma seçeneği.
Seçimlerinizi gözden geçirmek için Gözden Geçir ve Oluştur'u seçin. Ardından Oluştur'u seçerek Azure Spring Apps örneğini sağlayın.
Araç çubuğunda, dağıtım sürecini izlemek için Bildirimler simgesini (zil) seçin. Dağıtım tamamlandıktan sonra Panoya sabitle'yi seçerek Azure portalı panonuzda hizmetin Genel Bakış sayfasının kısayolu olarak bu hizmet için bir kutucuk oluşturabilirsiniz.
Azure Spring Apps'e Genel Bakış sayfasına gitmek için Kaynağa git'i seçin.
3.3. PostgreSQL örneğini hazırlama
PostgreSQL için Azure Veritabanı sunucusu oluşturmak için aşağıdaki adımları kullanın:
Azure portalda Kaynak oluştur’u seçin.
Veritabanları> PostgreSQL için Azure Veritabanı Esnek Sunucu'PostgreSQL için Azure Veritabanı seçin.
Temel Bilgiler sekmesini aşağıdaki bilgilerle doldurun:
Sunucu adı: my-demo-pgsql
Bölge: Doğu ABD
PostgreSQL sürümü: 14
İş yükü türü: Geliştirme
Yüksek kullanılabilirliği etkinleştirme: seçilmemiş
Kimlik doğrulama yöntemi: Yalnızca PostgreSQL kimlik doğrulaması
Yönetici kullanıcı adı: myadmin
Parola ve Parolayı onayla: Bir parola girin.
Aşağıdaki bilgileri kullanarak Ağ sekmesini yapılandırın:
Bağlantı yöntemi: Genel erişim (izin verilen IP adresleri)
Azure'ın içindeki herhangi bir Azure hizmetinden bu sunucuya genel erişime izin ver: seçili
Seçimlerinizi gözden geçirmek için Gözden geçir + oluştur'u ve ardından sunucuyu sağlamak için Oluştur'u seçin. Bu işlem birkaç dakika sürebilir.
Azure portalında PostgreSQL sunucunuza gidin.
Veritabanı oluşturmak için gezinti menüsünden Veritabanları'nı (örneğin, Todo) seçin.
3.4. Uygulama örneğini PostgreSQL örneğine bağlama
Hizmet örneklerinizi bağlamak için aşağıdaki adımları kullanın:
Azure portalında Azure Spring Apps örneğine gidin.
Gezinti bölmesinde Uygulamalar'ı açın ve Ardından Uygulama Oluştur'u seçin.
Uygulama Oluştur sayfasında, uygulama adı için simple-todo-web kullanın ve diğer tüm alanları varsayılan değerleriyle bırakın.
Uygulamayı oluşturmayı tamamlamak için Oluştur'u seçin ve ardından ayrıntıları görüntülemek için uygulamayı seçin.
Gezinti bölmesinden Hizmet Bağlayıcısı'nı ve ardından Oluştur'u seçerek yeni bir hizmet bağlantısı oluşturun.
Temel Bilgiler sekmesini aşağıdaki bilgilerle doldurun:
Hizmet türü: PostgreSQL esnek sunucusu için DB
Bağlantı adı: Değiştirebileceğiniz otomatik olarak oluşturulan bir adla doldurulur.
Belirtilmesi 0.0.0.0 , Azure'da dağıtılan tüm kaynaklardan genel erişimin sunucunuza erişmesini sağlar.
3.5. Uygulama örneğini PostgreSQL örneğine bağlama
Uygulama örneği ve PostgreSQL örneği oluşturulduktan sonra, uygulama örneği PostgreSQL örneğine doğrudan erişemez. Uygulamanın PostgreSQL örneğine bağlanmasını sağlamak için aşağıdaki adımları kullanın.
PostgreSQL örneğinin tam etki alanı adını almak için aşağıdaki komutu kullanın:
Aşağıdaki listede komut etkileşimleri açıklanmaktadır:
Yapılandıracak alt modülleri seçin: Yapılandırılan modülü seçin ve simpleTodo Web modülünün numarasını girin.
OAuth2 oturum açma: OAuth2 protokolüne göre Azure'da oturum açmayı yetkilendirmeniz gerekir.
Aboneliği seçin: Oluşturduğunuz Azure Spring Apps örneğinin abonelik listesi numarasını seçin ve varsayılan olarak listedeki ilk aboneliği seçin. Varsayılan sayıyı kullanıyorsanız doğrudan Enter tuşuna basın.
Azure'da mevcut Azure Spring Apps'i kullanma: Mevcut Azure Spring Apps örneğini kullanmak için y tuşuna basın.
Dağıtım için Azure Spring Apps'i seçin: Oluşturduğunuz Azure Spring Apps örneğinin numarasını seçin. Varsayılan sayıyı kullanıyorsanız doğrudan Enter tuşuna basın.
Bu uygulama için genel erişimi kullanıma sunma: y tuşuna basın.
Yukarıdaki tüm yapılandırmaları kaydetmek için onaylayın: y tuşuna basın. n tuşuna basarsanız yapılandırma POM dosyalarına kaydedilmez.
Uygulamayı dağıtmak için aşağıdaki komutu kullanın:
./mvnw azure-spring-apps:deploy
Aşağıdaki listede komut etkileşimi açıklanmaktadır:
OAuth2 oturum açma: OAuth2 protokolüne göre Azure'da oturum açmayı yetkilendirmeniz gerekir.
Komut yürütüldükten sonra, dağıtımın başarılı olduğunu aşağıdaki günlük iletilerinden görebilirsiniz:
[INFO] Deployment Status: Running
[INFO] InstanceName:simple-todo-web-default-15-xxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:N/A
[INFO] Getting public url of app(simple-todo-web)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-simple-todo-web.azuremicroservices.io
Çıktı Uygulama URL'si , uygulamaya erişmek todo için uç noktadır.
Artık bulut ortamı hazır olduğuna göre uygulama dağıtıma hazırdır. Uygulamayı dağıtmak için aşağıdaki komutu kullanın:
az spring app deploy \
--service ${AZURE_SPRING_APPS_NAME} \
--name ${APP_NAME} \
--artifact-path web/target/simple-todo-web.jar
Sonraki bölümdeki Azure'a Dağıt düğmesi, GitHub'daki ASA-Samples-Web-Application yayınları sayfasından JAR paketi indiren bir Azure portalı deneyimi başlatır. Yerel hazırlık adımları gerekli değildir.
Sonraki adımlarda Azure portalını kullansanız da, projeyi yerel olarak hazırlamak için Bash komut satırını kullanmanız gerekir. Uygulamayı yerel olarak kopyalamak ve çalıştırmak için aşağıdaki adımları kullanın:
GitHub'dan örnek projeyi kopyalamak için aşağıdaki komutu kullanın:
Aşağıdaki listede komut etkileşimi açıklanmaktadır:
Yeni bir ortam adı girin: Tüm Azure kaynaklarını barındırmak için oluşturulan kaynak grubunun son eki olarak kullanılan bir ortam adı girin. Bu ad, Azure aboneliğinizde benzersiz olmalıdır.
Konsol, aşağıdaki örneğe benzer iletiler gönderir:
Initializing a new project (azd init)
(✓) Done: Initialized git repository
(✓) Done: Downloading template code to: <your-local-path>
Enter a new environment name: <your-env-name>
SUCCESS: New project initialized!
You can view the template code in your directory: <your-local-path>
Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
3. Bulut ortamını hazırlama
Bu örneği çalıştırmak için gereken ana kaynaklar bir Azure Spring Apps örneği ve bir PostgreSQL için Azure Veritabanı örneğidir. Bu bölümde, bu kaynakları oluşturma adımları sağlanır.
Bu bölümde, Azure portalında bir dağıtım deneyimi başlatmak için Azure'a Dağıt düğmesi kullanılır. Bu deneyim, Azure kaynakları oluşturmak için bir ARM şablonu kullanır.
3.1. Azure portalda oturum açma
Azure portalına gidin ve portalda oturum açmak için kimlik bilgilerinizi girin. Varsayılan görünüm hizmet panonuzu içerir.
3.2. Azure kaynakları oluşturma
Uygulamanın bağımlı olduğu tüm Azure kaynaklarını oluşturmak için aşağıdaki adımları kullanın:
Azure portalında dağıtım deneyimini başlatmak için aşağıdaki Azure'a dağıt düğmesini seçin:
Temel Bilgiler sekmesinde formu doldurun. Formu tamamlamak için kılavuz olarak aşağıdaki tabloyu kullanın:
Ayar
Önerilen değer
Açıklama
Abonelik
Abonelik adınız.
Sunucunuz için kullanmak istediğiniz Azure aboneliği. Birden çok aboneliğiniz varsa kaynak için faturalandırılacak aboneliği seçin.
Kaynak grubu
myresourcegroup
Yeni bir kaynak grubu adı veya aboneliğinizde var olan bir kaynak grubu.
Bölge
Kullanıcılarınıza en yakın bölge.
Bölge, kaynak grubunu oluşturmak için kullanılır.
PostgreSQL Yönetici Parolası
Yok
PostgreSQL Sunucusu yöneticisinin parolası.
PostgreSQL Kullanıcı Parolası
Yok
Uygulamada kullanılan PostgreSQL uygulama kullanıcısının parolası.
Seçimlerinizi gözden geçirmek için Gözden Geçir ve Oluştur'u seçin. Ardından Oluştur'u seçerek uygulamayı Azure Spring Apps'e dağıtın.
Araç çubuğunda, dağıtım sürecini izlemek için Bildirimler simgesini (zil) seçin. Dağıtım tamamlandıktan sonra Panoya sabitle'yi seçerek Azure portalı panonuzda hizmetin Genel Bakış sayfasının kısayolu olarak bu hizmet için bir kutucuk oluşturabilirsiniz. Hizmetin Genel Bakış sayfasını açmak için Kaynağa git'i seçin.
Azure Spring Apps örneği ve PostgreSQL için Azure Veritabanı örneği oluşturmak için aşağıdaki adımları kullanın:
3.1. Azure portalda oturum açma
Azure portalına gidin, kimlik bilgilerinizi girin ve portalda oturum açın. Varsayılan görünüm hizmet panonuzu içerir.
3.2. Azure Spring Apps örneği oluşturma
Hizmet örneği oluşturmak için aşağıdaki adımları kullanın:
Portalın köşesinde kaynak oluştur'u seçin.
İşlem>Azure Spring Apps'i seçin.
Temel Bilgiler sekmesinde formu doldurun. Formu tamamlamak için kılavuz olarak aşağıdaki tabloyu kullanın:
Ayar
Önerilen değer
Açıklama
Abonelik
Abonelik adınız.
Sunucunuz için kullanmak istediğiniz Azure aboneliği. Birden çok aboneliğiniz varsa kaynak için faturalandırılacak aboneliği seçin.
Kaynak grubu
myresourcegroup
Yeni bir kaynak grubu adı veya aboneliğinizde var olan bir kaynak grubu.
Ad
myasa
Azure Spring Apps hizmetinizi tanımlayan benzersiz bir ad. Ad 4 ile 32 karakter uzunluğunda olmalıdır ve yalnızca küçük harf, sayı ve kısa çizgi içerebilir. Hizmet adının ilk karakteri bir harf, son karakter ise harf veya sayı olmalıdır.
Plan
Standart tüketim ve ayrılmış (önizleme)
Fiyatlandırma planı, örneğinizle ilişkili kaynağı ve maliyeti belirler.
Bölge
Kullanıcılarınıza en yakın bölge.
Kullanıcılarınız için en yakın olan konum.
Container Apps Ortamı
myacaenv
Ortam, birbiriyle iletişim kurabilen ve bir sanal ağ, günlük kaydı ve Dapr yapılandırmasını paylaşabilen bir veya daha fazla kapsayıcı uygulaması çevresinde güvenli bir sınırdır.
(İsteğe bağlı) Container Apps Ortamı oluşturmak için Temel Bilgiler sekmesini aşağıdaki bilgilerle doldurun:
Ortam adı: myacaenv
Plan: Tüketim
Alanlar arası yedeklilik: Devre dışı
Ardından, Container Apps Ortamı'nı oluşturmak için Oluştur'u seçin.
Seçimlerinizi gözden geçirmek için Gözden Geçir ve Oluştur'u seçin. Ardından Oluştur'u seçerek Azure Spring Apps örneğini sağlayın.
Araç çubuğunda, dağıtım sürecini izlemek için Bildirimler simgesini (zil) seçin. Dağıtım tamamlandıktan sonra Panoya sabitle'yi seçerek Azure portalı panonuzda hizmetin Genel Bakış sayfasının kısayolu olarak bu hizmet için bir kutucuk oluşturabilirsiniz. Hizmetin Genel Bakış sayfasını açmak için Kaynağa git'i seçin.
3.3. PostgreSQL örneğini hazırlama
PostgreSQL için Azure Veritabanı sunucusu oluşturmak için aşağıdaki adımları kullanın:
Azure portalda Kaynak oluştur’u seçin.
Veritabanları> PostgreSQL için Azure Veritabanı Esnek Sunucu'PostgreSQL için Azure Veritabanı seçin.
Temel Bilgiler sekmesini aşağıdaki bilgilerle doldurun:
Sunucu adı: my-demo-pgsql
Bölge: Doğu ABD
PostgreSQL sürümü: 14
İş yükü türü: Geliştirme
Yüksek kullanılabilirliği etkinleştirme: seçilmemiş
Kimlik doğrulama yöntemi: Yalnızca PostgreSQL kimlik doğrulaması
Yönetici kullanıcı adı: myadmin
Parola ve Parolayı onayla: Bir parola girin.
Aşağıdaki bilgileri kullanarak Ağ sekmesini yapılandırın:
Bağlantı yöntemi: Genel erişim (izin verilen IP adresleri)
Azure'ın içindeki herhangi bir Azure hizmetinden bu sunucuya genel erişime izin ver: seçili
Seçimlerinizi gözden geçirmek için Gözden geçir + oluştur'u ve ardından sunucuyu sağlamak için Oluştur'u seçin. Bu işlem birkaç dakika sürebilir.
Azure portalında PostgreSQL sunucunuza gidin.
Veritabanı oluşturmak için gezinti menüsünden Veritabanları'nı (örneğin, Todo) seçin.
3.4. Uygulama örneğini PostgreSQL örneğine bağlama
Hizmet örneklerinizi bağlamak için aşağıdaki adımları kullanın:
Azure portalında Azure Spring Apps örneğine gidin.
Gezinti bölmesinde Uygulamalar'ı açın ve Ardından Uygulama Oluştur'u seçin.
Uygulama Oluştur sayfasında, uygulama adı için simple-todo-web kullanın ve ardından Uygulamayı oluşturmak için Hızlı başlangıç örnek uygulamasını kullan'ı seçin.
Uygulamayı oluşturmayı tamamlamak için Oluştur'u ve ardından ayrıntılarını görüntülemek için uygulamayı seçin.
Gezinti bölmesinden Yapılandırma'ya tıklayın ve ortam değişkenleri sekmesinde aşağıdaki özellikleri yapılandırın:
Bağlantı özelliklerini kaydetmek için Kaydet'i seçin.
Azure Spring Apps örneği ve PostgreSQL için Azure Veritabanı örneği oluşturmak için aşağıdaki adımları kullanın:
OAuth2 ile Azure'da oturum açmak için aşağıdaki komutu kullanın. Zaten oturum açtıysanız bu adımı yoksayın.
azd auth login
Konsol, aşağıdaki örneğe benzer iletiler gönderir:
Logged in to Azure.
Şablonun altyapısını Azure'a sağlamak için aşağıdaki komutu kullanın:
azd provision
Aşağıdaki listede komut etkileşimleri açıklanmaktadır:
Kullanılacak azure aboneliğini seçin: Taşımak için okları kullanın, filtrelemek için yazın ve ENTER tuşuna basın.
Kullanılacak azure konumunu seçin: Taşımak için okları kullanın, filtrelemek için yazın ve ENTER tuşuna basın.
Konsol, aşağıdaki örneğe benzer iletiler gönderir:
SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Not
Bu komutun tamamlanması biraz zaman alabilir. Azure kaynaklarını sağlarken bir ilerleme göstergesi görürsünüz.
Aşağıdaki listede komut etkileşimleri açıklanmaktadır:
Yapılandıracak alt modülleri seçin: Yapılandırılan modülü seçin ve simpleTodo Web modülünün numarasını girin.
OAuth2 oturum açma: OAuth2 protokolüne göre Azure'da oturum açmayı yetkilendirmeniz gerekir.
Aboneliği seçin: Oluşturduğunuz Azure Spring Apps örneğinin abonelik listesi numarasını seçin ve varsayılan olarak listedeki ilk aboneliği seçin. Varsayılan sayıyı kullanıyorsanız doğrudan Enter tuşuna basın.
Azure'da mevcut Azure Spring Apps'i kullanma: Mevcut Azure Spring Apps örneğini kullanmak için y tuşuna basın.
Dağıtım için Azure Spring Apps'i seçin: Oluşturduğunuz Azure Spring Apps örneğinin numarasını seçin. Varsayılan sayıyı kullanıyorsanız doğrudan Enter tuşuna basın.
Bu uygulama için genel erişimi kullanıma sunma: y tuşuna basın.
Yukarıdaki tüm yapılandırmaları kaydetmek için onaylayın: y tuşuna basın. n tuşuna basarsanız yapılandırma POM dosyalarına kaydedilmez.
Uygulamayı dağıtmak için aşağıdaki komutu kullanın:
./mvnw azure-spring-apps:deploy
Aşağıdaki listede komut etkileşimi açıklanmaktadır:
OAuth2 oturum açma: OAuth2 protokolüne göre Azure'da oturum açmayı yetkilendirmeniz gerekir.
Komut yürütüldükten sonra, dağıtımın başarılı olduğunu aşağıdaki günlük iletilerinden görebilirsiniz:
[INFO] Start updating app(simple-todo-web)...
[INFO] App(simple-todo-web) is successfully updated.
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
[INFO] InstanceName:simple-todo-web--default-xxxxxxx-xxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:NONE
[INFO] Getting public url of app(simple-todo-web)...
[INFO] Application url: https://simple-todo-web.<unique-identifier>.<region-name>.azurecontainerapps.io
Çıktı Uygulama URL'si , uygulamaya erişmek todo için uç noktadır.
Artık uygulamayı Azure Spring Apps'e dağıtabilirsiniz. Uygulamayı paketlemek, web uygulamasının gerektirdiği Azure kaynaklarını sağlamak ve ardından Azure Spring Apps'e dağıtmak için aşağıdaki adımları kullanın:
Uygulamanızın dağıtılabilir bir kopyasını paketlemek için aşağıdaki komutu kullanın:
azd package
Konsol, aşağıdaki örneğe benzer iletiler gönderir:
SUCCESS: Your application was packaged for Azure in xx seconds.
Uygulama kodunu yeni sağlanan kaynaklara dağıtmak için aşağıdaki komutu kullanın:
azd deploy
Konsol, aşağıdaki örneğe benzer iletiler gönderir:
Deploying services (azd deploy)
(✓) Done: Deploying service simple-todo-web
- Endpoint: https://simple-todo-web.xxx.<your-azure-location>.azurecontainerapps.io
SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Çıkış Uç Noktası , uygulamaya erişen todo uç noktadır.
Not
Önceki üç komutu birleştirmek için de kullanabilirsiniz azd up : azd provision (Azure kaynaklarını sağlar), azd package (uygulamanızın dağıtılabilir bir kopyasını paketler) ve azd deploy (uygulama kodunu dağıtır). Daha fazla bilgi için bkz . Azure-Samples/ASA-Samples-Web-Application.
Sonraki bölümdeki Azure'a Dağıt düğmesi, GitHub'daki ASA-Samples-Web-Application yayınları sayfasından JAR paketi indiren bir Azure portalı deneyimi başlatır. Yerel hazırlık adımları gerekli değildir.
Sonraki adımlarda Azure portalını kullansanız da, projeyi yerel olarak hazırlamak için Bash komut satırını kullanmanız gerekir. Uygulamayı yerel olarak kopyalamak ve çalıştırmak için aşağıdaki adımları kullanın:
GitHub'dan örnek projeyi kopyalamak için aşağıdaki komutu kullanın:
Aşağıdaki listede komut etkileşimi açıklanmaktadır:
Yeni bir ortam adı girin: Tüm Azure kaynaklarını barındırmak için oluşturulan kaynak grubunun son eki olarak kullanılan bir ortam adı girin. Bu ad, Azure aboneliğinizde benzersiz olmalıdır.
Konsol, aşağıdaki örneğe benzer iletiler gönderir:
Initializing a new project (azd init)
(✓) Done: Initialized git repository
(✓) Done: Downloading template code to: <your-local-path>
Please enter a new environment name: <your-env-name>
SUCCESS: New project initialized!
You can view the template code in your directory: <your-local-path>
Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
3. Bulut ortamını hazırlama
Bu örneği çalıştırmak için gereken ana kaynaklar bir Azure Spring Apps örneği ve bir PostgreSQL için Azure Veritabanı örneğidir. Bu bölümde, bu kaynakları oluşturma adımları sağlanır.
Bu bölümde, Azure portalında bir dağıtım deneyimi başlatmak için Azure'a Dağıt düğmesi kullanılır. Bu deneyim, Azure kaynakları oluşturmak için bir ARM şablonu kullanır.
3.1. Azure portalda oturum açma
Azure portalına gidin ve portalda oturum açmak için kimlik bilgilerinizi girin. Varsayılan görünüm hizmet panonuzu içerir.
3.2. Azure kaynakları oluşturma
Uygulamanın bağımlı olduğu tüm Azure kaynaklarını oluşturmak için aşağıdaki adımları kullanın:
Azure portalında dağıtım deneyimini başlatmak için aşağıdaki Azure'a dağıt düğmesini seçin:
Temel Bilgiler sekmesinde formu doldurun. Formu tamamlamak için kılavuz olarak aşağıdaki tabloyu kullanın:
Ayar
Önerilen değer
Açıklama
Abonelik
Abonelik adınız.
Sunucunuz için kullanmak istediğiniz Azure aboneliği. Birden çok aboneliğiniz varsa kaynak için faturalandırılacak aboneliği seçin.
Kaynak grubu
myresourcegroup
Yeni bir kaynak grubu adı veya aboneliğinizde var olan bir kaynak grubu.
Bölge
Kullanıcılarınıza en yakın bölge.
Bölge, kaynak grubunu oluşturmak için kullanılır.
Postgre SQL Yönetici Parolası
Yok
PostgreSQL Sunucusu yöneticisinin parolası.
Postgre SQL Kullanıcı Parolası
Yok
Uygulamada kullanılan PostgreSQL uygulama kullanıcısının parolası.
Seçimlerinizi gözden geçirmek için Gözden Geçir ve Oluştur'u seçin. Ardından Oluştur'u seçerek uygulamayı Azure Spring Apps'e dağıtın.
Araç çubuğunda, dağıtım sürecini izlemek için Bildirimler simgesini (zil) seçin. Dağıtım tamamlandıktan sonra Panoya sabitle'yi seçerek Azure portalı panonuzda hizmetin Genel Bakış sayfasının kısayolu olarak bu hizmet için bir kutucuk oluşturabilirsiniz. Hizmetin Genel Bakış sayfasını açmak için Kaynağa git'i seçin.
Azure Spring Apps örneği ve PostgreSQL için Azure Veritabanı örneği oluşturmak için aşağıdaki adımları kullanın:
3.1. Azure portalda oturum açma
Azure portalına gidin ve portalda oturum açmak için kimlik bilgilerinizi girin. Varsayılan görünüm hizmet panonuzu içerir.
3.2. Azure Spring Apps örneği oluşturma
Hizmet örneği oluşturmak için aşağıdaki adımları kullanın:
Portalın köşesinde kaynak oluştur'u seçin.
İşlem>Azure Spring Apps'i seçin.
Temel Bilgiler sekmesinde formu doldurun. Formu tamamlamak için kılavuz olarak aşağıdaki tabloyu kullanın:
Ayar
Önerilen değer
Açıklama
Abonelik
Abonelik adınız.
Sunucunuz için kullanmak istediğiniz Azure aboneliği. Birden çok aboneliğiniz varsa kaynak için faturalandırılacak aboneliği seçin.
Kaynak grubu
myresourcegroup
Yeni bir kaynak grubu adı veya aboneliğinizde var olan bir kaynak grubu.
Ad
myasa
Azure Spring Apps hizmetinizi tanımlayan benzersiz bir ad. Ad 4 ile 32 karakter uzunluğunda olmalıdır ve yalnızca küçük harf, sayı ve kısa çizgi içerebilir. Hizmet adının ilk karakteri bir harf, son karakter ise harf veya sayı olmalıdır.
Plan
Temel
Fiyatlandırma planı, örneğinizle ilişkili kaynağı ve maliyeti belirler.
Bölge
Kullanıcılarınıza en yakın bölge.
Kullanıcılarınız için en yakın olan konum.
Alanlar Arası Yedekli
Seçili değil
Azure Spring Apps hizmetinizi bir Azure kullanılabilirlik alanında oluşturup oluşturmayacağınız. Şu anda bu özellik yalnızca bazı bölgelerde desteklenmektedir.
Seçimlerinizi gözden geçirmek için Gözden Geçir ve Oluştur'u seçin. Ardından Oluştur'u seçerek Azure Spring Apps örneğini sağlayın.
Araç çubuğunda, dağıtım sürecini izlemek için Bildirimler simgesini (zil) seçin. Dağıtım tamamlandıktan sonra Panoya sabitle'yi seçerek Azure portalı panonuzda hizmetin Genel Bakış sayfasının kısayolu olarak bu hizmet için bir kutucuk oluşturabilirsiniz. Hizmetin Genel Bakış sayfasını açmak için Kaynağa git'i seçin.
3.3. PostgreSQL örneğini hazırlama
PostgreSQL için Azure Veritabanı sunucusu oluşturmak için aşağıdaki adımları kullanın:
Azure portalda Kaynak oluştur’u seçin.
Veritabanları> PostgreSQL için Azure Veritabanı Esnek Sunucu'PostgreSQL için Azure Veritabanı seçin.
Temel Bilgiler sekmesini aşağıdaki bilgilerle doldurun:
Sunucu adı: my-demo-pgsql
Bölge: Doğu ABD
PostgreSQL sürümü: 14
İş yükü türü: Geliştirme
Yüksek kullanılabilirliği etkinleştirme: seçilmemiş
Kimlik doğrulama yöntemi: Yalnızca PostgreSQL kimlik doğrulaması
Yönetici kullanıcı adı: myadmin
Parola ve Parolayı onayla: Bir parola girin.
Aşağıdaki bilgileri kullanarak Ağ sekmesini yapılandırın:
Bağlantı yöntemi: Genel erişim (izin verilen IP adresleri)
Azure'ın içindeki herhangi bir Azure hizmetinden bu sunucuya genel erişime izin ver: seçili
Seçimlerinizi gözden geçirmek için Gözden geçir + oluştur'u ve ardından sunucuyu sağlamak için Oluştur'u seçin. Bu işlem birkaç dakika sürebilir.
Azure portalında PostgreSQL sunucunuza gidin.
Veritabanı oluşturmak için gezinti menüsünden Veritabanları'nı (örneğin, Todo) seçin.
3.4. Uygulama örneğini PostgreSQL örneğine bağlama
Hizmet örneklerinizi bağlamak için aşağıdaki adımları kullanın:
Azure portalında Azure Spring Apps örneğine gidin.
Gezinti bölmesinden Uygulamalar bölmesini açın ve Uygulama Oluştur'u seçin.
Uygulama Oluştur sayfasında, uygulama adı için simple-todo-web kullanın ve çalışma zamanı platformu için Java 17'yi seçin.
Uygulama oluşturmayı tamamlamak için Oluştur'u seçin ve ayrıntıları görüntülemek için uygulamayı seçin.
Gezinti bölmesinden Hizmet Bağlayıcısı'nı ve ardından Oluştur'u seçerek yeni bir hizmet bağlantısı oluşturun.
Temel Bilgiler sekmesini aşağıdaki bilgilerle doldurun:
Hizmet türü: PostgreSQL esnek sunucusu için DB
Bağlantı adı: Değiştirebileceğiniz otomatik olarak oluşturulan bir adla doldurulur.
Sonraki: Kimlik Doğrulaması sekmesini aşağıdaki bilgilerle yapılandırın:
İşlem hizmetinizle hedef hizmet arasında kullanmak istediğiniz kimlik doğrulama türünü seçin.: Bağlantı dizesi'ni seçin.
Devam edin...: Veritabanı kimlik bilgileri'ne tıklayın.
Kullanıcı adı: myadmin
Parola: Parolanızı girin.
İleri: Ağ'ı seçin. Hedef hizmete erişimi etkinleştirmek için güvenlik duvarı kurallarını yapılandır varsayılan seçeneğini kullanın..
Seçimlerinizi gözden geçirmek için İleri: Gözden Geçir ve Oluştur'u ve ardından oluştur'u seçerek bağlantıyı oluşturun.
Azure Spring Apps örneği ve PostgreSQL için Azure Veritabanı örneği oluşturmak için aşağıdaki adımları kullanın:
Azure'da OAuth2 ile oturum açmak için aşağıdaki komutu kullanın. Zaten oturum açtıysanız bu adımı yoksayın.
azd auth login
Konsol, aşağıdaki örneğe benzer iletiler gönderir:
Logged in to Azure.
Şablonu standart planla ayarlamak için aşağıdaki komutu kullanın:
azd env set PLAN standard
Şablonun altyapısını Azure'a sağlamak için aşağıdaki komutu kullanın:
azd provision
Aşağıdaki listede komut etkileşimleri açıklanmaktadır:
Kullanılacak azure aboneliğini seçin: Taşımak için okları kullanın, filtrelemek için yazın ve ENTER tuşuna basın.
Kullanılacak azure konumunu seçin: Taşımak için okları kullanın, filtrelemek için yazın ve ENTER tuşuna basın.
Konsol, aşağıdaki örneğe benzer iletiler gönderir:
SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Not
Bu komutun tamamlanması biraz zaman alabilir. Azure kaynaklarını sağlarken bir ilerleme göstergesi görürsünüz.
Aşağıdaki listede komut etkileşimleri açıklanmaktadır:
Yapılandıracak alt modülleri seçin: Yapılandırılan modülü seçin ve simpleTodo Web modülünün numarasını girin.
OAuth2 oturum açma: OAuth2 protokolüne göre Azure'da oturum açmayı yetkilendirilin.
Aboneliği seçin: Oluşturduğunuz Azure Spring Apps örneğinin abonelik listesi numarasını seçin ve varsayılan olarak listedeki ilk aboneliği seçin. Varsayılan sayıyı kullanıyorsanız, doğrudan ENTER tuşuna basın.
Azure Spring Apps'i seçin: Oluşturduğunuz Azure Spring Apps örneğinin numarasını seçin. Varsayılan sayıyı kullanıyorsanız, doğrudan ENTER tuşuna basın.
Bu uygulama için genel erişimi kullanıma sunma: y tuşuna basın.
Yukarıdaki tüm yapılandırmaları (Y/n) kaydetmeyi onaylayın: y tuşuna basın. n tuşuna basarsanız yapılandırma POM dosyalarına kaydedilmez.
Uygulamayı dağıtmak için aşağıdaki komutu kullanın:
./mvnw azure-spring-apps:deploy
Aşağıdaki listede komut etkileşimi açıklanmaktadır:
OAuth2 oturum açma: OAuth2 protokolüne göre Azure'da oturum açmayı yetkilendirmeniz gerekir.
Komut yürütüldükten sonra, dağıtımın başarılı olduğunu aşağıdaki günlük iletilerinden görebilirsiniz:
[INFO] Deployment(default) is successfully created
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
[INFO] InstanceName:simple-todo-web-default-x-xxxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:UNREGISTERED
[INFO] InstanceName:simple-todo-web-default-x-xxxxxxxxx-xxxxx Status:Terminating Reason:null DiscoverStatus:UNREGISTERED
[INFO] Getting public url of app(simple-todo-web)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-simple-todo-web.azuremicroservices.io
Çıktı Uygulama URL'si , uygulamaya erişmek todo için uç noktadır.
Artık uygulamayı Azure Spring Apps'e dağıtabilirsiniz. Uygulamayı paketlemek, web uygulamasının gerektirdiği Azure kaynaklarını sağlamak ve ardından Azure Spring Apps'e dağıtmak için aşağıdaki adımları kullanın:
Uygulamanızın dağıtılabilir bir kopyasını paketlemek için aşağıdaki komutu kullanın:
azd package
Konsol, aşağıdaki örneğe benzer iletiler gönderir:
SUCCESS: Your application was packaged for Azure in xx seconds.
Uygulama kodunu yeni sağlanan kaynaklara dağıtmak için aşağıdaki komutu kullanın:
azd deploy
Konsol, aşağıdaki örneğe benzer iletiler gönderir:
Deploying services (azd deploy)
(✓) Done: Deploying service simple-todo-web
- Endpoint: https://<your-Azure-Spring-Apps-instance-name>-simple-todo-web.azuremicroservices.io/
SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Çıkış Uç Noktası , uygulamaya erişen todo uç noktadır.
Not
Önceki üç komutu birleştirmek için de kullanabilirsiniz azd up : azd package (uygulamanızın dağıtılabilir bir kopyasını paketler), azd provision (Azure kaynaklarını sağlar) ve azd deploy (uygulama kodunu dağıtır). Daha fazla bilgi için bkz . Azure-Samples/ASA-Samples-Web-Application.
5. Web uygulamasını doğrulama
Artık dağıtılan uygulamaya erişerek çalışıp çalışmadığını görebilirsiniz.
Dağıtım tamamlandıktan sonra uygulama URL'sini dağıtım çıkışlarından bulabilirsiniz:
Çıkış uygulaması URL'si ile uygulamaya erişin. Sayfa localhost'ta gördüğünüz gibi görünmelidir.
Dağıtım sorunlarını araştırmak için yararlı olan her kaynak dağıtımının ayrıntılarını denetleyin.
Çıkış uygulaması URL'si ile uygulamaya erişin. Sayfa localhost'ta gördüğünüz gibi görünmelidir.
Doğrulamak için aşağıdaki adımları kullanın:
Dağıtım tamamlandıktan sonra uygulamaya şu URL ile erişebilirsiniz: https://${AZURE_SPRING_APPS_NAME}-${APP_NAME}.azuremicroservices.io/. Sayfa localhost'ta gördüğünüz gibi görünmelidir.
Herhangi bir dağıtım sorununu araştırmak üzere uygulamanın günlüğünü denetlemek için aşağıdaki komutu kullanın:
az spring app logs \
--service ${AZURE_SPRING_APPS_NAME} \
--name ${APP_NAME}
Dağıtım tamamlandıktan sonra, dağıtım çıkışlarından uygulama URL'sini bulun:
Uygulama URL'sine erişin. Sayfa localhost'ta gördüğünüz gibi görünmelidir.
Dağıtım sorunlarını araştırmak için yararlı olan her kaynak dağıtımının ayrıntılarını denetleyin.
Çıkış uygulaması URL'si ile uygulamaya erişin. Sayfa localhost'ta gördüğünüz gibi görünmelidir.
Çıkış uç noktası ile uygulamaya erişin. Sayfa localhost'ta gördüğünüz gibi görünmelidir.
6. Kaynakları temizleme
Artık ihtiyacınız kalmadığında bu makalede oluşturduğunuz kaynakları sildiğinizden emin olun. Kaynak grubundaki tüm kaynakları içeren Azure kaynak grubunu silebilirsiniz.
