Merge branch 'master' into 3182-instance-termination_reason

Author: jvstme

.github/workflows/build-artifacts.yml

@@ -114,9 +114,9 @@ jobs:
       - name: Check if go.mod and go.sum are up-to-date
         run: go mod tidy -diff
       - name: Run golangci-lint
-        uses: golangci/golangci-lint-action@v6
+        uses: golangci/golangci-lint-action@v9
         with:
-          version: v1.62.0  # Should match .pre-commit-config.yaml
+          version: v2.6.2  # Should match .pre-commit-config.yaml
           args: --timeout=20m
           working-directory: runner
       - name: Test
@@ -187,7 +187,7 @@ jobs:
           if [[ "${{ inputs.staging }}" == "false" ]]; then
             sed \
               -i.old \
-              "s|@ git+https://github.com/dstackai/dstack.git@master|== ${{ inputs.version }}|" \
+              "s|@ https://github.com/dstackai/dstack/archive/refs/heads/master.tar.gz|== ${{ inputs.version }}|" \
               pyproject.toml
             diff pyproject.toml pyproject.toml.old > /dev/null && echo "Could not set version" && exit 1
           fi

.github/workflows/build-docs.yml

@@ -2,10 +2,6 @@ name: Build Docs
 
 on:
   workflow_call:
-    inputs:
-      release-tag:
-        type: string
-        required: false
 
 jobs:
   build-docs:
@@ -17,18 +13,10 @@ jobs:
           python-version: 3.11
       - name: Install dstack
         run: |
-          uv pip install examples/plugins/example_plugin_server
-          if [ -n "${{ inputs.release-tag }}" ]; then
-            uv pip install "dstack[server]==${{ inputs.release-tag }}"
-          else
-            uv pip install -e '.[server]'
-          fi
+          uv sync --extra server
       - name: Build
         run: |
-          uv pip install pillow cairosvg
           sudo apt-get update && sudo apt-get install -y libcairo2-dev libfreetype6-dev libffi-dev libjpeg-dev libpng-dev libz-dev
-          uv pip install mkdocs-material "mkdocs-material[imaging]" mkdocs-material-extensions mkdocs-redirects mkdocs-gen-files "mkdocstrings[python]" mkdocs-render-swagger-plugin --upgrade
-          uv pip install git+https://${{ secrets.GH_TOKEN }}@github.com/squidfunk/mkdocs-material-insiders.git
           uv run mkdocs build -s
       - uses: actions/upload-artifact@v4
         with:

.github/workflows/docker-amd-smi.yml

@@ -15,6 +15,10 @@ on:
         description: "Docker image revision"
         required: true
         default: 0
+      tag_latest:
+        description: "Update 'latest'"
+        type: boolean
+        default: false
 
 jobs:
   build-amd-smi:
@@ -48,4 +52,7 @@ jobs:
           VERSION=$(docker inspect --format '{{ index .Config.Labels "org.opencontainers.image.version" }}' ${IMAGE_NAME})
           docker tag ${IMAGE_NAME}:latest ${IMAGE_NAME}:${VERSION}
           docker push ${IMAGE_NAME}:${VERSION}
-          docker push ${IMAGE_NAME}:latest
+      - name: Tag and push latest
+        if: ${{ inputs.tag_latest }}
+        run: |
+          docker push ${{ inputs.image_name }}:latest

.github/workflows/docker.yml

@@ -65,9 +65,15 @@ jobs:
           password: ${{ secrets.DOCKERHUB_TOKEN }}
       - name: Set up QEMU
         uses: docker/setup-qemu-action@v3
+      - name: Free up some space
+        run: |
+          df -h /
+          du -hs /usr/share/dotnet
+          rm -rf /usr/share/dotnet
+          df -h /
       - name: Build and upload to DockerHub
         run: |
-         if [ "${{ matrix.flavor }}" = "base" ]; then
+          if [ "${{ matrix.flavor }}" = "base" ]; then
             FILE="base/Dockerfile"
           elif [ "${{ matrix.flavor }}" = "devel" ]; then
             FILE="base/Dockerfile"

