Alıştırma - Azure DevOps ortamınızı ayarlama

Tamamlandı

Bu ünitede, Microsoft Azure DevOps kuruluşunuzun bu modülün geri kalanını tamamlayacak şekilde ayarlandığından emin olacaksınız.

Bunu yapmak için şunları yaparsınız:

  • 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.
  • Değişiklikleri işlem hattına gönderebilmek için projenizin yerel olarak ayarlandığından emin olun.

Azure DevOps projesini alma

Burada Azure DevOps kuruluşunuzun bu modülün geri kalanını tamamlayacak şekilde ayarlandığından emin olacaksınız. Bunu, Azure DevOps'ta sizin için bir proje oluşturan bir şablon çalıştırarak yapacaksınız.

Şablonu çalıştır

Azure DevOps kuruluşunuzda sizin için her şeyi ayarlayan bir şablon çalıştırın.

Şablonu çalıştırmak için Azure DevOps Demo Generator sitesinde aşağıdakileri yapın:

  1. Oturum Aç'ı seçin ve kullanım koşullarını kabul edin.

  2. Yeni Proje Oluştur sayfasında Azure DevOps kuruluşunuzu seçin ve ardından Space Game - web - Testler gibi bir proje adı girin.

  3. Evet, bu depoyu çatallamak istiyorum'un yanındaki kutuyu seçin ve ardından Yetki ver'i seçin. Bir pencere gösterilirse GitHub hesabınıza erişim yetkisi verin.

    Önemli

    Şablonun GitHub deponuza bağlanması için bu seçeneği belirtmeniz gerekir. Space Game web sitesi projesini önceden çatallamış olsanız bile seçin. Şablon mevcut çatalınızı kullanır.

  4. Proje Oluştur'u seçin.

    A screenshot of the Azure DevOps Demo Generator Create New Project screen with the Create Project button highlighted.

    Şablonun çalışması birkaç dakika sürer.

  5. 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:

Projeyi yerel olarak ayarlama

Burada, Visual Studio Code'da Space Game projesini yükler, Git'i yapılandırabilir, deponuzu yerel olarak kopyalayabilir ve başlangıç kodunu indirebilmeniz için yukarı akış uzak alanını ayarlarsınız.

Not

mslearn-tailspin-spacegame-web 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, böylece dosyaları düzenleyebilir ve komut satırından tek bir yerden çalışabilirsiniz.

  1. Visual Studio Code’u başlatın.

  2. Görünüm menüsünde Terminal'i seçin.

  3. Açılan listede bash'i seçin. Zsh gibi kullanmayı tercih ettiğiniz başka bir Unix kabuğunu biliyorsanız, bunun yerine bu kabuğu seçin.

    A screenshot of Visual Studio Code showing the location of the Bash shell.

    Terminal penceresi Bash, Zsh ve PowerShell gibi sisteminizde yüklü olan tüm kabukları seçmenize olanak tanır.

    Burada Bash'i kullanacaksınız. Windows için Git, Git komutlarını çalıştırmayı kolaylaştıran Git Bash'i sağlar.

    Not

    Windows'ta Git Bash'in seçenek olarak listelendiğini görmüyorsanız Git'i yüklediğinizden emin olun ve Visual Studio Code'u yeniden başlatın.

  4. cd Giriş dizininiz (~) gibi, çalışmak istediğiniz dizine gitmek için komutunu çalıştırın. İsterseniz farklı bir dizin seçebilirsiniz.

    cd ~
    

Git'i yapılandırma

Git ve GitHub'da yeniyseniz öncelikle kimliğinizi Git ile ilişkilendirmek ve GitHub ile kimlik doğrulaması yapmak için birkaç komut çalıştırmanız gerekir.

Git'i ayarlama işlemi daha ayrıntılı olarak açıklar.

En azından aşağıdaki adımları tamamlamanız gerekir. Tümleşik terminalden şu komutları çalıştırın:

  1. Kullanıcı adınızı ayarlayın.
  2. İşleme e-posta adresinizi ayarlayın.
  3. GitHub parolanızı önbelleğe alın.

Not

GitHub ile zaten iki öğeli kimlik doğrulaması kullanıyorsanız kişisel bir erişim belirteci oluşturun ve daha sonra istendiğ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

Bu bölümde, değişiklik yapabilmek ve işlem hattı yapılandırmanızı oluşturmak 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 sonra bu değişiklikleri GitHub'a geri yükleyebilirsiniz. Yerel kopyanızı, diğer kimliği doğrulanmış kullanıcıların GitHub'ın deponuzun kopyasında yaptığı değişikliklerle de eşitleyebilirsiniz.

Space Game web projesini bilgisayarınıza kopyalamak için:

  1. GitHub'da Space Game web projesi (mslearn-tailspin-spacegame-web) çatalınıza gidin.

  2. Kod’u seçin. Ardından, HTTPS sekmesinde, URL'yi panonuza kopyalamak için gösterilen URL'nin yanındaki düğmeyi seçin.

    Locating the URL and copy button from the GitHub repository.

  3. Visual Studio Code'da terminal penceresine gidin.

  4. Terminalde, giriş dizininiz (~) gibi, çalışmak istediğiniz dizine gidin. İsterseniz farklı bir dizin seçebilirsiniz.

    cd ~
    
  5. 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.git
    
  6. Dizine mslearn-tailspin-spacegame-web gitme. Bu, deponuzun kök dizinidir.

    cd mslearn-tailspin-spacegame-web
    

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.

  1. 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.git (fetch)
    origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (push)
    

    Kaynak , GitHub'daki deponuzu belirtir. Başka bir depodan kod çatalı oluştururken, özgün uzakı (çatalını oluşturduğunuz) yukarı akış olarak adlandırmak yaygın bir durumdur.

  2. 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.git
    
  3. Değişiklikleri görmek için ikinci kez ç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 ve gönderme erişimine de sahipsiniz:

    origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (fetch)
    origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (push)
    upstream        https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git (fetch)
    upstream        https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git (push)
    

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.

  1. 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.

  2. 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:

  1. Visual Studio Code'da F1'i seçin veya komut paletine erişmek için Komut Paletini Görüntüle'yi>seçin.
  2. Komut paletine Shell Command: Install 'code' command in PATH yazın.
  3. 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.