Wprowadzenie: instalowanie narzędzia Jenkins na maszynie wirtualnej z systemem Linux platformy Azure

W tym artykule pokazano, jak zainstalować narzędzie Jenkins na maszynie wirtualnej z systemem Ubuntu Linux przy użyciu narzędzi i wtyczek skonfigurowanych do pracy z platformą Azure.

W tym artykule dowiesz się, jak:

• Tworzenie pliku instalacyjnego, który pobiera i instaluje narzędzie Jenkins
• Tworzenie grupy zasobów
• Tworzenie maszyny wirtualnej przy użyciu pliku instalacyjnego
• Otwórz port 8080, aby uzyskać dostęp do serwera Jenkins na maszynie wirtualnej
• Nawiązywanie połączenia z maszyną wirtualną za pośrednictwem protokołu SSH
• Konfigurowanie przykładowego zadania narzędzia Jenkins na podstawie przykładowej aplikacji Java w usłudze GitHub
• Kompilowanie przykładowego zadania narzędzia Jenkins

1. Konfigurowanie środowiska

• Subskrypcja platformy Azure: jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.

2. Otwórz usługę Cloud Shell

1. Jeśli masz już otwartą sesję usługi Cloud Shell, możesz przejść do następnej sekcji.

2. Przejdź do witryny Azure Portal

3. W razie potrzeby zaloguj się do subskrypcji platformy Azure i zmień katalog platformy Azure.

4. Otwórz usługę Cloud Shell.

   

5. Jeśli wcześniej nie używałeś/łaś Cloud Shell, skonfiguruj ustawienia środowiska i przechowywania.

6. Wybierz środowisko wiersza polecenia.

   

3. Tworzenie maszyny wirtualnej

1. Utwórz katalog testowy o nazwie jenkins-get-started.

2. Przejdź do katalogu testowego.

3. Utwórz plik o nazwie cloud-init-jenkins.txt.

4. Wklej następujący kod do nowego pliku:

   #cloud-config
   package_upgrade: true
   runcmd:
     - sudo apt install openjdk-17-jre -y
     - curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null
     -  echo 'deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian-stable binary/' | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null
     - sudo apt-get update && sudo apt-get install jenkins -y
     - sudo service jenkins restart
   
   
   

5. Uruchom polecenie az group create , aby utworzyć grupę zasobów.

   az group create --name jenkins-get-started-rg --location eastus
   

6. Uruchom az vm create, aby utworzyć maszynę wirtualną.

   az vm create \
   --resource-group jenkins-get-started-rg \
   --name jenkins-get-started-vm \
   --image UbuntuLTS \
   --admin-username "azureuser" \
   --generate-ssh-keys \
   --public-ip-sku Standard \
   --custom-data cloud-init-jenkins.txt
   

7. Uruchom az vm list, aby zweryfikować tworzenie (i stan) nowej maszyny wirtualnej.

   az vm list -d -o table --query "[?name=='jenkins-get-started-vm']"
   

8. Gdy usługa Jenkins działa na porcie 8080, uruchom polecenie az vm open , aby otworzyć port 8080 na nowej maszynie wirtualnej.

   az vm open-port \
   --resource-group jenkins-get-started-rg \
   --name jenkins-get-started-vm  \
   --port 8080 --priority 1010
   

4. Konfigurowanie usługi Jenkins

1. Uruchom az vm show, aby uzyskać adres IP dla przykładowej maszyny wirtualnej.

   az vm show \
   --resource-group jenkins-get-started-rg \
   --name jenkins-get-started-vm -d \
   --query [publicIps] \
   --output tsv
   

   Kluczowe punkty:

   • Parametr --query ogranicza dane wyjściowe do publicznych adresów IP maszyny wirtualnej.

2. Przy użyciu adresu IP pobranego w poprzednim kroku połącz się przez SSH z maszyną wirtualną. Musisz potwierdzić żądanie połączenia.

   ssh azureuser@<ip_address>
   

   Kluczowe punkty:

   • Po pomyślnym nawiązaniu połączenia monit usługi Cloud Shell zawiera nazwę użytkownika i nazwę maszyny wirtualnej: azureuser@jenkins-get-started-vm.

3. Sprawdź, czy usługa Jenkins jest uruchomiona, uzyskując stan usługi Jenkins.

   service jenkins status
   

   Kluczowe punkty:

   • Jeśli wystąpi błąd dotyczący usługi, która nie istnieje, może być konieczne odczekenie kilku minut na zainstalowanie i zainicjowanie wszystkiego.

4. Pobierz automatycznie wygenerowane hasło serwera Jenkins.

   sudo cat /var/lib/jenkins/secrets/initialAdminPassword
   

5. Przy użyciu adresu IP otwórz następujący adres URL w przeglądarce: http://<ip_address>:8080

6. Wprowadź pobrane wcześniej hasło, a następnie wybierz pozycję Kontynuuj.

   

7. Wybierz wtyczkę do zainstalowania.

   

8. W polu filtru w górnej części strony wprowadź github. Wybierz wtyczkę GitHub i wybierz pozycję Zainstaluj.

   

9. Wprowadź informacje dla pierwszego użytkownika administratora, a następnie wybierz pozycję Zapisz i kontynuuj.

   

10. Na stronie Konfiguracja wystąpienia wybierz pozycję Zapisz i zakończ.

    

11. Wybierz pozycję Rozpocznij korzystanie z narzędzia Jenkins.

    

5. Tworzenie pierwszego zadania

1. Na stronie głównej narzędzia Jenkins wybierz pozycję Utwórz zadanie.

   

2. Wprowadź nazwę mySampleAppzadania , wybierz pozycję Projekt Freestyle, a następnie wybierz przycisk OK.

   

3. Wybierz kartę Zarządzanie kodem źródłowym . Włącz usługę Git i wprowadź następujący adres URL dla wartości Adres URL repozytorium : https://github.com/spring-guides/gs-spring-boot.git. Następnie zmień specyfikator gałęzi na */main.

   

4. Wybierz kartę Kompilacja , a następnie wybierz pozycję Dodaj krok kompilacji

   

5. Z menu rozwijanego wybierz pozycję Wywołaj skrypt narzędzia Gradle.

   

6. Wybierz Użyj wrappera Gradle, a następnie wprowadź complete w polu lokalizacji wrappera i build dla Zadania.

   

7. Wybierz Zaawansowane i wprowadź complete w polu Główny skrypt kompilacji.

   

8. Przewiń do dołu strony i wybierz pozycję Zapisz.

6. Skompiluj przykładową aplikację Java

1. Gdy zostanie wyświetlona strona główna projektu, wybierz pozycję Kompiluj teraz , aby skompilować kod i spakować przykładową aplikację.

   

2. Grafika poniżej nagłówka Historia kompilacji wskazuje, że zadanie jest kompilowane.

   

3. Po zakończeniu kompilacji wybierz link Obszar roboczy .

   

4. Przejdź do complete/build/libs, aby zobaczyć, że plik .jar został pomyślnie skompilowany.

   

5. Serwer Jenkins jest teraz gotowy do tworzenia własnych projektów na platformie Azure!

Rozwiązywanie problemów

Jeśli wystąpią jakiekolwiek problemy z konfigurowaniem serwera Jenkins, zapoznaj się ze stroną instalacji serwera Jenkins , aby uzyskać najnowsze instrukcje i znane problemy.

Dalsze kroki