Merge branch 'main' into sanity-check-shims

Author: chriskrycho

.github/workflows/api-docs.yml

@@ -11,7 +11,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Check out code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           persist-credentials: false
       - name: Set up cargo

.github/workflows/release.yml

@@ -14,7 +14,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Check out code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Set up docker buildx
         uses: docker/setup-buildx-action@v2
       - name: Build docker image
@@ -29,25 +29,46 @@ jobs:
       - name: Compile and package Volta
         run: docker run --volume ${PWD}:/root/workspace --workdir /root/workspace --rm --init --tty volta /root/workspace/ci/build-linux.sh volta-linux
       - name: Upload release artifact
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: linux
           path: target/release/volta-linux.tar.gz
 
+  linux-arm:
+    name: Build - Linux ARM
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v4
+      - name: Install cross-rs
+        uses: taiki-e/install-action@v2
+        with:
+          tool: cross
+      - name: Compile Volta
+        run: cross build --release --target aarch64-unknown-linux-gnu
+      - name: Package Volta
+        run: |
+          cd target/aarch64-unknown-linux-gnu/release && tar -zcvf "volta-linux-arm.tar.gz" volta volta-shim volta-migrate
+      - name: Upload release artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: linux-arm
+          path: target/aarch64-unknown-linux-gnu/release/volta-linux-arm.tar.gz
+
   macos:
     name: Build - MacOS
     runs-on: macos-latest
     steps:
       - name: Check out code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Set up cargo
         uses: actions-rust-lang/setup-rust-toolchain@v1
         with:
           target: aarch64-apple-darwin,x86_64-apple-darwin
       - name: Compile and package Volta
         run: ./ci/build-macos.sh volta-macos
       - name: Upload release artifact
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: macos
           path: target/universal-apple-darwin/release/volta-macos.tar.gz
@@ -57,7 +78,7 @@ jobs:
     runs-on: windows-latest
     steps:
       - name: Check out code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Set up cargo
         uses: actions-rust-lang/setup-rust-toolchain@v1
       - name: Add cargo-wix subcommand
@@ -69,12 +90,12 @@ jobs:
         run: powershell Compress-Archive volta*.exe volta-windows.zip
         working-directory: ./target/release
       - name: Upload installer
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: windows-installer
           path: target/wix/volta-windows.msi
       - name: Upload zip
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: windows-zip
           path: target/release/volta-windows.zip
@@ -89,7 +110,7 @@ jobs:
     if: github.event_name == 'push'
     steps:
       - name: Check out code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Determine release version
         id: release_info
         env:
@@ -100,6 +121,11 @@ jobs:
         with:
           name: linux
           path: release
+      - name: Fetch Linux ARM artifact
+        uses: actions/download-artifact@v2
+        with:
+          name: linux-arm
+          path: release
       - name: Fetch MacOS artifact
         uses: actions/download-artifact@v2
         with:
@@ -135,6 +161,15 @@ jobs:
           asset_path: ./release/volta-linux.tar.gz
           asset_name: volta-${{ steps.release_info.outputs.version }}-linux.tar.gz
           asset_content_type: application/gzip
+      - name: Upload Linux ARM artifact
+        uses: actions/upload-release-asset@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          upload_url: ${{ steps.create_release.outputs.upload_url }}
+          asset_path: ./release/volta-linux-arm.tar.gz
+          asset_name: volta-${{ steps.release_info.outputs.version }}-linux-arm.tar.gz
+          asset_content_type: application/gzip
       - name: Upload MacOS artifact
         uses: actions/upload-release-asset@v1
         env:

.github/workflows/test.yml

@@ -22,7 +22,7 @@ jobs:
       RUST_BACKTRACE: full
     steps:
       - name: Check out code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Set up cargo
         uses: actions-rust-lang/setup-rust-toolchain@v1
       - name: Run tests
@@ -41,7 +41,7 @@ jobs:
       RUST_BACKTRACE: full
     steps:
       - name: Check out code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Set up cargo
         uses: actions-rust-lang/setup-rust-toolchain@v1
       - name: Run tests
@@ -55,7 +55,7 @@ jobs:
       - name: Setup BATS
         run: sudo npm install -g bats
       - name: Check out code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Run tests
         run: bats dev/unix/tests/
 
@@ -64,7 +64,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Check out code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Set up cargo
         uses: actions-rust-lang/setup-rust-toolchain@v1
       - name: Run check

COMPATIBILITY.md

@@ -0,0 +1,17 @@
+# Compatibility
+
+Volta currently tests against the following platforms, and will treat it as a breaking change to drop support for them:
+
+- macOS
+    - x86-64
+    - Apple Silicon
+- Linux x86-64
+- Windows x86-64
+
+We compile release artifacts compatible with the following, and likewise will treat it as a breaking change to drop support for them:
+
+- macOS v11
+- RHEL and CentOS v6
+- Windows 10
+
+In general, Volta should build and run against any other modern hardware and operating system supported by stable Rust, and we will make a best effort not to break them. However, we do *not* include them in our SemVer guarantees or test against them.