ci: remove legacy alpine packaging path

Author: hongjr03

.github/scripts/ci-plan.mjs

@@ -12,17 +12,6 @@ const DEV_PACKAGE_TARGETS = new Map([
   ["darwin-arm64", { os: "macos-15", target: "darwin-arm64" }],
 ]);
 
-const DEV_ALPINE_TARGETS = new Map([
-  [
-    "alpine-x64",
-    {
-      target: "alpine-x64",
-      image: "ghcr.io/blackdex/rust-musl:x86_64-musl-nightly",
-      "rust-target": "x86_64-unknown-linux-musl",
-    },
-  ],
-]);
-
 export async function planCi({ github, context, core, filters }) {
   const eventName = context.eventName;
   const workflowDispatch = eventName === "workflow_dispatch";
@@ -56,37 +45,25 @@ export async function planCi({ github, context, core, filters }) {
 
   let runDevPackage = false;
   let runDevWebPackage = false;
-  let runDevAlpinePackage = false;
   let devPackageMatrix = [DEV_PACKAGE_TARGETS.get("linux-x64")];
-  let devAlpineMatrix = [DEV_ALPINE_TARGETS.get("alpine-x64")];
 
   if (!pullRequest) {
     if (workflowDispatch || packageChanged) {
       runDevPackage = true;
       runDevWebPackage = true;
-      runDevAlpinePackage = true;
       devPackageMatrix = [...DEV_PACKAGE_TARGETS.values()];
-      devAlpineMatrix = [...DEV_ALPINE_TARGETS.values()];
     } else {
       const failedDevPackageTargets = failedTargets(
         failedJobNames,
         DEV_PACKAGE_TARGETS,
       );
-      const failedDevAlpineTargets = failedTargets(
-        failedJobNames,
-        DEV_ALPINE_TARGETS,
-      );
 
       runDevPackage = failedDevPackageTargets.length > 0;
       runDevWebPackage = failedJobNames.includes("Dev Package (web)");
-      runDevAlpinePackage = failedDevAlpineTargets.length > 0;
 
       if (runDevPackage) {
         devPackageMatrix = failedDevPackageTargets;
       }
-      if (runDevAlpinePackage) {
-        devAlpineMatrix = failedDevAlpineTargets;
-      }
     }
   }
 
@@ -109,8 +86,6 @@ export async function planCi({ github, context, core, filters }) {
     run_dev_package: runDevPackage,
     dev_package_matrix: devPackageMatrix,
     run_dev_web_package: runDevWebPackage,
-    run_dev_alpine_package: runDevAlpinePackage,
-    dev_alpine_matrix: devAlpineMatrix,
   };
 }
 

.github/workflows/ci.yml

@@ -400,118 +400,3 @@ jobs:
           if-no-files-found: error
           retention-days: 14
 
-  dev-alpine-package:
-    name: Dev Package (${{ matrix.target }})
-    needs: changes
-    if: fromJSON(needs.changes.outputs.plan).run_dev_alpine_package == true
-    runs-on: ubuntu-22.04
-    container: ${{ matrix.image }}
-    strategy:
-      fail-fast: false
-      matrix:
-        include: ${{ fromJSON(needs.changes.outputs.plan).dev_alpine_matrix }}
-    defaults:
-      run:
-        working-directory: editors/vscode
-    env:
-      SERVER_BIN: ${{ startsWith(matrix.target, 'win32-') && 'vide.exe' || 'vide' }}
-    steps:
-      - name: Install build dependencies
-        working-directory: .
-        run: |
-          apt-get update
-          apt-get install -y --no-install-recommends ca-certificates cmake git python3
-
-      - uses: actions/checkout@v4
-
-      - name: Trust checkout directories
-        working-directory: .
-        run: |
-          git config --global --add safe.directory "$GITHUB_WORKSPACE"
-
-      - name: Restore bundled server cache
-        id: bundled-server-cache
-        uses: actions/cache/restore@v4
-        with:
-          path: editors/vscode/server/${{ matrix.target }}/${{ env.SERVER_BIN }}
-          key: bundled-server-${{ matrix.target }}-${{ hashFiles('Cargo.toml', 'Cargo.lock', 'build.rs', 'rust-toolchain.toml', 'src/**', 'crates/**', 'xtask/**') }}
-
-      - name: Install Rust
-        uses: ./.github/actions/setup-rust
-        with:
-          components: rustfmt
-          targets: ${{ matrix.rust-target }}
-
-      - name: Setup sccache
-        uses: ./.github/actions/setup-sccache
-        with:
-          cmake-launcher: "true"
-
-      - name: Rust Cache
-        uses: Swatinem/rust-cache@v2
-        continue-on-error: true
-        with:
-          shared-key: rust-${{ runner.os }}-${{ matrix.target }}
-          key: package-${{ hashFiles('Cargo.toml', 'Cargo.lock', 'build.rs', 'rust-toolchain.toml', 'src/**', 'crates/**', 'xtask/**') }}
-          cache-workspace-crates: true
-          cache-on-failure: true
-
-      - name: Setup Node
-        uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          cache: npm
-          cache-dependency-path: editors/vscode/package-lock.json
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Set build metadata
-        id: build-metadata
-        shell: bash
-        working-directory: .
-        run: |
-          commit_hash="$(git rev-parse --short "$GITHUB_SHA")"
-          echo "commit_hash=${commit_hash}" >> "$GITHUB_OUTPUT"
-          echo "VIDE_EXTENSION_BUILD_KIND=nightly" >> "$GITHUB_ENV"
-          echo "VIDE_EXTENSION_COMMIT_HASH=${commit_hash}" >> "$GITHUB_ENV"
-          echo "VIDE_EXTENSION_BUILD_DATE=$(date -u +'%Y%m%dT%H%M%SZ')" >> "$GITHUB_ENV"
-
-      - name: Package extension
-        run: npm run package:vsix:debug -- --target ${{ matrix.target }} ${{ steps.bundled-server-cache.outputs.cache-hit == 'true' && '--server=prebuilt' || '--server=build' }}
-
-      - name: Save bundled server cache
-        if: steps.bundled-server-cache.outputs.cache-hit != 'true'
-        uses: actions/cache/save@v4
-        continue-on-error: true
-        with:
-          path: editors/vscode/server/${{ matrix.target }}/${{ env.SERVER_BIN }}
-          key: ${{ steps.bundled-server-cache.outputs.cache-primary-key }}
-
-      - name: Upload dev VSIX
-        uses: actions/upload-artifact@v4
-        with:
-          name: vide-vscode-dev-${{ matrix.target }}-${{ steps.build-metadata.outputs.commit_hash }}
-          path: editors/vscode/vide-vscode-${{ matrix.target }}-debug.vsix
-          if-no-files-found: error
-          retention-days: 14
-      - name: Upload dev language server binary
-        shell: bash
-        working-directory: .
-        run: |
-          set -euo pipefail
-          server_dir="editors/vscode/server/${{ matrix.target }}"
-          src="${server_dir}/vide"
-          dst="vide-${{ matrix.target }}"
-          if [[ ! -f "$src" ]]; then
-            echo "Language server binary not found: $src" >&2
-            exit 1
-          fi
-          cp "$src" "$dst"
-      - name: Upload dev language server binary artifact
-        uses: actions/upload-artifact@v4
-        with:
-          name: vide-lsp-dev-${{ matrix.target }}-${{ steps.build-metadata.outputs.commit_hash }}
-          path: vide-${{ matrix.target }}
-          if-no-files-found: error
-          retention-days: 14

docs/src/content/docs/advanced-guide/advanced-installation.md

@@ -105,16 +105,17 @@ npm run package:vsix -- --target linux-x64
 npm run package:vsix -- --target linux-arm64
 npm run package:vsix -- --target win32-x64
 npm run package:vsix -- --target darwin-arm64
-npm run package:vsix -- --target alpine-x64
+npm run package:vsix -- --target alpine-x64 --server=prebuilt
+npm run package:vsix -- --target alpine-arm64 --server=prebuilt
 ```
 
-这些脚本会先编译扩展，然后准备目标平台的 release 版语言服务器，再生成 `vide-vscode-<target>.vsix`。release 包默认不启用 profile trace，也不包含 Speedscope 静态资源或 profiling 命令。当前 release workflow 只覆盖上面这些目标：glibc Linux、Windows x64、macOS arm64，以及 Alpine/musl x64。
+这些脚本会先编译扩展，然后准备目标平台的 release 版语言服务器，再生成 `vide-vscode-<target>.vsix`。release 包默认不启用 profile trace，也不包含 Speedscope 静态资源或 profiling 命令。当前 release workflow 只覆盖上面这些目标：glibc Linux、Windows x64、macOS arm64，以及 Alpine/musl x64/arm64。
 这几项也是当前 CI 会实际构建的 VSIX 目标。其他平台不是当前支持的打包目标。
 
 上面的打包命令都需要先准备目标平台的语言服务器二进制；`editors/vscode/scripts/package.ts` 会调用 `cargo xtask vscode prepare-server`，而通用的 server 构建规则由 `cargo xtask server build` 承载：
 
 - 目标等于当前宿主平台时，xtask 执行对应 profile 的 `cargo build` 并复制产物。
-- Alpine 目标在 CI 的 musl 容器中构建；本地脚本会添加对应 Rust musl target，但仍需要可用的 musl 交叉编译环境。
+- Alpine 目标由 release artifact workflow 预先构建 musl 语言服务器；本地打包 Alpine VSIX 时需要先把对应的 `vide` 放到 `editors/vscode/server/<target>/`，并使用 `--server=prebuilt`。
 - 其他非宿主平台目标不会自动交叉编译语言服务器，需要 `editors/vscode/server/<target>/` 下已经存在对应的 `vide` 或 `vide.exe`，或者在匹配的原生 runner 上打包。
 
 ### 安装 VS Code 插件
@@ -158,6 +159,7 @@ code --install-extension ./vide-vscode-win32-x64-debug.vsix
 VSIX 是按平台打包的。当前正式发布和 CI 产物覆盖这些目标：
 
 - `alpine-x64`
+- `alpine-arm64`
 - `darwin-arm64`
 - `linux-arm64`
 - `linux-x64`

docs/src/content/docs/en/advanced-guide/advanced-installation.md

@@ -119,16 +119,17 @@ npm run package:vsix -- --target linux-x64
 npm run package:vsix -- --target linux-arm64
 npm run package:vsix -- --target win32-x64
 npm run package:vsix -- --target darwin-arm64
-npm run package:vsix -- --target alpine-x64
+npm run package:vsix -- --target alpine-x64 --server=prebuilt
+npm run package:vsix -- --target alpine-arm64 --server=prebuilt
 ```
 
-These scripts compile the extension, prepare a release server binary for the target platform, and generate `vide-vscode-<target>.vsix`. Release packages do not enable profile trace, and they do not include Speedscope static assets or the profiling command by default. The current release workflow only covers those targets: glibc Linux, Windows x64, macOS arm64, and Alpine/musl x64.
+These scripts compile the extension, prepare a release server binary for the target platform, and generate `vide-vscode-<target>.vsix`. Release packages do not enable profile trace, and they do not include Speedscope static assets or the profiling command by default. The current release workflow only covers those targets: glibc Linux, Windows x64, macOS arm64, and Alpine/musl x64/arm64.
 Those are also the VSIX targets currently built by CI. Other platforms are not current packaging targets.
 
 All packaging commands above need to prepare the language server binary for the target platform first. `editors/vscode/scripts/package.ts` calls `cargo xtask vscode prepare-server`, and the reusable server build rules live under `cargo xtask server build`:
 
 - When the target matches the current host platform, xtask runs `cargo build` for the selected profile and copies the result.
-- Alpine targets are built in musl containers in CI. The local script adds the matching Rust musl target, but still needs a working musl cross-compilation environment.
+- Alpine targets are built by the release artifact workflow as prebuilt musl language servers. To package an Alpine VSIX locally, first place the matching `vide` binary under `editors/vscode/server/<target>/`, then pass `--server=prebuilt`.
 - Other non-host targets are not automatically cross-compiled; the matching `vide` or `vide.exe` must already exist under `editors/vscode/server/<target>/`, or you should package on a matching native runner.
 
 ### Install the VS Code Extension
@@ -172,6 +173,7 @@ You can download a `.vsix` file and install it manually. Choose the source based
 VSIX packages are platform-specific. Current release and CI artifacts cover these targets:
 
 - `alpine-x64`
+- `alpine-arm64`
 - `darwin-arm64`
 - `linux-arm64`
 - `linux-x64`

editors/vscode/scripts/package/server.ts

@@ -5,11 +5,6 @@ import type { PackageContext } from './context';
 import { run } from './process';
 import type { BuildProfile, NativeTargetSpec, ServerMode } from './targets';
 
-const ALPINE_CARGO_TARGETS: Partial<Record<NativeTargetSpec['target'], string>> = {
-  'alpine-arm64': 'aarch64-unknown-linux-musl',
-  'alpine-x64': 'x86_64-unknown-linux-musl',
-};
-
 export function ensureTargetServerBinary(
   context: PackageContext,
   spec: NativeTargetSpec,
@@ -33,7 +28,7 @@ export function ensureTargetServerBinary(
   }
 
   const serverPath = targetServerPath(context, spec);
-  run('cargo', args, context.repoRoot, cargoXtaskEnvForTarget(spec));
+  run('cargo', args, context.repoRoot);
 
   if (!fs.existsSync(serverPath)) {
     throw new Error(`prepared server binary was not found: ${serverPath}`);
@@ -69,64 +64,4 @@ function targetServerPath(context: PackageContext, spec: NativeTargetSpec): stri
   return path.join(context.vscodeDir, 'server', spec.target, spec.binaryFile);
 }
 
-export function cargoXtaskEnvForTarget(
-  spec: NativeTargetSpec,
-  env: NodeJS.ProcessEnv = process.env,
-): NodeJS.ProcessEnv {
-  const cargoTarget = ALPINE_CARGO_TARGETS[spec.target];
-  if (!cargoTarget) {
-    return env;
-  }
-
-  let updated = env;
-  const linkerEnvKey = cargoTargetLinkerEnvKey(cargoTarget);
-  if (!optionalEnv(updated, linkerEnvKey)) {
-    updated = {
-      ...updated,
-      [linkerEnvKey]: cargoLinkerForTarget(cargoTarget, updated),
-    };
-  }
-
-  return appendRustFlags(updated, ['-C', 'link-arg=-lc']);
-}
-
-function cargoTargetLinkerEnvKey(cargoTarget: string): string {
-  return `CARGO_TARGET_${cargoTargetEnvName(cargoTarget)}_LINKER`;
-}
-
-function cargoTargetEnvName(cargoTarget: string): string {
-  return cargoTarget.toUpperCase().replace(/-/g, '_');
-}
-
-function cargoLinkerForTarget(cargoTarget: string, env: NodeJS.ProcessEnv): string {
-  return (
-    optionalEnv(env, cxxCompilerEnvKey(cargoTarget)) ??
-    optionalEnv(env, 'TARGET_CXX') ??
-    `${cargoTarget}-g++`
-  );
-}
-
-function cxxCompilerEnvKey(cargoTarget: string): string {
-  return `CXX_${cargoTarget.replace(/-/g, '_')}`;
-}
 
-function appendRustFlags(env: NodeJS.ProcessEnv, flags: string[]): NodeJS.ProcessEnv {
-  const encodedFlags = optionalEnv(env, 'CARGO_ENCODED_RUSTFLAGS');
-  if (encodedFlags) {
-    return {
-      ...env,
-      CARGO_ENCODED_RUSTFLAGS: `${encodedFlags}\x1f${flags.join('\x1f')}`,
-    };
-  }
-
-  const rustFlags = optionalEnv(env, 'RUSTFLAGS');
-  return {
-    ...env,
-    RUSTFLAGS: rustFlags ? `${rustFlags} ${flags.join(' ')}` : flags.join(' '),
-  };
-}
-
-function optionalEnv(env: NodeJS.ProcessEnv, name: string): string | undefined {
-  const value = env[name]?.trim();
-  return value ? value : undefined;
-}

editors/vscode/test/package.test.ts

@@ -11,7 +11,6 @@ import {
   stagePackageJsonForTarget,
   stageProfileTraceAssets,
 } from '../scripts/package/manifest';
-import { cargoXtaskEnvForTarget } from '../scripts/package/server';
 import { createPackagePlan, type NativeTargetSpec } from '../scripts/package/targets';
 
 describe('package cli', () => {
@@ -106,40 +105,6 @@ describe('package staging', () => {
   });
 });
 
-describe('package server preparation', () => {
-  it('injects Alpine cargo env before cargo xtask is built', () => {
-    const env = cargoXtaskEnvForTarget(nativeTargetSpec('alpine-x64'), {});
-
-    assert.equal(
-      env.CARGO_TARGET_X86_64_UNKNOWN_LINUX_MUSL_LINKER,
-      'x86_64-unknown-linux-musl-g++',
-    );
-    assert.equal(env.RUSTFLAGS, '-C link-arg=-lc');
-  });
-
-  it('appends Alpine cargo flags to encoded rust flags', () => {
-    const env = cargoXtaskEnvForTarget(nativeTargetSpec('alpine-x64'), {
-      CARGO_ENCODED_RUSTFLAGS: '-C\x1ftarget-feature=+crt-static',
-      CXX_x86_64_unknown_linux_musl: 'custom-x86_64-g++',
-    });
-
-    assert.equal(env.CARGO_TARGET_X86_64_UNKNOWN_LINUX_MUSL_LINKER, 'custom-x86_64-g++');
-    assert.equal(
-      env.CARGO_ENCODED_RUSTFLAGS,
-      '-C\x1ftarget-feature=+crt-static\x1f-C\x1flink-arg=-lc',
-    );
-  });
-
-  it('leaves non-Alpine cargo env untouched', () => {
-    const baseEnv = { RUSTFLAGS: '-Dwarnings' };
-
-    assert.equal(
-      cargoXtaskEnvForTarget(nativeTargetSpec('win32-x64', 'vide.exe'), baseEnv),
-      baseEnv,
-    );
-  });
-});
-
 function temporaryPackageContext(): PackageContext {
   const root = fs.mkdtempSync(path.join(os.tmpdir(), 'vide-package-'));
   return {