.github/workflows/docs.yaml

@@ -2,15 +2,10 @@ name: Build & Deploy Docs
 
 on:
   workflow_dispatch:
-    inputs:
-      release-tag:
-        description: "dstack version"
 
 jobs:
   build-docs:
     uses: ./.github/workflows/build-docs.yml
-    with:
-      release-tag: ${{ inputs.release-tag }}
     secrets: inherit
 
   deploy-docs:

.github/workflows/release.yml

@@ -100,11 +100,17 @@ jobs:
           VERSION=${{ needs.compute-version.outputs.version }}
           docker buildx build --platform linux/arm64/v8 --build-arg VERSION=$VERSION --push --provenance=false --tag dstackai/dstack:$VERSION-arm64 -f release/Dockerfile .
           docker buildx build --platform linux/amd64 --build-arg VERSION=$VERSION --push --provenance=false --tag dstackai/dstack:$VERSION-amd64 -f release/Dockerfile .
+          docker buildx build --platform linux/arm64/v8 --build-arg BASE_IMAGE=dstackai/dstack:$VERSION-arm64 --push --provenance=false --tag dstackai/dstack:nebius-$VERSION-arm64 -f Dockerfile.nebius .
+          docker buildx build --platform linux/amd64 --build-arg BASE_IMAGE=dstackai/dstack:$VERSION-amd64 --push --provenance=false --tag dstackai/dstack:nebius-$VERSION-amd64 -f Dockerfile.nebius .
           docker manifest create dstackai/dstack:$VERSION --amend dstackai/dstack:$VERSION-arm64 --amend dstackai/dstack:$VERSION-amd64
           docker manifest push dstackai/dstack:$VERSION
+          docker manifest create dstackai/dstack:nebius-$VERSION --amend dstackai/dstack:nebius-$VERSION-arm64 --amend dstackai/dstack:nebius-$VERSION-amd64
+          docker manifest push dstackai/dstack:nebius-$VERSION
           if [ -n "${{ needs.compute-version.outputs.latest }}" ]; then
             docker manifest create dstackai/dstack:latest --amend dstackai/dstack:$VERSION-arm64 --amend dstackai/dstack:$VERSION-amd64
             docker manifest push dstackai/dstack:latest
+            docker manifest create dstackai/dstack:nebius-latest --amend dstackai/dstack:nebius-$VERSION-arm64 --amend dstackai/dstack:nebius-$VERSION-amd64
+            docker manifest push dstackai/dstack:nebius-latest
           fi
       - name: Docker Hub Description
         uses: peter-evans/dockerhub-description@v4

.pre-commit-config.yaml

@@ -1,16 +1,22 @@
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.11.6  # Should match pyproject.toml
+    rev: v0.12.7  # Should match pyproject.toml
     hooks:
       - id: ruff
         name: ruff common
         args: ['--fix']
       - id: ruff-format
   - repo: https://github.com/golangci/golangci-lint
-    rev: v1.62.0  # Should match .github/workflows/build-artifacts.yml
+    rev: v2.6.2  # Should match .github/workflows/build-artifacts.yml
     hooks:
       - id: golangci-lint-full
-        language_version: 1.23.8  # Should match runner/go.mod
+        alias: runner-fix
+        language_version: 1.25.0  # Should match runner/go.mod
+        entry: bash -c 'cd runner && golangci-lint run --fix'
+        stages: [manual]
+      - id: golangci-lint-full
+        alias: runner-lint
+        language_version: 1.25.0  # Should match runner/go.mod
         entry: bash -c 'cd runner && golangci-lint run'
         stages: [manual]
   - repo: https://github.com/pre-commit/pre-commit-hooks
@@ -21,6 +27,7 @@ repos:
     hooks:
       - id: frontend-pre-commit
         name: frontend-pre-commit
-        entry: bash -c "cd frontend && npm install && npm run precommit"
+        entry: bash -c "cd frontend && npm install && npm run pre-commit"
         language: system
         pass_filenames: false
+        files: ^frontend/

AGENTS.md

