Självstudie: Använda Azure Storage för byggartefakter

  • Artikel
  • 4 minuter för att läsa

Viktigt

Många Azure-tjänster har Jenkins-plugin-program. Vissa av dessa plugin-program kommer att ha slut på support från och med 29 februari 2024. Azure CLI är det rekommenderade sättet att integrera Jenkins med Azure-tjänster. Mer information finns i artikeln Jenkins-plugin-program för Azure.

Den här artikeln illustrerar hur du använder Blob Storage som en lagringsplats för byggartefakter som skapats av en Lösning för kontinuerlig integrering i Jenkins (CI), eller som en källa till nedladdningsbara filer som ska användas i en byggprocess. Ett av de scenarier där du kan hitta den här lösningen är när du kodar i en flexibel utvecklingsmiljö (med Java eller andra språk), byggen körs baserat på kontinuerlig integrering och du behöver en lagringsplats för dina byggartefakter, så att du till exempel kan dela dem med andra organisationsmedlemmar, dina kunder eller underhålla ett arkiv. Ett annat scenario är när själva byggjobbet kräver andra filer, till exempel beroenden som ska laddas ned som en del av byggindata.

Förutsättningar

Lägg till Azure-autentiseringsuppgifter som krävs för att köra Azure CLI

  1. Bläddra till Jenkins-portalen.

  2. Välj Hantera Jenkins på menyn.

  3. Välj Hantera autentiseringsuppgifter.

  4. Välj den globala domänen.

  5. Välj Lägg till autentiseringsuppgifter.

  6. Fyll i de obligatoriska fälten på följande sätt:

    • Typ:Välj Användarnamn med lösenord.
    • Användarnamn:Ange för tjänstens huvudnamn.
    • Lösenord:Ange för tjänstens huvudnamn.
    • ID:Ange en autentiseringsidentifierare, till exempel .
    • Beskrivning:Om du vill kan du ange en beskrivande beskrivning för din miljö.

  7. Välj OK för att skapa autentiseringssuppgifter.

Skapa ett pipelinejobb för att ladda upp byggartefakter

Följande steg vägleder dig genom skapandet av ett pipelinejobb. Pipelinejobbet skapar flera filer och laddar upp filerna till ditt lagringskonto med hjälp av Azure CLI.

  1. Välj Nytt objekt på Jenkins-instrumentpanelen.

  2. Ge jobbet namnet myjob,välj Pipelineoch välj sedan OK.

  3. I avsnittet Pipeline i jobbkonfigurationen väljer du Pipeline-skript och klistrar in följande i Skript. Redigera platshållarna så att de matchar värdena för din miljö.

    pipeline {
  agent any
  environment {
    AZURE_SUBSCRIPTION_ID='99999999-9999-9999-9999-999999999999'
    AZURE_TENANT_ID='99999999-9999-9999-9999-999999999999'
    AZURE_STORAGE_ACCOUNT='myStorageAccount'
  }
  stages {
    stage('Build') {
      steps {
        sh 'rm -rf *'
        sh 'mkdir text'
        sh 'echo Hello Azure Storage from Jenkins > ./text/hello.txt'
        sh 'date > ./text/date.txt'
      }

      post {
        success {
          withCredentials([usernamePassword(credentialsId: 'azuresp', 
                          passwordVariable: 'AZURE_CLIENT_SECRET', 
                          usernameVariable: 'AZURE_CLIENT_ID')]) {
            sh '''
              echo $container_name
              # Login to Azure with ServicePrincipal
              az login --service-principal -u $AZURE_CLIENT_ID -p $AZURE_CLIENT_SECRET -t $AZURE_TENANT_ID
              # Set default subscription
              az account set --subscription $AZURE_SUBSCRIPTION_ID
              # Execute upload to Azure
              az storage container create --account-name $AZURE_STORAGE_ACCOUNT --name $JOB_NAME --auth-mode login
              az storage blob upload-batch --destination ${JOB_NAME} --source ./text --account-name $AZURE_STORAGE_ACCOUNT
              # Logout from Azure
              az logout
            '''
          }
        }
      }
    }
  }
}

  4. Välj Skapa nu för att köra myjob.

  5. Granska konsolens utdata för status. När åtgärden efter bygget laddar upp byggartefakter skrivs statusmeddelanden för Azure Storage till konsolen.

  6. Om du stöter på ett fel som liknar följande innebär det att du måste bevilja åtkomst på containernivå: Om du får det här felmeddelandet kan du läsa följande artiklar för ValidationError: You do not have the required permissions needed to perform this operation. att lösa problemet:

  7. När jobbet har slutförts undersöker du byggartefakter genom att öppna den offentliga bloben:

    1. Logga in på Azure-portalen.
    2. Välj Storage.
    3. Välj det lagringskontonamn som du använde för Jenkins.
    4. Välj Containrar.
    5. Välj containern med namnet myjobi listan över blobar.
    6. Du bör se följande två filer: hello.txt och date.txt.
    7. Kopiera URL:en för något av dessa objekt och klistra in den i webbläsaren.
    8. Du ser textfilen som laddades upp som en byggartefakt.

    Viktiga punkter:

    • Containernamn och blobnamn är gemener (och fallkänsliga) i Azure Storage.

Skapa ett pipelinejobb att ladda ned från Azure Blob Storage

Följande steg visar hur du konfigurerar ett pipelinejobb för att ladda ned objekt från Azure Blob Storage.

  1. I avsnittet Pipeline i jobbkonfigurationen väljer du Pipeline-skript och klistrar in följande i Skript. Redigera platshållarna så att de matchar värdena för din miljö.

    pipeline {
  agent any
  environment {
    AZURE_SUBSCRIPTION_ID='99999999-9999-9999-9999-999999999999'
    AZURE_TENANT_ID='99999999-9999-9999-9999-999999999999'
    AZURE_STORAGE_ACCOUNT='myStorageAccount'
  }
  stages {
    stage('Build') {
      steps {
        withCredentials([usernamePassword(credentialsId: 'azuresp', 
                        passwordVariable: 'AZURE_CLIENT_SECRET', 
                        usernameVariable: 'AZURE_CLIENT_ID')]) {
          sh '''
            # Login to Azure with ServicePrincipal
            az login --service-principal -u $AZURE_CLIENT_ID -p $AZURE_CLIENT_SECRET -t $AZURE_TENANT_ID
            # Set default subscription
            az account set --subscription $AZURE_SUBSCRIPTION_ID
            # Execute upload to Azure
            az storage blob download --account-name $AZURE_STORAGE_ACCOUNT --container-name myjob --name hello.txt --file ${WORKSPACE}/hello.txt --auth-mode login
            # Logout from Azure
            az logout
          '''   
        }
      }
    }
  }
}

  2. När du har kört en version kontrollerar du konsolens utdata för bygghistorik. Du kan också titta på nedladdningsplatsen för att se om de blobar som du förväntade dig har laddats ned.

Nästa steg

Jenkins på Azure