name: Integration Tests # Real integration tests against a live Proxmox VE instance. # # Architecture: # build → GitHub-hosted, dotnet publish → upload artifact # container-image → GitHub-hosted, build+push Docker image to GHCR # provision → self-hosted, provisions ALL nested PVE VMs in parallel via Terraform # test → self-hosted, runs Pester tests against pre-provisioned VMs # cleanup → self-hosted, tears down all VMs (always runs) # cleanup-images → GitHub-hosted, prunes old GHCR container images # # Required repository secrets (for provisioning): # PVE_ENDPOINT - Parent PVE API URL (e.g. https://pve.example.com:8006) # PVE_API_TOKEN - Parent PVE API token (for Terraform + uploads) # PVE_TARGET_NODE - Parent PVE node name # # Optional secrets (for skip_provision mode): # PVETEST_HOST - Hostname or IP of a pre-existing nested PVE # PVETEST_APITOKEN - API token for the pre-existing nested PVE # # WARNING: Integration tests create and destroy real resources on the target # node. Never run against production. on: push: branches: [ main ] pull_request: branches: [ main ] types: [ opened, synchronize, reopened ] workflow_dispatch: inputs: skip_provision: description: 'Skip provisioning (use existing PVE from PVETEST_HOST secret)' required: false type: boolean default: false permissions: contents: read packages: write env: INFRA_DIR: tests/infrastructure SCRIPTS_DIR: tests/infrastructure/scripts PVE_PASSWORD: "Testpass123!" TEST_IMAGE: ghcr.io/goodolclint/psproxmoxve-integration CACHE_DIR: /opt/pve-isos jobs: # ── Build module artifact (GitHub-hosted) ──────────────────────────── build: if: github.actor != 'dependabot[bot]' runs-on: ubuntu-latest timeout-minutes: 10 steps: - uses: actions/checkout@v6 - name: Setup .NET uses: actions/setup-dotnet@v5 with: dotnet-version: '10.0.x' - name: Build module run: dotnet publish src/PSProxmoxVE/PSProxmoxVE.csproj --configuration Release --framework netstandard2.0 --output ./publish/netstandard2.0 - name: Clean publish output run: rm -f ./publish/netstandard2.0/*.deps.json - name: Upload module artifact uses: actions/upload-artifact@v7 with: name: module-integration path: ./publish/netstandard2.0/ # ── Build test container image (GitHub-hosted) ─────────────────────── container-image: if: github.actor != 'dependabot[bot]' runs-on: ubuntu-latest timeout-minutes: 20 steps: - uses: actions/checkout@v6 - name: Log in to GHCR uses: docker/login-action@v4 with: registry: ghcr.io username: ${{ github.actor }} password: ${{ secrets.GITHUB_TOKEN }} - name: Build and push uses: docker/build-push-action@v7 with: context: tests/infrastructure file: tests/infrastructure/Dockerfile push: true tags: ${{ env.TEST_IMAGE }}:${{ github.sha }},${{ env.TEST_IMAGE }}:latest # ── Provision all nested PVE VMs (self-hosted) ────────────────────── provision: if: inputs.skip_provision != true needs: [build, container-image] runs-on: [self-hosted, proxmox, integration] timeout-minutes: 30 container: image: ghcr.io/goodolclint/psproxmoxve-integration:${{ github.sha }} credentials: username: ${{ github.actor }} password: ${{ secrets.GITHUB_TOKEN }} volumes: - /opt/pve-isos:/opt/pve-isos outputs: pve9_host: ${{ steps.wait_pve9.outputs.host }} pve9_token: ${{ steps.wait_pve9.outputs.token }} pve8_host: ${{ steps.wait_pve8.outputs.host }} pve8_token: ${{ steps.wait_pve8.outputs.token }} cloud_image_path: ${{ steps.cloud_images.outputs.cloud_image_path }} ova_path: ${{ steps.cloud_images.outputs.ova_path }} steps: - name: Mask test password run: echo "::add-mask::${PVE_PASSWORD}" - uses: actions/checkout@v6 # ── Cache: ensure base ISOs ────────────────────────────────────── - name: Ensure PVE 9 base ISO shell: bash run: bash ${SCRIPTS_DIR}/ensure-base-iso.sh "proxmox-ve_9.1-1.iso" "${CACHE_DIR}" - name: Ensure PVE 8 base ISO shell: bash run: bash ${SCRIPTS_DIR}/ensure-base-iso.sh "proxmox-ve_8.4-1.iso" "${CACHE_DIR}" # ── Cache: ensure cloud images ─────────────────────────────────── - name: Ensure cloud images cached id: cloud_images shell: bash run: | OUTPUT=$(bash ${SCRIPTS_DIR}/ensure-cloud-images.sh "${CACHE_DIR}") CLOUD_IMAGE_PATH=$(echo "$OUTPUT" | grep "^CLOUD_IMAGE_PATH=" | cut -d= -f2) OVA_PATH=$(echo "$OUTPUT" | grep "^OVA_PATH=" | cut -d= -f2) echo "cloud_image_path=${CLOUD_IMAGE_PATH}" >> "$GITHUB_OUTPUT" echo "ova_path=${OVA_PATH}" >> "$GITHUB_OUTPUT" # ── Pre-flight cleanup for ALL VMs ─────────────────────────────── - name: Pre-flight cleanup (PVE 9) shell: bash env: PVE_API_TOKEN: ${{ secrets.PVE_API_TOKEN }} run: | bash ${SCRIPTS_DIR}/preflight-cleanup.sh \ "${{ secrets.PVE_ENDPOINT }}" "${PVE_API_TOKEN}" \ 99909 "proxmox-ve_9.1-1-auto.iso" "${INFRA_DIR}" - name: Pre-flight cleanup (PVE 8) shell: bash env: PVE_API_TOKEN: ${{ secrets.PVE_API_TOKEN }} run: | bash ${SCRIPTS_DIR}/preflight-cleanup.sh \ "${{ secrets.PVE_ENDPOINT }}" "${PVE_API_TOKEN}" \ 99908 "proxmox-ve_8.4-1-auto.iso" "${INFRA_DIR}" # ── Generate answer files ──────────────────────────────────────── - name: Generate answer file shell: bash run: | sed "s/\${root_password}/${PVE_PASSWORD}/" \ ${INFRA_DIR}/answer.toml.tftpl > ${RUNNER_TEMP}/answer.toml # ── Prepare auto-install ISOs (cached) ─────────────────────────── - name: Prepare PVE 9 auto-install ISO shell: bash run: | bash ${SCRIPTS_DIR}/prepare-auto-iso.sh \ "${CACHE_DIR}/proxmox-ve_9.1-1.iso" \ ${RUNNER_TEMP}/answer.toml \ ${SCRIPTS_DIR}/first-boot.sh \ "${RUNNER_TEMP}/proxmox-ve_9.1-1-auto.iso" \ --cache-dir "${CACHE_DIR}" - name: Prepare PVE 8 auto-install ISO shell: bash run: | bash ${SCRIPTS_DIR}/prepare-auto-iso.sh \ "${CACHE_DIR}/proxmox-ve_8.4-1.iso" \ ${RUNNER_TEMP}/answer.toml \ ${SCRIPTS_DIR}/first-boot.sh \ "${RUNNER_TEMP}/proxmox-ve_8.4-1-auto.iso" \ --cache-dir "${CACHE_DIR}" # ── Terraform: provision both VMs in parallel ──────────────────── - name: Terraform init shell: bash working-directory: ${{ env.INFRA_DIR }} run: terraform init -input=false - name: Terraform apply (both VMs) shell: bash working-directory: ${{ env.INFRA_DIR }} env: TF_VAR_proxmox_endpoint: ${{ secrets.PVE_ENDPOINT }} TF_VAR_proxmox_api_token: ${{ secrets.PVE_API_TOKEN }} TF_VAR_target_node: ${{ secrets.PVE_TARGET_NODE }} TF_VAR_test_vm_password: ${{ env.PVE_PASSWORD }} run: | cat > /tmp/instances.tfvars.json <> "$GITHUB_OUTPUT" echo "token=${VM_TOKEN}" >> "$GITHUB_OUTPUT" - name: Wait for PVE 8 and create API token id: wait_pve8 shell: bash env: PVE_API_TOKEN: ${{ secrets.PVE_API_TOKEN }} run: | OUTPUT=$(bash ${SCRIPTS_DIR}/create-api-token.sh \ "${{ secrets.PVE_ENDPOINT }}" "${PVE_API_TOKEN}" \ 99908 "${PVE_PASSWORD}" 900) VM_IP=$(echo "$OUTPUT" | grep "^IP=" | cut -d= -f2) VM_TOKEN=$(echo "$OUTPUT" | grep "^TOKEN=" | cut -d= -f2-) echo "::add-mask::${VM_TOKEN}" echo "host=${VM_IP}" >> "$GITHUB_OUTPUT" echo "token=${VM_TOKEN}" >> "$GITHUB_OUTPUT" # ── Prepare test environments on both nested PVEs ──────────────── - name: Prepare PVE 9 test environment shell: bash run: | bash ${SCRIPTS_DIR}/prepare-test-environment.sh \ "${{ steps.wait_pve9.outputs.host }}" "${PVE_PASSWORD}" - name: Prepare PVE 8 test environment shell: bash run: | bash ${SCRIPTS_DIR}/prepare-test-environment.sh \ "${{ steps.wait_pve8.outputs.host }}" "${PVE_PASSWORD}" # ── Upload Terraform state for cleanup job ─────────────────────── - name: Upload Terraform state if: always() uses: actions/upload-artifact@v7 with: name: terraform-state path: | ${{ env.INFRA_DIR }}/terraform.tfstate ${{ env.INFRA_DIR }}/.terraform/ retention-days: 1 # ── Integration tests (self-hosted, per PVE version) ──────────────── test: needs: [build, provision] runs-on: [self-hosted, proxmox, integration] timeout-minutes: 20 container: image: ghcr.io/goodolclint/psproxmoxve-integration:${{ github.sha }} credentials: username: ${{ github.actor }} password: ${{ secrets.GITHUB_TOKEN }} volumes: - /opt/pve-isos:/opt/pve-isos strategy: fail-fast: false max-parallel: 1 matrix: pve_version: ['9', '8'] steps: - name: Mask test password run: echo "::add-mask::${PVE_PASSWORD}" - uses: actions/checkout@v6 - name: Download module artifact uses: actions/download-artifact@v8 with: name: module-integration path: ./publish/netstandard2.0/ # ── Resolve test target ────────────────────────────────────────── - name: Set test target id: target shell: bash run: | if [ "${{ inputs.skip_provision }}" = "true" ]; then echo "host=${{ secrets.PVETEST_HOST }}" >> "$GITHUB_OUTPUT" echo "port=${{ secrets.PVETEST_PORT || '8006' }}" >> "$GITHUB_OUTPUT" echo "token=${{ secrets.PVETEST_APITOKEN }}" >> "$GITHUB_OUTPUT" echo "node=${{ secrets.PVETEST_NODE || 'pve' }}" >> "$GITHUB_OUTPUT" echo "storage=${{ secrets.PVETEST_STORAGE || 'local' }}" >> "$GITHUB_OUTPUT" elif [ "${{ matrix.pve_version }}" = "9" ]; then echo "host=${{ needs.provision.outputs.pve9_host }}" >> "$GITHUB_OUTPUT" echo "port=8006" >> "$GITHUB_OUTPUT" echo "token=${{ needs.provision.outputs.pve9_token }}" >> "$GITHUB_OUTPUT" echo "node=pve" >> "$GITHUB_OUTPUT" echo "storage=local" >> "$GITHUB_OUTPUT" else echo "host=${{ needs.provision.outputs.pve8_host }}" >> "$GITHUB_OUTPUT" echo "port=8006" >> "$GITHUB_OUTPUT" echo "token=${{ needs.provision.outputs.pve8_token }}" >> "$GITHUB_OUTPUT" echo "node=pve" >> "$GITHUB_OUTPUT" echo "storage=local" >> "$GITHUB_OUTPUT" fi - name: Verify PVE API reachable shell: bash run: | HOST="${{ steps.target.outputs.host }}" PORT="${{ steps.target.outputs.port }}" TOKEN="${{ steps.target.outputs.token }}" echo "Testing connectivity to PVE ${{ matrix.pve_version }} API at ${HOST}:${PORT}..." if curl -sk --connect-timeout 10 \ -H "Authorization: PVEAPIToken=${TOKEN}" \ "https://${HOST}:${PORT}/api2/json/nodes" | grep -q '"node"'; then echo "PVE API is responsive" else echo "::error::Cannot reach PVE API at ${HOST}:${PORT}" exit 1 fi # ── Install module ──────────────────────────────────────────────── - name: Copy module to module path shell: pwsh run: | $modulePath = "$HOME/.local/share/powershell/Modules/PSProxmoxVE" New-Item -ItemType Directory -Path $modulePath -Force | Out-Null Copy-Item -Path ./publish/netstandard2.0/* -Destination $modulePath -Recurse -Force # ── Run tests ───────────────────────────────────────────────────── - name: Create test ISO shell: bash run: dd if=/dev/urandom of=${RUNNER_TEMP}/pvetest.iso bs=1M count=1 2>/dev/null - name: Run integration tests shell: pwsh env: PVETEST_HOST: ${{ steps.target.outputs.host }} PVETEST_PORT: ${{ steps.target.outputs.port }} PVETEST_APITOKEN: ${{ steps.target.outputs.token }} PVETEST_NODE: ${{ steps.target.outputs.node }} PVETEST_STORAGE: ${{ steps.target.outputs.storage }} PVETEST_PVE_VERSION: ${{ matrix.pve_version }} PVETEST_PASSWORD: ${{ env.PVE_PASSWORD }} PVETEST_CLOUD_IMAGE_PATH: ${{ needs.provision.outputs.cloud_image_path }} PVETEST_OVA_PATH: ${{ needs.provision.outputs.ova_path }} run: | $env:PVETEST_ISO_PATH = Join-Path $env:RUNNER_TEMP "pvetest.iso" Import-Module Pester -MinimumVersion 5.0 $config = New-PesterConfiguration $config.Run.Path = "tests/PSProxmoxVE.Tests/Integration" $config.Filter.Tag = "Integration" $config.Output.Verbosity = "Detailed" $config.TestResult.Enabled = $true $config.TestResult.OutputFormat = "NUnitXml" $config.TestResult.OutputPath = "TestResults/integration-results.xml" Invoke-Pester -Configuration $config - name: Upload test results if: always() uses: actions/upload-artifact@v7 with: name: integration-test-results-pve${{ matrix.pve_version }} path: TestResults/ # ── Cleanup: destroy all VMs (always runs) ────────────────────────── cleanup: needs: [provision, test] if: always() && needs.provision.result != 'skipped' && github.actor != 'dependabot[bot]' runs-on: [self-hosted, proxmox, integration] timeout-minutes: 15 container: image: ghcr.io/goodolclint/psproxmoxve-integration:${{ github.sha }} credentials: username: ${{ github.actor }} password: ${{ secrets.GITHUB_TOKEN }} volumes: - /opt/pve-isos:/opt/pve-isos steps: - uses: actions/checkout@v6 - name: API-based cleanup (PVE 9) shell: bash env: PVE_API_TOKEN: ${{ secrets.PVE_API_TOKEN }} run: | bash ${SCRIPTS_DIR}/preflight-cleanup.sh \ "${{ secrets.PVE_ENDPOINT }}" "${PVE_API_TOKEN}" \ 99909 "proxmox-ve_9.1-1-auto.iso" "${INFRA_DIR}" || true - name: API-based cleanup (PVE 8) shell: bash env: PVE_API_TOKEN: ${{ secrets.PVE_API_TOKEN }} run: | bash ${SCRIPTS_DIR}/preflight-cleanup.sh \ "${{ secrets.PVE_ENDPOINT }}" "${PVE_API_TOKEN}" \ 99908 "proxmox-ve_8.4-1-auto.iso" "${INFRA_DIR}" || true # ── Clean up old container images from GHCR ────────────────────────── cleanup-images: needs: test if: always() && github.actor != 'dependabot[bot]' runs-on: ubuntu-latest timeout-minutes: 5 env: FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true steps: - name: Delete old container image versions uses: actions/delete-package-versions@v5 with: package-name: psproxmoxve-integration package-type: container min-versions-to-keep: 3 delete-only-untagged-versions: false token: ${{ secrets.GITHUB_TOKEN }}