@@ -0,0 +1,32 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+- Core Python package lives in `src/dstack`; internal modules (including server) sit under `_internal`, API surfaces under `api`, and plugin integrations under `plugins`.
+- Tests reside in `src/tests` and mirror package paths; add new suites alongside the code they cover.
+- Frontend lives in `frontend` (React/webpack) and is built into `src/dstack/_internal/server/statics`.
+- Docs sources are in `docs` with extra contributor notes in `contributing/*.md`; examples for users sit in `examples/`.
+
+## Build, Test, and Development Commands
+- Install deps (editable package with extras): `uv sync --all-extras` (uses `.venv` in repo).
+- Run CLI/server from source: `uv run dstack ...` (e.g., `uv run dstack server --port 8000`).
+- Lint/format: `uv run ruff check .` and `uv run ruff format .`.
+- Type check: `uv run pyright -p .`.
+- Test suite: `uv run pytest`.
+- Frontend: from `frontend/` run `npm install`, `npm run build`, then copy `frontend/build` into `src/dstack/_internal/server/statics/`; for dev, `npm run start` with API on port 8000.
+
+## Coding Style & Naming Conventions
+- Python targets 3.9+ with 4-space indentation and max line length of 99 (see `ruff.toml`; `E501` is ignored but keep lines readable).
+- Imports are sorted via Ruff’s isort settings (`dstack` treated as first-party).
+- Prefer pydantic-style models in `core/models`.
+- Tests use `test_*.py` modules and `test_*` functions; fixtures live near usage.
+
+## Testing Guidelines
+- Default to `uv run pytest`. Use markers from `tests/conftest.py` like `--runpostgres` if need to include specific tests.
+- Group tests for the same unit (function/class) using `Test*` classes that mirror unit's name.
+- Keep tests hermetic (network disabled except localhost per `pytest.ini`); stub cloud calls with mocks.
+
+## Commit & Pull Request Guidelines
+- Commit messages follow the existing style: short, imperative summaries (e.g., “Fix exclude_not_available ignored”); include rationale in the body if needed.
+- For PRs, describe behavior changes and link related issues.
+- Include screenshots or terminal output when touching UX/CLI messages or frontend flows.
+- Always disclose AI Assistance in PRs.

CONTRIBUTING.md

@@ -2,6 +2,19 @@
 
 We appreciate your interest in contributing to `dstack`! This document will help you get up to speed with `dstack` codebase and guide you through the contribution process.
 
+## AI Assistance Notice
+
+If you are using any kind of AI assistance while contributing to `dstack`,
+**this must be disclosed in the pull request**, along with the extent to
+which AI assistance was used.
+As an exception, tab-completions and trivial PRs don't need to be disclosed.
+
+An example disclosure:
+
+> This PR was written primarily by Claude Code.
+
+Failure to disclose this, makes it difficult to determine how much scrutiny to apply to the contribution. Please be respectful to maintainers and disclose AI assistance.
+
 ## Set up your development environment
 
 Follow [contributing/DEVELOPMENT.md](contributing/DEVELOPMENT.md).
@@ -22,7 +35,7 @@ If you make a non-trivial change to `dstack`, we recommend you learn about `dsta
 * Bug fixes that address a clearly defined bug. Include steps to reproduce in the linked issue or the PR.
 * New features. Before submitting a feature PR, create an issue with a proposal to discuss it with the core team and other interested parties.
 * Minor fixes such as typos.
-* [Examples](examples/README.md).
+* [Examples](examples).
 
 ### Before pushing your changes
 

README.md

@@ -52,7 +52,7 @@ Backends can be set up in `~/.dstack/server/config.yml` or through the [project
 
 For more details, see [Backends](https://dstack.ai/docs/concepts/backends).
 
-> When using `dstack` with on-prem servers, backend configuration isn’t required. Simply create [SSH fleets](https://dstack.ai/docs/concepts/fleets#ssh) once the server is up.
+> When using `dstack` with on-prem servers, backend configuration isn’t required. Simply create [SSH fleets](https://dstack.ai/docs/concepts/fleets#ssh-fleets) once the server is up.
 
 ##### Start the server