Alıştırma - Azure DevOps ortamınızı ayarlama
Bu bölümde Azure DevOps kuruluşunuzun bu modülün geri kalanını tamamlayacak şekilde ayarlandığından emin olacaksınız. Ayrıca dağıtacağınız Azure Uygulaması Hizmeti ortamlarını da oluşturursunuz.
Bu görevleri gerçekleştirmek için şunları yapın:
- Azure DevOps'un Azure aboneliğinize bağlanadığından emin olmak için bir kullanıcı ekleyin.
- Bu modül için bir Azure DevOps projesi ayarlayın.
- Azure Boards'ta bu modülün iş öğesini Doing sütununa taşıyın.
- Azure Cloud Shell'de Azure CLI kullanarak Azure Uygulaması Hizmeti ortamlarını oluşturun.
- App Service ortamlarınızın adlarını tanımlayan işlem hattı değişkenleri oluşturun.
- Azure Pipelines'ın Azure aboneliğinize güvenli bir şekilde erişmesini sağlayan bir hizmet bağlantısı oluşturun.
Azure DevOps'a kullanıcı ekleme
Bu modülü tamamlamak için kendi Azure aboneliğiniz olmalıdır. Azure'ı ücretsiz kullanmaya başlayabilirsiniz.
Azure DevOps ile çalışmak için Bir Azure aboneliğine ihtiyacınız olmasa da, burada Azure aboneliğinizdeki kaynaklara dağıtım yapmak için Azure DevOps kullanacaksınız. İşlemi basitleştirmek için aynı Microsoft hesabı altında hem Azure aboneliğinizde hem de Azure DevOps kuruluşunuzda oturum açın.
Azure ve Azure DevOps'ta oturum açmak için farklı Microsoft hesapları kullanıyorsanız, Azure'da oturum açmak için kullandığınız Microsoft hesabı altında DevOps kuruluşunuza bir kullanıcı ekleyin. Daha fazla bilgi için bkz . Kuruluşunuza veya projenize kullanıcı ekleme. Kullanıcıyı eklediğinizde Temel erişim düzeyini seçin.
Ardından Azure DevOps oturumunu kapatın. Ardından Azure aboneliğinizde oturum açmak için kullandığınız Microsoft hesabı altında yeniden oturum açın.
Azure DevOps projesini alma
Burada Azure DevOps kuruluşunuzun bu modülün geri kalanını tamamlayacak şekilde ayarlandığından emin olun. Bu görevi, Azure DevOps'ta proje oluşturan bir şablon çalıştırarak gerçekleştirirsiniz.
Bu öğrenme yolundaki modüller, Tailspin web ekibini DevOps yolculuklarında takip ederken bir ilerleme oluşturur. Öğrenme amacıyla her modülün ilişkili bir Azure DevOps projesi vardır.
Şablonu çalıştır
Azure DevOps kuruluşunuzdaki her şeyi ayarlayan bir şablon çalıştırın.
Şablonu çalıştırmak için Azure DevOps Demo Generator sitesinden şu adımları izleyin:
Oturum Aç'ı seçin ve kullanım koşullarını kabul edin.
Yeni Proje Oluştur sayfasında Azure DevOps kuruluşunuzu seçin. Ardından Space Game - web - İşlevsel testler gibi bir proje adı girin.
Evet, bu deponun çatalı yapmak istiyorum'ı seçin. Ardından Yetki ver'i seçin.
Proje Oluştur'u seçin.
Şablonun çalıştırılması birkaç dakika sürer.
Azure DevOps'ta projenize gitmek için Projeye git'i seçin.
Önemli
Bu modülün Azure DevOps ortamınızı temizleme sayfasında önemli temizleme adımları verilmiştir. Temizleme işlemi ücretsiz derleme dakikalarınızı tüketmemenize yardımcı olur. Bu modülü tamamlamazsanız bile temizleme adımlarını gerçekleştirdiğinizden emin olun.
Projenizin görünürlüğünü ayarlama
Başlangıçta, GitHub'daki Space Game deposu çatalınız genel olarak ayarlanırken Azure DevOps şablonu tarafından oluşturulan proje özel olarak ayarlanır. GitHub'daki genel bir depoya herkes erişebilirken, özel bir depoya yalnızca siz ve paylaşmayı seçtiğiniz kişiler erişebilir. Benzer şekilde, Azure DevOps'ta genel projeler kimliği doğrulanmamış kullanıcılara salt okunur erişim sağlarken, özel projeler ise kullanıcılara hizmetlere erişmek için erişim verilmesini ve kimlik doğrulaması yapılmasını gerektirir.
Şu anda bu ayarların herhangi birini bu modülün amaçları doğrultusunda değiştirmek gerekli değildir. Ancak kişisel projeleriniz için başkalarına vermek istediğiniz görünürlüğü ve erişimi belirlemeniz gerekir. Örneğin, projeniz açık kaynak ise hem GitHub deponuzu hem de Azure DevOps projenizi genel yapmayı seçebilirsiniz. Projeniz özelse genellikle hem GitHub deponuzu hem de Azure DevOps projenizi özel hale getirirsiniz.
Daha sonra, projeniz için en uygun seçeneği belirlemede aşağıdaki kaynakları yararlı bulabilirsiniz:
- Özel ve genel projeleri kullanma
- Hızlı Başlangıç: Özel projenizi genel yapma
- Depo görünürlüğünü ayarlama
İş öğesini Yapılıyor durumuna geçirme
Bu bölümde, Azure Boards'ta bu modülle ilgili bir iş öğesi atayacaksınız. Ayrıca iş öğesini De Yapıyor durumuna taşırsınız . Pratikte, ekibiniz her sprint veya iş yinelemesinin başında iş öğeleri oluşturur.
İşi bu şekilde atamak, çalışmanız için bir denetim listesi sağlar. Ekibinize üzerinde çalıştığınız şey ve kalan çalışma miktarı hakkında görünürlük sağlar. Ayrıca, ekibin aynı anda çok fazla iş yapmaktan kaçınmak için devam eden çalışma (WIP) sınırlarını zorlamasına da yardımcı olur.
Takımın geçerli sprint için şu en önemli sorunları çözdüğünü hatırlayın:
Not
Azure DevOps kuruluşunda iş öğeleri sırayla numaralandırılır. Projenizde, her iş öğesinin numarası burada gördüklerinizle eşleşmeyebilir.
Burada, Kalite testlerini otomatikleştir üçüncü öğeyi Yapıyor sütununa taşırsınız. Ardından kendinizi iş öğesine atarsınız. Kalite testlerini otomatikleştirme, Space Game web sitesi için kullanıcı arabirimi testlerini otomatikleştirmeyle ilgilidir.
İş öğesini ayarlamak için:
Azure DevOps'ta Panolar'a gidin ve menüden Panolar'ı seçin.
Kalite testlerini otomatikleştir iş öğesinde kartın altındaki aşağı oku seçin. iş öğesini kendinize atayın.
İş öğesini Yapılacaklar sütunundan Do sütununa taşıyın.
Bu modülün sonunda, görevi tamamladıktan sonra kartı Bitti sütununa taşıyacaksınız.
Projeyi yerel olarak ayarlama
Burada Visual Studio Code'da Space Game projesini yükleyip Git'i yapılandırabilir, deponuzu yerel olarak kopyalayabilir ve başlangıç kodunu indirebilmeniz için yukarı akış uzak alanını ayarlayabilirsiniz.
Not
mslearn-tailspin-spacegame-web-deploy projesini yerel olarak ayarladıysanız, sonraki bölüme geçebilirsiniz.
Tümleşik terminali açma
Visual Studio Code tümleşik bir terminalle birlikte gelir. Burada hem dosyaları düzenler hem de komut satırından çalışırsınız.
Visual Studio Code’u başlatın.
Görünüm menüsünde Terminal'i seçin.
Açılan listede Git Bash'i seçin. Kullanmayı tercih ettiğiniz başka bir Unix kabuğunu biliyorsanız, bunun yerine bu kabuğu seçin.
Terminal penceresinde sisteminizde yüklü olan herhangi bir kabuğu seçebilirsiniz. Örneğin Git Bash veya PowerShell ya da başka bir kabuk seçebilirsiniz.
Burada, Git komutlarını çalıştırmayı kolaylaştıran Windows için Git'in bir parçası olan Git Bash'i kullanacaksınız.
cd
Çalışmak istediğiniz dizine gitmek için komutunu çalıştırın. İsterseniz giriş dizininizi (~
) veya farklı bir dizini seçin.cd ~
Git'i yapılandırma
Git ve GitHub'da yeniyseniz, önce kimliğinizi Git ile ilişkilendirmek ve GitHub ile kimlik doğrulaması yapmak için birkaç komut çalıştırın. Daha fazla bilgi için bkz . Git'i ayarlama.
En azından aşağıdaki adımları tamamlamanız gerekir. Tümleşik terminalden komutları çalıştırın.
- Kullanıcı adınızı ayarlayın.
- İşleme e-posta adresinizi ayarlayın.
- GitHub parolanızı önbelleğe alın.
Not
GitHub ile iki öğeli kimlik doğrulamasını zaten kullanıyorsanız kişisel erişim belirteci oluşturun. İstendiğinde parolanızın yerine belirtecinizi kullanın.
Erişim belirtecinize parola gibi davranın. Güvenli bir yerde tut.
Visual Studio Code'da projenizi ayarlama
Azure DevOps ile uygulama oluşturma öğrenme yolunda, bir Git deposunu çatallayıp kopyaladıysanız. Depo, Space Game web sitesinin kaynak kodunu içerir. Çatalınız, Değişiklikleri GitHub'a gönderdiğinizde derlemenin çalışması için Azure DevOps'taki projelerinize bağlandı.
Önemli
Bu öğrenme yolunda mslearn-tailspin-spacegame-web-deploy adlı farklı bir Git deposuna geçeceğiz. Azure DevOps projenizi ayarlamak için şablonu çalıştırdığınızda, işlem sizin için depoyu otomatik olarak çatalladı.
Bu bölümde, işlem hattı yapılandırmanızı değiştirip oluşturabilmeniz için çatalınızı yerel olarak kopyalamış olursunuz.
Çatalınızı yerel olarak kopyalama
Artık GitHub hesabınızda Space Game web projesinin bir kopyası var. Artık bilgisayarınıza bir kopya indirerek veya kopyalayarak bu kopyayla çalışabilirsiniz.
Bir kopya, tıpkı çatal gibi bir deponun kopyasıdır. Bir depoyu kopyaladığınızda, değişiklikler yapabilir, beklediğiniz gibi çalıştıklarını doğrulayabilir ve ardından bu değişiklikleri GitHub'a yükleyebilirsiniz. Yerel kopyanızı, diğer kimliği doğrulanmış kullanıcıların deponuzun GitHub kopyasında yaptığı değişikliklerle de eşitleyebilirsiniz.
Space Game web projesini bilgisayarınıza kopyalamak için:
GitHub'da Space Game web projesi (mslearn-tailspin-spacegame-web-deploy) çatalınıza gidin.
Kod’u seçin. Ardından, HTTPS sekmesinde, URL'yi panonuza kopyalamak için gösterilen URL'nin yanındaki düğmeyi seçin.
Visual Studio Code'da terminal penceresine gidin.
Terminalde, çalışmak istediğiniz dizine gidin. İsterseniz giriş dizininizi (
~
) veya farklı bir dizini seçin.cd ~
git clone
komutunu çalıştırın. Burada gösterilen URL'yi panonuzun içeriğiyle değiştirin:git clone https://github.com/your-name/mslearn-tailspin-spacegame-web-deploy.git
Dizine
mslearn-tailspin-spacegame-web-deploy
gitme. Bu, deponuzun kök dizinidir.cd mslearn-tailspin-spacegame-web-deploy
Yukarı akış uzakını ayarlama
Uzak, ekip üyelerinin işbirliği yaptığı bir Git deposudur (GitHub'daki bir depo gibi). Burada, en son örnek kodu alabilmeniz için uzaktan kumandalarınızı listeleyip Microsoft'un depo kopyasına işaret eden bir uzak sunucu eklersiniz.
Uzaktan kumandalarınızı listelemek için şu
git remote
komutu çalıştırın:git remote -v
Deponuza hem getirme (indirme) hem de gönderme (karşıya yükleme) erişiminiz olduğunu görürsünüz:
origin https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (fetch) origin https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (push)
Kaynak , GitHub'daki deponuzu belirtir. Kodu başka bir depodan çatalladığınızda, özgün uzak (çatalını oluşturduğunuz) genellikle yukarı akış olarak adlandırılır.
Microsoft deposunu işaret eden yukarı akış adlı bir uzak sunucu oluşturmak için şu
git remote add
komutu çalıştırın:git remote add upstream https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web-deploy.git
Değişiklikleri görmek için yeniden çalıştırın
git remote
:git remote -v
Deponuza hem getirme (indirme) hem de gönderme (karşıya yükleme) erişiminizin olduğunu görürsünüz. Artık Microsoft deposuna getirme erişiminiz de vardır:
origin https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (fetch) origin https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (push) upstream https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web-deploy.git (fetch)
Projeyi dosya gezgininde açma
Visual Studio Code'da terminal pencereniz Space Game web projesinin kök dizinini gösterir. Yapısını görüntülemek ve dosyalarla çalışmak için dosya gezgininden projeyi açacaksınız.
Projeyi açmanın en kolay yolu Visual Studio Code'un geçerli dizinde yeniden açılmasıdır. Bunu yapmak için, tümleşik terminalden aşağıdaki komutu çalıştırın:
code -r .
Dizini ve dosya ağacını dosya gezgininde görürsünüz.
Tümleşik terminali yeniden açın. Terminal sizi web projenizin köküne yerleştirir.
code
Komut başarısız olursa, sistem PATH'inize Visual Studio Code eklemeniz gerekir. Yapmak için:
- Visual Studio Code'da F1'i seçin veya komut paletine erişmek için Komut Paletini Görüntüle'yi>seçin.
- Komut paletine Shell Command: Install 'code' command in PATH yazın.
- Projeyi dosya gezgininde açmak için önceki yordamı yineleyin.
Artık yerel geliştirme ortamınızdan Space Game kaynak kodu ve Azure Pipelines yapılandırmanızla çalışacak şekilde ayarlandınız.
Azure Uygulaması Hizmeti ortamlarını oluşturma
Burada işlem hattı aşamalarını tanımlayan ortamları oluşturursunuz. Her aşamaya karşılık gelen bir App Service örneği oluşturursunuz: Geliştirme, Test ve Hazırlama.
Azure Pipelines kullanarak çok aşamalı işlem hattı oluşturma modülünde, App Service örneklerinizi oluşturmak için Azure CLI'yi kullandınız. Burada da aynısını yapacaksınız.
Önemli
Bu modüldeki alıştırmaları tamamlamak için kendi Azure aboneliğinize ihtiyacınız olacaktır.
Azure portalı aracılığıyla Cloud Shell'i öne çıkarma
- Azure portalına gidin ve oturum açın.
- Menü çubuğunda Cloud Shell'i seçin. İstendiğinde Bash deneyimini seçin.
Bir Azure bölgesi seçin
Burada, Azure kaynaklarınızın oluşturulacağı varsayılan bölgeyi veya coğrafi konumu belirtirsiniz.
Cloud Shell'de aşağıdaki
az account list-locations
komutu çalıştırarak Azure aboneliğinizden kullanılabilen bölgeleri listeleyin.az account list-locations \ --query "[].{Name: name, DisplayName: displayName}" \ --output table
Çıktıdaki Ad sütunundan size yakın bir bölge seçin. Örneğin eastasia veya westus2'yi seçin.
Varsayılan bölgenizi ayarlamak için komutunu çalıştırın
az configure
. REGION> değerini seçtiğiniz bölgenin adıyla değiştirin<.az configure --defaults location=<REGION>
Westus2'yi varsayılan bölge olarak ayarlayan bir örnek aşağıda verilmişti:
az configure --defaults location=westus2
App Service örneklerini oluşturma
Burada, dağıtacağınız üç aşama için App Service örneklerini oluşturursunuz: Geliştirme, Test ve Hazırlama.
Not
Öğrenme amacıyla, burada varsayılan ağ ayarlarını kullanırsınız. Bu ayarlar sitenizi İnternet'ten erişilebilir hale getirir. Uygulamada, web sitenizi İnternet'e yönlendirilemeyen ve yalnızca sizin ve ekibinizin erişebileceği bir ağa yerleştiren bir Azure sanal ağı yapılandırabilirsiniz. Daha sonra hazır olduğunuzda, web sitesini kullanıcılarınız için kullanılabilir hale getirmek için ağınızı yeniden yapılandırabilirsiniz.
Cloud Shell'den, web uygulamanızın etki alanı adını benzersiz hale getiren rastgele bir sayı oluşturun.
webappsuffix=$RANDOM
Tailspin-space-game-rg adlı bir kaynak grubu oluşturmak için aşağıdaki
az group create
komutu çalıştırın.az group create --name tailspin-space-game-rg
Tailspin-space-game-asp adlı bir App Service planı oluşturmak için aşağıdaki
az appservice plan create
komutu çalıştırın.az appservice plan create \ --name tailspin-space-game-asp \ --resource-group tailspin-space-game-rg \ --sku B1 \ --is-linux
--sku
bağımsız değişkeni, Temel katmanda çalışan B1 planını belirtir. bağımsız değişkeni Linux--is-linux
çalışanlarının kullanılacağını belirtir.Önemli
B1 SKU'su Azure aboneliğinizin bir parçası değilse S1 (Standart) gibi farklı bir plan seçin.
Geliştirme, Test ve Hazırlama ortamlarının her biri için birer tane olmak üzere üç App Service örneği oluşturmak için aşağıdaki
az webapp create
komutları çalıştırın.az webapp create \ --name tailspin-space-game-web-dev-$webappsuffix \ --resource-group tailspin-space-game-rg \ --plan tailspin-space-game-asp \ --runtime "DOTNET|6.0" az webapp create \ --name tailspin-space-game-web-test-$webappsuffix \ --resource-group tailspin-space-game-rg \ --plan tailspin-space-game-asp \ --runtime "DOTNET|6.0" az webapp create \ --name tailspin-space-game-web-staging-$webappsuffix \ --resource-group tailspin-space-game-rg \ --plan tailspin-space-game-asp \ --runtime "DOTNET|6.0"
Öğrenme amacıyla, burada her App Service örneğine aynı App Service planını (B1 Temel) uygularsınız. Uygulamada, beklenen iş yükünüzle eşleşen bir plan atarsınız.
Her App Service örneğinin ana bilgisayar adını ve durumunu listelemek için aşağıdaki
az webapp list
komutu çalıştırın.az webapp list \ --resource-group tailspin-space-game-rg \ --query "[].{hostName: defaultHostName, state: state}" \ --output table
Çalışan her hizmetin ana bilgisayar adını not edin. Daha sonra çalışmanızı doğruladığınızda bu konak adlarına ihtiyacınız olacaktır. Bir örnek aşağıda verilmiştir:
HostName State ------------------------------------------------------- ------- tailspin-space-game-web-dev-21017.azurewebsites.net Running tailspin-space-game-web-test-21017.azurewebsites.net Running tailspin-space-game-web-staging-21017.azurewebsites.net Running
İsteğe bağlı bir adım olarak, çalıştıklarını ve varsayılan giriş sayfasının görüntülendiğini doğrulamak için bir veya daha fazla adı kopyalayıp tarayıcınıza yapıştırın.
Şu sayfayı almalısınız:
Önemli
Bu modülün Azure DevOps ortamınızı temizleme sayfasında önemli temizleme adımları verilmiştir. Temizleme, bu modülü tamamladıktan sonra Azure kaynakları için ücret alınmamasını sağlamaya yardımcı olur. Bu modülü tamamlamazsanız bile temizleme adımlarını gerçekleştirdiğinizden emin olun.
Azure Pipelines'da işlem hattı değişkenleri oluşturma
Azure Pipelines kullanarak çok aşamalı işlem hattı oluşturma bölümünde, App Service örneklerinin her biri için işlem hattınızdaki Geliştirme, Test ve Hazırlama aşamalarına karşılık gelen bir değişken eklediniz. Burada, sen de aynısını yap.
İşlem hattı yapılandırmanızdaki her aşama, dağıtılacak App Service örneğini belirlemek için bu değişkenleri kullanır.
Değişkenleri eklemek için:
Azure DevOps'ta Space Game - web - İşlevsel testler projenize gidin.
İşlem Hatları'nın altında Kitaplık'ı seçin.
+ Değişken grubu'nun seçin.
Özellikler'in altında, değişken grubu adı için Release yazın.
Değişkenler'in altında + Ekle'yi seçin.
Değişkeninizin adı olarak WebAppNameDev girin. Değeri için Tailspin-space-game-web-dev-1234 gibi Geliştirme ortamınıza karşılık gelen App Service örneğinin adını girin.
Bu tabloda gösterildiği gibi Test ve Hazırlama ortamlarınızda değişken oluşturmak için 5. ve 6. adımları iki kez daha yineleyin:
Değişken adı Örnek değer WebAppNameTest tailspin-space-game-web-test-1234 WebAppNameStaging tailspin-space-game-web-staging-1234 Her örnek değeri ortamınıza karşılık gelen App Service örneğiyle değiştirmeyi unutmayın.
Önemli
Konak adını değil App Service örneğinin adını ayarlayın. Bu örnekte, tailspin-space-game-web-dev-1234.azurewebsites.net değil tailspin-space-game-web-dev-1234 girersiniz.
Değişkeninizi işlem hattına kaydetmek için sayfanın üst kısmındaki Kaydet'i seçin.
Değişken grubunuz şuna benzemelidir:
Geliştirme, test ve hazırlama ortamları oluşturma
Azure Pipelines kullanarak çok aşamalı işlem hattı oluşturma bölümünde geliştirme, test ve hazırlama ortamları için ortamlar oluşturdunuz. Burada işlemi tekrarlarsınız. Ancak bu kez, değişiklikleri bir aşamadan diğerine yükseltmek için insan onayı gereksinimi gibi ek ölçütleri atlarsınız.
Geliştirme, test ve hazırlama ortamlarını oluşturmak için:
Azure Pipelines'da Ortamlar'ı seçin.
Geliştirme ortamını oluşturmak için:
- Ortam oluştur'u seçin.
- Ad'ın altına dev girin.
- Kalan alanları varsayılan değerlerinde bırakın.
- Oluştur'u belirleyin.
Test ortamını oluşturmak için:
- Ortamlar sayfasına dönün.
- Yeni ortam'ı seçin.
- Ad'ın altına test yazın.
- Oluştur'u belirleyin.
Hazırlama ortamını oluşturmak için:
- Ortamlar sayfasına dönün.
- Yeni ortam'ı seçin.
- Ad'ın altında hazırlama yazın.
- Oluştur'u belirleyin.
Hizmet bağlantısı oluşturma
Burada Azure Pipelines'ın Azure aboneliğinize erişmesini sağlayan bir hizmet bağlantısı oluşturacaksınız. Azure Pipelines, web sitesini App Service'e dağıtmak için bu hizmet bağlantısını kullanır. Önceki modülde benzer bir hizmet bağlantısı oluşturdunuz.
Önemli
Aynı Microsoft hesabı altında hem Azure portalında hem de Azure DevOps'ta oturum açtığınızdan emin olun.
Azure DevOps'ta Space Game - web - İşlevsel testler projenize gidin.
Sayfanın alt köşesinden Proje ayarları'nı seçin.
İşlem hatları altından Hizmet bağlantıları'nı seçin.
Yeni hizmet bağlantısı'nı ve ardından Azure Resource Manager'ı ve ardından İleri'yi seçin.
Sayfanın üst kısmında Hizmet sorumlusu (otomatik). Sonra İleri'yi seçin.
Şu alanları doldurun:
Alan Değer Kapsam düzeyi Abonelik Abonelik Azure aboneliğiniz Kaynak Grubu tailspin-space-game-rg Hizmet bağlantısı adı Resource Manager - Tailspin - Uzay Oyunu İşlem sırasında Microsoft hesabınızda oturum açmanız istenebilir.
Tüm işlem hatlarına erişim izni ver seçeneğinin belirlendiğinden emin olun.
Kaydet'i seçin.
Azure DevOps, Azure aboneliğinize bağlanabildiğini doğrulamak için bir test bağlantısı gerçekleştirir. Azure DevOps bağlanamıyorsa ikinci kez oturum açma şansınız olur.