diff --git a/.github/workflows/check.yml b/.github/workflows/check.yml index 04798c0c..7e282d2a 100644 --- a/.github/workflows/check.yml +++ b/.github/workflows/check.yml @@ -33,12 +33,12 @@ jobs: matrix: os: [ubuntu-24.04, windows-2022] steps: - - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 with: persist-credentials: false - - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 with: - node-version: '24' + node-version-file: .nvmrc cache: npm - run: npm ci --ignore-scripts - name: Cache verified native dependency archives @@ -63,19 +63,19 @@ jobs: matrix: os: [ubuntu-22.04, ubuntu-24.04, windows-2022, windows-2025] steps: - - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6 + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7 with: persist-credentials: false - - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 # v6 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7 with: - node-version: '24' + node-version-file: .nvmrc cache: npm - run: npm ci --ignore-scripts - run: npm run gate -- quick module-data-scan - name: Publish gate report to logs and job summary if: ${{ always() }} run: node scripts/ci-report.mjs - - uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6 + - uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7 if: ${{ always() && vars.ARKVORY_UPLOAD_ARTIFACTS == 'true' }} with: name: quality-${{ matrix.os }} @@ -92,12 +92,12 @@ jobs: matrix: os: [ubuntu-22.04, ubuntu-24.04, windows-2022, windows-2025] steps: - - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 with: persist-credentials: false - - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 with: - node-version: '24' + node-version-file: .nvmrc cache: npm - run: npm ci --ignore-scripts - run: npm run gate -- deployment @@ -114,12 +114,12 @@ jobs: matrix: os: [ubuntu-22.04, ubuntu-24.04, windows-2022, windows-2025] steps: - - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 with: persist-credentials: false - - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 with: - node-version: '24' + node-version-file: .nvmrc cache: npm - run: npm ci --ignore-scripts - run: npm run gate -- deployment-services @@ -133,7 +133,7 @@ jobs: timeout-minutes: 20 services: postgres: - image: postgres:18.4 + image: postgres:18.7 env: POSTGRES_USER: arkvory_test POSTGRES_PASSWORD: arkvory_test @@ -146,12 +146,12 @@ jobs: env: ARKVORY_TEST_DATABASE_URL: postgresql://arkvory_test:arkvory_test@127.0.0.1:5432/arkvory_test steps: - - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6 + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7 with: persist-credentials: false - - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 # v6 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7 with: - node-version: '24' + node-version-file: .nvmrc cache: npm - run: npm ci --ignore-scripts - run: npm run gate -- module-data-recovery @@ -159,7 +159,7 @@ jobs: - name: Publish gate report to logs and job summary if: ${{ always() }} run: node scripts/ci-report.mjs - - uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6 + - uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7 if: ${{ always() && vars.ARKVORY_UPLOAD_ARTIFACTS == 'true' }} with: name: integration @@ -173,7 +173,7 @@ jobs: timeout-minutes: 20 services: postgres: - image: postgres:18.4 + image: postgres:18.7 env: POSTGRES_USER: arkvory_test POSTGRES_PASSWORD: arkvory_test @@ -186,12 +186,12 @@ jobs: env: ARKVORY_TEST_DATABASE_URL: postgresql://arkvory_test:arkvory_test@127.0.0.1:5432/arkvory_test steps: - - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6 + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7 with: persist-credentials: false - - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 # v6 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7 with: - node-version: '24' + node-version-file: .nvmrc cache: npm - run: npm ci --ignore-scripts - run: npm run test:browser:install @@ -199,7 +199,7 @@ jobs: - name: Publish gate report to logs and job summary if: ${{ always() }} run: node scripts/ci-report.mjs - - uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6 + - uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7 if: ${{ always() && vars.ARKVORY_UPLOAD_ARTIFACTS == 'true' }} with: name: browser @@ -219,7 +219,7 @@ jobs: gate: [large-full, large-multipart] services: postgres: - image: postgres:18.4 + image: postgres:18.7 env: POSTGRES_USER: arkvory_test POSTGRES_PASSWORD: arkvory_test @@ -232,19 +232,19 @@ jobs: env: ARKVORY_TEST_DATABASE_URL: postgresql://arkvory_test:arkvory_test@127.0.0.1:5432/arkvory_test steps: - - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6 + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7 with: persist-credentials: false - - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 # v6 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7 with: - node-version: '24' + node-version-file: .nvmrc cache: npm - run: npm ci --ignore-scripts - run: npm run gate -- ${{ matrix.gate }} - name: Publish gate report to logs and job summary if: ${{ always() }} run: node scripts/ci-report.mjs - - uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6 + - uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7 if: ${{ always() && vars.ARKVORY_UPLOAD_ARTIFACTS == 'true' }} with: name: ${{ matrix.gate }} @@ -257,19 +257,19 @@ jobs: runs-on: ubuntu-24.04 timeout-minutes: 5 steps: - - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6 + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7 with: persist-credentials: false - - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 # v6 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7 with: - node-version: '24' + node-version-file: .nvmrc cache: npm - run: npm ci --ignore-scripts - run: npm run gate -- security - name: Publish gate report to logs and job summary if: ${{ always() }} run: node scripts/ci-report.mjs - - uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6 + - uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7 if: ${{ always() && vars.ARKVORY_UPLOAD_ARTIFACTS == 'true' }} with: name: security @@ -282,19 +282,19 @@ jobs: runs-on: ubuntu-24.04 timeout-minutes: 20 steps: - - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6 + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7 with: persist-credentials: false - - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 # v6 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7 with: - node-version: '24' + node-version-file: .nvmrc cache: npm - run: npm ci --ignore-scripts - run: npm run gate -- docs - name: Publish gate report to logs and job summary if: ${{ always() }} run: node scripts/ci-report.mjs - - uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6 + - uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7 if: ${{ always() && vars.ARKVORY_UPLOAD_ARTIFACTS == 'true' }} with: name: docs @@ -307,12 +307,12 @@ jobs: runs-on: ubuntu-24.04 timeout-minutes: 25 steps: - - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 with: persist-credentials: false - - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 with: - node-version: '24' + node-version-file: .nvmrc cache: npm - run: npm ci --ignore-scripts - run: npm run gate -- deployment-containers @@ -325,12 +325,12 @@ jobs: runs-on: ubuntu-24.04 timeout-minutes: 45 steps: - - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 with: persist-credentials: false - - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 with: - node-version: '24' + node-version-file: .nvmrc cache: npm - run: npm ci --ignore-scripts - name: Cache verified native dependency archives @@ -351,12 +351,12 @@ jobs: runs-on: ubuntu-24.04 timeout-minutes: 30 steps: - - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 with: persist-credentials: false - - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 with: - node-version: '24' + node-version-file: .nvmrc cache: npm - run: npm ci --ignore-scripts - name: Cache verified native dependency archives @@ -379,12 +379,12 @@ jobs: runs-on: ubuntu-24.04 timeout-minutes: 40 steps: - - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 with: persist-credentials: false - - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 with: - node-version: '24' + node-version-file: .nvmrc cache: npm # The runner is disposable: the stand needs a hypervisor, libvirt and SSH for fence_virsh. - run: | @@ -406,12 +406,12 @@ jobs: runs-on: ubuntu-24.04 timeout-minutes: 45 steps: - - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 with: persist-credentials: false - - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 with: - node-version: '24' + node-version-file: .nvmrc cache: npm - run: npm ci --ignore-scripts - name: Cache verified native dependency archives @@ -446,12 +446,12 @@ jobs: runs-on: ubuntu-24.04 timeout-minutes: 45 steps: - - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 with: persist-credentials: false - - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 with: - node-version: '24' + node-version-file: .nvmrc cache: npm - run: npm ci --ignore-scripts - name: Cache verified native dependency archives @@ -486,12 +486,12 @@ jobs: runs-on: ubuntu-24.04 timeout-minutes: 45 steps: - - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 with: persist-credentials: false - - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 with: - node-version: '24' + node-version-file: .nvmrc cache: npm - run: npm ci --ignore-scripts - name: Cache verified native dependency archives @@ -526,12 +526,12 @@ jobs: runs-on: ubuntu-24.04 timeout-minutes: 45 steps: - - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 with: persist-credentials: false - - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 with: - node-version: '24' + node-version-file: .nvmrc cache: npm - run: npm ci --ignore-scripts - name: Cache verified native dependency archives @@ -586,12 +586,12 @@ jobs: runs-on: ubuntu-24.04 timeout-minutes: 2 steps: - - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6 + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7 with: persist-credentials: false - - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 # v6 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7 with: - node-version: '24' + node-version-file: .nvmrc - name: Require every applicable gate to pass env: ARKVORY_CI_NEEDS: ${{ toJSON(needs) }} diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml index e49eb4b1..d3b4cd8b 100644 --- a/.github/workflows/pages.yml +++ b/.github/workflows/pages.yml @@ -24,12 +24,12 @@ jobs: runs-on: ubuntu-24.04 timeout-minutes: 20 steps: - - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6 + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7 with: persist-credentials: false - - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 # v6 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7 with: - node-version: '24' + node-version-file: .nvmrc cache: npm - run: npm ci --ignore-scripts - run: npm run gate -- docs diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index d4b18d7f..9baa7cb6 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -23,12 +23,12 @@ jobs: contents: read actions: read steps: - - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 with: persist-credentials: false - - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 with: - node-version: '24' + node-version-file: .nvmrc - name: Require the complete merge gate for this exact commit env: GH_TOKEN: ${{ github.token }} @@ -41,18 +41,18 @@ jobs: env: ARKVORY_RELEASE_VERSION: ${{ inputs.version }} steps: - - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 with: persist-credentials: false - - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 with: - node-version: '24' + node-version-file: .nvmrc cache: npm - run: npm ci --ignore-scripts - run: npm run build - name: Package once for the admitted commit run: npm run release:package -- "$ARKVORY_RELEASE_VERSION" - - uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f + - uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 with: name: release-candidate path: artifacts/${{ inputs.version }}/ @@ -74,14 +74,14 @@ jobs: env: ARKVORY_RELEASE_ARTIFACT: ${{ github.workspace }}/candidate steps: - - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 with: persist-credentials: false - - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 with: - node-version: '24' + node-version-file: .nvmrc cache: npm - - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c + - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 with: name: release-candidate path: candidate @@ -104,14 +104,14 @@ jobs: ARKVORY_RELEASE_ARTIFACT: ${{ github.workspace }}/candidate ARKVORY_NATIVE_ARTIFACT: ${{ github.workspace }}/native-candidate steps: - - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 with: persist-credentials: false - - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 with: - node-version: '24' + node-version-file: .nvmrc cache: npm - - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c + - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 with: name: release-candidate path: candidate @@ -126,7 +126,7 @@ jobs: - if: runner.os == 'Linux' run: sudo apt-get update && sudo apt-get -o DPkg::Lock::Timeout=600 install -y rpm postgresql - run: npm run gate -- native-install - - uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f + - uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 with: name: native-${{ matrix.os }} path: native-candidate/ @@ -151,17 +151,17 @@ jobs: env: ARKVORY_RELEASE_VERSION: ${{ inputs.version }} steps: - - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 with: persist-credentials: false - - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 + - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 with: - node-version: '24' - - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c + node-version-file: .nvmrc + - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 with: name: release-candidate path: artifacts/${{ inputs.version }} - - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c + - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 with: pattern: native-* merge-multiple: true diff --git a/.nvmrc b/.nvmrc index a45fd52c..229b3ce8 100644 --- a/.nvmrc +++ b/.nvmrc @@ -1 +1 @@ -24 +24.22.3 diff --git a/CHANGELOG.md b/CHANGELOG.md index 0a0df021..4b7646be 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,8 @@ Entries for the next release, copied into its GitHub release notes when it is pu **Security** +- Updated runtime dependencies Fastify, PostgreSQL's JavaScript client, MCP server SDK and Zod, refreshed development tools and pinned minimatch 11.0.8 to fix GHSA-g3hv-75wg-m249 in the tooling dependency tree. + - Windows installation hardening. `install.ps1` runs Node.js only after `node.exe` matches the pinned SHA-256 and otherwise installs a freshly verified runtime. Setup, `install.ps1` and service repair leave the program folders of the root (`runtime\`, `releases\`, `config\`, `modules\`) owned by Administrators with permissions only they can change, remove permissions that were granted on the root or these folders before, and stop with an error when one of them is a junction or a symbolic link. An existing release folder is used only after it matches its verified archive. Remote Setup creates its temporary folder already protected and checks the installer inside it before running it. Run Setup of the installed version again on Windows to apply the new permissions. See [Windows](https://github.com/ProAnima/Arkvory/blob/main/wiki/install/windows.md) and [ADR 0031](docs/adr/0031-release-installation-and-supervision.md#windows-installation). - Every Arkvory process — the services, `arkvory`, the installers, `arkvoryctl` and Remote Setup — now loads code only from its own release directory and from the built-in modules of Node.js. Module resolution no longer reaches `node_modules` folders of parent directories, the home directory of the account or `NODE_PATH`, and the service definitions clear `NODE_PATH`. On Windows, Setup makes `%ProgramData%\ProAnima` writable only by administrators when it installs Arkvory or repairs the services. Updating is recommended for every installation; run Setup of the installed version again on Windows to apply the new permissions and service definitions. See [Security](https://github.com/ProAnima/Arkvory/blob/main/wiki/operate/security.md#code-loading) and [ADR 0031](docs/adr/0031-release-installation-and-supervision.md#confinement). diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index b7ef66a8..b78fd9ea 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -2,9 +2,11 @@ ## Подготовка -Node.js 24 LTS, npm 11; устанавливайте актуальный безопасный patch в этой линии. Зависимости инструментов зафиксированы точными версиями и `package-lock.json`. Воспроизводимая установка: `npm ci`. Корень — npm workspace; отдельные lock-файлы внутри пакетов не создаются. +Node.js 24.22.3 LTS, npm 11; устанавливайте актуальный безопасный patch в этой линии. Зависимости инструментов зафиксированы точными версиями и `package-lock.json`. Воспроизводимая установка: `npm ci`. Корень — npm workspace; отдельные lock-файлы внутри пакетов не создаются. -TypeScript 5.9.3 выбран как проверяемая совместимая базовая версия с текущими инструментами lint. Обновление major TypeScript выполняется отдельно с проверкой совместимости parser, линтера и сборки, а не автоматически по `latest`. +TypeScript 6.0.3 — проверяемая совместимая базовая версия с typescript-eslint 8.72.2 (диапазон поддержки TypeScript `>=4.8.4 <6.1.0`). Обновление major TypeScript выполняется отдельно с проверкой совместимости parser, линтера и сборки, а не автоматически по `latest`. + +`minimatch` закреплён override на 11.0.8 для дерева инструментов: это закрывает GHSA-g3hv-75wg-m249, включая транзитивную зависимость typescript-eslint. Node.js declarations остаются в линии 24. Сайт документации продолжает использовать ранее выбранную ветку VitePress 2 alpha; обновление alpha не меняет этот канал. `npm run gate -- quick` выполняется локально и в GitHub Actions на Linux и Windows. PostgreSQL, браузер и аудит зависимостей — обязательные отдельные задания CI. Основной репозиторий — [ProAnima/Arkvory](https://github.com/ProAnima/Arkvory). Workflow: `.github/workflows/check.yml`; общий реестр: `config/gates.json`. diff --git a/LICENSE.md b/LICENSE.md index 9b98cf05..46798944 100644 --- a/LICENSE.md +++ b/LICENSE.md @@ -18,14 +18,14 @@ Free of charge, worldwide and non-exclusively, without the right to transfer the ## 2. What you may not do -- Distribute the software or changed versions of it, in whole or in part, in source or built form, to anyone outside your organization, or publish them. This includes forks, builds, container images and patches that contain code of the software. Copies are obtained only from official sources: https://github.com/ProAnima/Arkvory, the ProAnimaStudio update service and the container registries named in the official documentation. A fork that a hosting platform creates under its own terms gives no rights beyond this license. +- Distribute the software or changed versions of it, in whole or in part, in source or built form, to anyone outside your organization, or publish them. This includes forks, builds, container images and patches that contain code of the software. Copies are obtained only from official sources: , the ProAnimaStudio update service and the container registries named in the official documentation. A fork that a hosting platform creates under its own terms gives no rights beyond this license. - Sell, rent or lend the software or access to it, or charge for it, or provide it to third parties as a hosted or managed service. Using your installation to store and deliver your own artifacts, including to your own customers, is permitted. - Remove, hide or change copyright notices, this license, NOTICE.md, or the names ProAnima Arkvory and ProAnimaStudio in the interface and documentation of the software. - Present a changed version as the original software or as released by the licensor. ## 3. Attribution -When you publicly describe a product, service or infrastructure that uses the software (on a website, in documentation, publications or presentations), name the source: "ProAnima Arkvory by ProAnimaStudio (Ian Panaev), https://github.com/ProAnima/Arkvory". +When you publicly describe a product, service or infrastructure that uses the software (on a website, in documentation, publications or presentations), name the source: "ProAnima Arkvory by ProAnimaStudio (Ian Panaev), ". ## 4. Third-party components diff --git a/LICENSE.ru.md b/LICENSE.ru.md index 6ed9975a..2c437aa8 100644 --- a/LICENSE.ru.md +++ b/LICENSE.ru.md @@ -18,14 +18,14 @@ ProAnima Arkvory предоставляется бесплатно, а её ис ## 2. Что запрещено -- Распространять программу или её изменённые версии, целиком или частично, в исходном или собранном виде, кому-либо вне своей организации или публиковать их. Это касается и форков, сборок, образов контейнеров и патчей, содержащих код программы. Копии берутся только из официальных источников: https://github.com/ProAnima/Arkvory, сервис обновлений ProAnimaStudio и реестры образов, названные в официальной документации. Форк, который хостинг-платформа создаёт по своим правилам, не даёт прав сверх этой лицензии. +- Распространять программу или её изменённые версии, целиком или частично, в исходном или собранном виде, кому-либо вне своей организации или публиковать их. Это касается и форков, сборок, образов контейнеров и патчей, содержащих код программы. Копии берутся только из официальных источников: , сервис обновлений ProAnimaStudio и реестры образов, названные в официальной документации. Форк, который хостинг-платформа создаёт по своим правилам, не даёт прав сверх этой лицензии. - Продавать, сдавать в аренду или во временное пользование программу или доступ к ней, брать за неё плату или предоставлять её третьим лицам как размещённый или управляемый сервис. Хранить и выдавать через свою установку собственные артефакты, в том числе своим клиентам, разрешено. - Удалять, скрывать или изменять уведомления об авторских правах, эту лицензию, NOTICE.md, названия ProAnima Arkvory и ProAnimaStudio в интерфейсе и документации программы. - Выдавать изменённую версию за оригинальную программу или за выпущенную лицензиаром. ## 3. Указание источника -Если вы публично описываете продукт, сервис или инфраструктуру, которые используют программу (на сайте, в документации, публикациях или презентациях), указывайте источник: «ProAnima Arkvory, ProAnimaStudio (Ян Панаев), https://github.com/ProAnima/Arkvory». +Если вы публично описываете продукт, сервис или инфраструктуру, которые используют программу (на сайте, в документации, публикациях или презентациях), указывайте источник: «ProAnima Arkvory, ProAnimaStudio (Ян Панаев), ». ## 4. Сторонние компоненты diff --git a/README.md b/README.md index 927fa93c..7d298b4c 100644 --- a/README.md +++ b/README.md @@ -30,7 +30,7 @@ It is a standalone product with its own HTTP API, command-line client and TypeSc - **The whole cluster in one place.** Pair the other installations, mirrors and second sites with a one-time code over a pinned certificate, and see on one page whether each answers, its version, HA copies, read gateways, mirror lag and download queue. - **Mirrors and read gateways.** A second installation keeps a read-only copy of repositories and serves it when the first site is lost; extra download processes share one bandwidth budget. - **Runs by itself.** Windows services, Linux packages or Docker Compose. Services restart after a crash or a hang; signed stable updates install by hand or in a maintenance hour, behind a fresh verified backup, with rollback. -- **A console in eleven languages.** English, Russian, Spanish, French, German, Portuguese, Chinese, Japanese, Korean, Hindi and Arabic, light and dark. The documentation offers the same language selection; some Japanese and Arabic pages fall back to English. +- **A console in eleven languages.** English, Russian, Spanish, French, German, Portuguese, Chinese, Japanese, Korean, Hindi and Arabic, light and dark. All 46 user documentation pages are translated into the same eleven languages. ## Modules and Arkvory Pro @@ -81,7 +81,7 @@ The full walkthrough: [Quick start](https://proanima.github.io/Arkvory/guide/qui ## Documentation -**[proanima.github.io/Arkvory](https://proanima.github.io/Arkvory/)** — installation, everyday work, clients and protocols, operation (backups, mirrors, the high-availability cluster, storage, monitoring, security, troubleshooting) and the HTTP API reference generated from the contract the server enforces. With search and the eleven-language selector of the console; Japanese and Arabic still contain English fallback pages. The [current implementation and limits](docs/CURRENT_STATE.md) distinguish shipped features from historical plans. The engineering documents (architecture, contracts, decisions) are in Russian in [`docs/`](docs/) and in the site's developers' section. +**[proanima.github.io/Arkvory](https://proanima.github.io/Arkvory/)** — installation, everyday work, clients and protocols, operation (backups, mirrors, the high-availability cluster, storage, monitoring, security, troubleshooting) and the HTTP API reference generated from the contract the server enforces. With search, the eleven-language selector of the console and complete translations of all 46 user pages, including Japanese and Arabic. The [current implementation and limits](docs/CURRENT_STATE.md) distinguish shipped features from historical plans. The engineering documents (architecture, contracts, decisions) are in Russian in [`docs/`](docs/) and in the site's developers' section. ## Limits @@ -89,7 +89,7 @@ A standalone installation is one server with PostgreSQL and a local content dire ## For developers -Requires Node.js 24 LTS, npm 11 and PostgreSQL 18 (Docker is optional). +Requires Node.js 24.22.3 LTS, npm 11 and PostgreSQL 18 (Docker is optional). ```bash git clone https://github.com/ProAnima/Arkvory.git @@ -105,6 +105,6 @@ Running from source is for development; servers are installed from the release p **© 2026 Ian Panaev (Ян Панаев), ProAnimaStudio.** -ProAnima Arkvory is free of charge for everyone, companies included, and its source code is open for reading. It is not open source: you may use it and change it within your organization, but you may not distribute copies or forks, sell it or offer it as a service. When you publicly describe a system built on Arkvory, name the source: "ProAnima Arkvory by ProAnimaStudio (Ian Panaev), https://github.com/ProAnima/Arkvory". Copies come only from official sources. +ProAnima Arkvory is free of charge for everyone, companies included, and its source code is open for reading. It is not open source: you may use it and change it within your organization, but you may not distribute copies or forks, sell it or offer it as a service. When you publicly describe a system built on Arkvory, name the source: "ProAnima Arkvory by ProAnimaStudio (Ian Panaev), ". Copies come only from official sources. Terms: [license](LICENSE.md) ([на русском](LICENSE.ru.md); the Russian text prevails), notice: [NOTICE.md](NOTICE.md), model: [LICENSING](docs/LICENSING.md). Third-party components retain their own licenses. diff --git a/README.ru.md b/README.ru.md index ecc209b6..87130cbe 100644 --- a/README.ru.md +++ b/README.ru.md @@ -30,7 +30,7 @@ Arkvory — репозиторий для файлов, которые прои - **Весь кластер в одном месте.** Подключите другие установки, зеркала и вторые площадки одноразовым кодом по закреплённому сертификату и смотрите на одной странице, отвечает ли каждая, её версию, копии HA, шлюзы чтения, отставание зеркал и очередь скачиваний. - **Зеркала и шлюзы чтения.** Вторая установка держит копию репозиториев только для чтения и раздаёт её, если основная площадка потеряна; дополнительные процессы скачивания делят общий бюджет полосы. - **Работает сам.** Службы Windows, пакеты Linux или Docker Compose. Службы перезапускаются после падения или зависания; подписанные стабильные обновления ставятся вручную или в час обслуживания, после свежей проверенной резервной копии, с откатом. -- **Консоль на одиннадцати языках.** Английский, русский, испанский, французский, немецкий, португальский, китайский, японский, корейский, хинди и арабский; светлая и тёмная тема. В документации доступны те же языки; часть японских и арабских страниц пока показывается на английском. +- **Консоль на одиннадцати языках.** Английский, русский, испанский, французский, немецкий, португальский, китайский, японский, корейский, хинди и арабский; светлая и тёмная тема. Все 46 пользовательских страниц документации переведены на те же одиннадцать языков. ## Модули и Arkvory Pro @@ -81,7 +81,7 @@ curl -fL -H "Authorization: Bearer $ARKVORY_KEY" -o Setup.exe \ ## Документация -**[proanima.github.io/Arkvory](https://proanima.github.io/Arkvory/ru/)** — установка, повседневная работа, клиенты и протоколы, эксплуатация (резервные копии, зеркала, кластер высокой доступности, хранение, мониторинг, безопасность, устранение неполадок) и справочник HTTP API, который генерируется из контракта, проверяемого сервером. С поиском и выбором одиннадцати языков консоли; часть японских и арабских страниц пока показывается на английском. [Актуальные возможности и ограничения](docs/CURRENT_STATE.md) отделены от исторических планов. Инженерные документы (архитектура, контракты, решения) ведутся на русском в [`docs/`](docs/) и доступны в разделе сайта для разработчиков. +**[proanima.github.io/Arkvory](https://proanima.github.io/Arkvory/ru/)** — установка, повседневная работа, клиенты и протоколы, эксплуатация (резервные копии, зеркала, кластер высокой доступности, хранение, мониторинг, безопасность, устранение неполадок) и справочник HTTP API, который генерируется из контракта, проверяемого сервером. С поиском и выбором одиннадцати языков консоли; все 46 пользовательских страниц полностью переведены, включая японский и арабский. [Актуальные возможности и ограничения](docs/CURRENT_STATE.md) отделены от исторических планов. Инженерные документы (архитектура, контракты, решения) ведутся на русском в [`docs/`](docs/) и доступны в разделе сайта для разработчиков. ## Ограничения @@ -89,7 +89,7 @@ curl -fL -H "Authorization: Bearer $ARKVORY_KEY" -o Setup.exe \ ## Для разработчиков -Нужны Node.js 24 LTS, npm 11 и PostgreSQL 18 (Docker — по желанию). +Нужны Node.js 24.22.3 LTS, npm 11 и PostgreSQL 18 (Docker — по желанию). ```bash git clone https://github.com/ProAnima/Arkvory.git @@ -105,6 +105,6 @@ npm run gate -- quick **© 2026 Ian Panaev (Ян Панаев), ProAnimaStudio.** -ProAnima Arkvory бесплатен для всех, включая компании, и его исходный код открыт для чтения. Это не open source: использовать и изменять внутри своей организации можно, но распространять копии или форки, продавать и предоставлять как сервис нельзя. Публично описывая систему на основе Arkvory, укажите источник: «ProAnima Arkvory by ProAnimaStudio (Ian Panaev), https://github.com/ProAnima/Arkvory». Копии берутся только из официальных источников. +ProAnima Arkvory бесплатен для всех, включая компании, и его исходный код открыт для чтения. Это не open source: использовать и изменять внутри своей организации можно, но распространять копии или форки, продавать и предоставлять как сервис нельзя. Публично описывая систему на основе Arkvory, укажите источник: «ProAnima Arkvory by ProAnimaStudio (Ian Panaev), ». Копии берутся только из официальных источников. Условия: [лицензия](LICENSE.ru.md) ([English](LICENSE.md); при расхождении действует русский текст), уведомление: [NOTICE.md](NOTICE.md), модель: [LICENSING](docs/LICENSING.md). Сторонние компоненты сохраняют свои лицензии. diff --git a/apps/api/package.json b/apps/api/package.json index 4962f51d..3e37dc36 100644 --- a/apps/api/package.json +++ b/apps/api/package.json @@ -22,7 +22,7 @@ "@proanima/arkvory-extension-api": "0.13.0", "@proanima/arkvory-infrastructure": "0.0.0", "@proanima/arkvory-resolution": "0.0.0", - "fastify": "5.12.6", - "pg": "8.23.0" + "fastify": "5.12.8", + "pg": "8.23.1" } } diff --git a/apps/cli/package.json b/apps/cli/package.json index d42376e1..851f8703 100644 --- a/apps/cli/package.json +++ b/apps/cli/package.json @@ -15,12 +15,12 @@ "arkvoryctl": "./dist/main.js" }, "dependencies": { - "@modelcontextprotocol/server": "2.3.0", + "@modelcontextprotocol/server": "2.4.0", "@proanima/arkvory-contracts": "0.0.0", "@proanima/arkvory-extension-api": "0.13.0", "@proanima/arkvory-resolution": "0.0.0", "@proanima/arkvory-sdk": "0.0.0", "@proanima/arkvory-signing": "0.0.0", - "zod": "4.6.6" + "zod": "4.6.7" } } diff --git a/apps/web/src/user-token-model.ts b/apps/web/src/user-token-model.ts index 3de69c62..1c47a9ba 100644 --- a/apps/web/src/user-token-model.ts +++ b/apps/web/src/user-token-model.ts @@ -26,9 +26,8 @@ export function tokenState(token: UserTokenResponse, nowMs: number): TokenState return 'active'; } -export interface Toggle { - hidden: boolean; -} +/** Follow the DOM declaration, whose hidden state is wider than boolean in TypeScript 6. */ +export type Toggle = Pick; /** Sign-up stays hidden unless the server explicitly reports self-registration as enabled. */ export function applyRegistrationOption( enabled: boolean, diff --git a/compose.test.yml b/compose.test.yml index b1f480fe..20b3d82e 100644 --- a/compose.test.yml +++ b/compose.test.yml @@ -1,7 +1,7 @@ name: arkvory-tests services: postgres: - image: postgres:18.4 + image: postgres:18.7 environment: POSTGRES_USER: arkvory_test POSTGRES_PASSWORD: arkvory_test diff --git a/deploy/Dockerfile b/deploy/Dockerfile index 714cf4d3..f003dc8a 100644 --- a/deploy/Dockerfile +++ b/deploy/Dockerfile @@ -1,4 +1,4 @@ -FROM node:24.21.0-bookworm-slim +FROM node:24.22.3-bookworm-slim WORKDIR /opt/arkvory # Module resolution stays in the release (ADR 0031, addendum 2026-10-18); no global search path. ENV NODE_PATH= diff --git a/deploy/README.md b/deploy/README.md index bd4eb6eb..28b82dca 100644 --- a/deploy/README.md +++ b/deploy/README.md @@ -27,7 +27,7 @@ ZIP/tar-комплекты остаются для операторской ав | Docker, Linux | `sudo bash ./install.sh --mode compose` | root либо пользователь группы docker | restart policy Docker | | Docker, Windows | `.\install.ps1 -Mode compose` | пользователь Docker Desktop, повышение не нужно | restart policy Docker Desktop | -Командным нативным вариантам нужна доступная PostgreSQL (URL запрашивается скрыто); графические EXE/DEB/RPM создают выделенный кластер. Docker-вариант поднимает API, worker, агента резервных копий и PostgreSQL 18.4 из `deploy/compose.yml`. +Командным нативным вариантам нужна доступная PostgreSQL (URL запрашивается скрыто); графические EXE/DEB/RPM создают выделенный кластер. Docker-вариант поднимает API, worker, агента резервных копий и PostgreSQL 18.7 из `deploy/compose.yml`. Linux, нативно: @@ -61,7 +61,7 @@ Docker, Windows с работающим Docker Desktop в режиме Linux con Повышение прав для Compose не требуется и не рекомендуется: Docker Desktop читает bind mounts с токеном своего пользователя, поэтому ACL корня — SYSTEM, Administrators и этот пользователь, без наследования ([ADR 0050](../docs/adr/0050-windows-compose-engine-user.md)). Корень по умолчанию — `C:\ProgramData\ProAnima\Arkvory`; другой задаётся `-Root`. Если PowerShell запрещает запуск скриптов, используйте `powershell -ExecutionPolicy Bypass -File .\install.ps1 -Mode compose` (политика меняется только для этого процесса). При запуске от администратора дополнительно регистрируется SYSTEM-задача updater, которая рассчитана на системный движок, а не на Docker Desktop. -Движок и Compose должны быть установлены заранее; установщик не меняет гипервизор, WSL или Docker. Образ собирается локально из скомпилированного релиза. PostgreSQL 18.4 включён, пароль генерируется; named volumes сохраняют каталог БД и файлы. Для Podman: `--engine podman` / `-Engine podman`, нужен совместимый compose provider; приёмка конкретной версии проводится отдельно. Rootless Podman и Docker Desktop требуют планировщика в контексте пользователя движка; системный updater рассчитан на системный Docker/Podman. Windows containers не поставляются. +Движок и Compose должны быть установлены заранее; установщик не меняет гипервизор, WSL или Docker. Образ собирается локально из скомпилированного релиза. PostgreSQL 18.7 включён, пароль генерируется; named volumes сохраняют каталог БД и файлы. Для Podman: `--engine podman` / `-Engine podman`, нужен совместимый compose provider; приёмка конкретной версии проводится отдельно. Rootless Podman и Docker Desktop требуют планировщика в контексте пользователя движка; системный updater рассчитан на системный Docker/Podman. Windows containers не поставляются. ### Docker одной командой @@ -119,14 +119,14 @@ docker compose --project-name proanima-arkvory --project-directory $root --env-f Установка Compose без root/Administrator не регистрирует системный updater и печатает указание запланировать `updates-poll` под владельцем движка. Без него консоль не применит запросы обновления. Linux (crontab пользователя группы docker): ```bash -* * * * * /path/to/root/runtime/node-v24.21.0-linux-x64/bin/node /path/to/root/manage.mjs updates-poll --root /path/to/root +* * * * * /path/to/root/runtime/node-v24.22.3-linux-x64/bin/node /path/to/root/manage.mjs updates-poll --root /path/to/root ``` Windows (обычная PowerShell от пользователя Docker Desktop; задача работает только в его сеансе, пока Docker Desktop запущен): ```powershell $root = 'C:\ProgramData\ProAnima\Arkvory' -$node = "$root\runtime\node-v24.21.0-win-x64\node.exe" +$node = "$root\runtime\node-v24.22.3-win-x64\node.exe" $action = New-ScheduledTaskAction -Execute $node -Argument "`"$root\manage.mjs`" updates-poll --root `"$root`"" -WorkingDirectory $root $trigger = New-ScheduledTaskTrigger -Once -At (Get-Date).AddMinutes(1) -RepetitionInterval (New-TimeSpan -Minutes 1) $settings = New-ScheduledTaskSettingsSet -StartWhenAvailable -MultipleInstances IgnoreNew -ExecutionTimeLimit (New-TimeSpan -Minutes 30) @@ -176,7 +176,7 @@ sudo arkvory configure --root /opt/proanima-arkvory --backup-vault-off Контейнерные данные находятся в `proanima-arkvory_storage` и `proanima-arkvory_catalog`, а не в host data. Не запускайте `down --volumes` на установленном хранилище. Профиль имеет фиксированные Compose project и порт, одна установка на container host. Нельзя подключать второго writer к той же БД/root. -Примеры используют `node`; при отсутствии в PATH укажите поставленный `runtime/node-v24.21.0-/bin/node` (Linux) либо `runtime/node-v24.21.0-win-x64/node.exe`. Выполняйте команды с правами администратора (для Compose без повышения — от пользователя, установившего его): +Примеры используют `node`; при отсутствии в PATH укажите поставленный `runtime/node-v24.22.3-/bin/node` (Linux) либо `runtime/node-v24.22.3-win-x64/node.exe`. Выполняйте команды с правами администратора (для Compose без повышения — от пользователя, установившего его): ```bash node /opt/proanima-arkvory/manage.mjs status --root /opt/proanima-arkvory diff --git a/deploy/compose.dev.yml b/deploy/compose.dev.yml index e40ecfa3..2f77fdab 100644 --- a/deploy/compose.dev.yml +++ b/deploy/compose.dev.yml @@ -1,7 +1,7 @@ name: arkvory-dev services: postgres: - image: postgres:18.4 + image: postgres:18.7 environment: POSTGRES_USER: arkvory POSTGRES_DB: arkvory diff --git a/deploy/compose.yml b/deploy/compose.yml index 728160d2..40373650 100644 --- a/deploy/compose.yml +++ b/deploy/compose.yml @@ -20,7 +20,7 @@ x-runtime: &runtime options: { max-size: 20m, max-file: '5' } services: database: - image: postgres:18.4 + image: postgres:18.7 # API, write locks, worker, backup agent and read gateways share the server (ADR 0073). command: [postgres, -c, max_connections=200] restart: unless-stopped diff --git a/deploy/install.ps1 b/deploy/install.ps1 index fad52b60..6f4af388 100644 --- a/deploy/install.ps1 +++ b/deploy/install.ps1 @@ -122,9 +122,9 @@ if ($Mode -eq 'windows') { } $work = Join-Path $Root ('bootstrap.' + [guid]::NewGuid().ToString('N')) New-Item -ItemType Directory -Path $work | Out-Null -$nodeName = 'node-v24.21.0-win-x64' +$nodeName = 'node-v24.22.3-win-x64' # SHA-256 of node.exe in the pinned archive below (scripts/native-dependencies.mjs pins the same archive). -$nodeSha256 = 'BA4E6D110E8C1592A1ECD390F6B05F3DA124B13871A5BE62B341A07A853C6C32' +$nodeSha256 = '86FC4785327DB5F5C7558DC6156C543B433C313E813A222E088086222AB4AFA6' $nodeEntries = @('CHANGELOG.md', 'LICENSE', 'README.md', 'corepack', 'corepack.cmd', 'install_tools.bat', 'node.exe', 'node_modules', 'nodevars.bat', 'npm', 'npm.cmd', 'npm.ps1', 'npx', 'npx.cmd', 'npx.ps1') # A runtime is used only when node.exe has the pinned hash and nothing but the archive's own # entries sits beside it: Windows loads libraries from the directory of an executable first. @@ -144,10 +144,10 @@ if (-not (Test-NodeRuntime $current)) { $archive = Join-Path $work 'node.zip' # Three attempts with a pause for transient network failures; the checksum decides below. foreach ($attempt in 1..3) { - try { Invoke-WebRequest "https://nodejs.org/dist/v24.21.0/$nodeName.zip" -OutFile $archive -UseBasicParsing; break } + try { Invoke-WebRequest "https://nodejs.org/dist/v24.22.3/$nodeName.zip" -OutFile $archive -UseBasicParsing; break } catch { if ($attempt -eq 3) { throw }; Start-Sleep -Seconds (5 * $attempt) } } - if ((Get-FileHash $archive -Algorithm SHA256).Hash -ne '158F7685B44DE51F6C0DF1D153526CBCD3E1BC739A8DFC607721CEF75DE9E541') { throw 'Node.js checksum mismatch' } + if ((Get-FileHash $archive -Algorithm SHA256).Hash -ne 'E612AF99F626AB415EA225AF6BCE5C971FEB448CB5CAE250BB1C3FA50C5F7D9F') { throw 'Node.js checksum mismatch' } # A fresh directory inside the protected runtime directory; the runtime is switched to it only # after verification. Antivirus scanning can briefly hold a freshly extracted node.exe. # fresh-* directories that an interrupted run left were never run and are removed first; diff --git a/deploy/install.sh b/deploy/install.sh index 5a42f18d..706bdf34 100644 --- a/deploy/install.sh +++ b/deploy/install.sh @@ -10,17 +10,17 @@ command -v python3 >/dev/null node='' if [[ -z "$node" ]]; then case $(uname -m) in - x86_64) arch=x64; checksum=fd8e59d5a511510f6a298afb548f18c7d2b1be404d8b4a27d94fbe49f56cb2d6 ;; - aarch64) arch=arm64; checksum=6ad1325edbdb5649c379b75a237147a666c95d4f9ae8d340fef2d1575d289ad2 ;; + x86_64) arch=x64; checksum=4f2b175a6d53a5c617a80dba2676238a0688cef28c6da4eba35c7d844e66fcfb ;; + aarch64) arch=arm64; checksum=6e51a2ada00f0011cc266f65d98922b403d7ad88f809ca2aa615a5fe1ce6e86c ;; *) echo 'Supported Linux architectures: x64, arm64' >&2; exit 1 ;; esac - file="node-v24.21.0-linux-$arch.tar.xz" + file="node-v24.22.3-linux-$arch.tar.xz" curl --fail --silent --show-error --proto '=https' --retry 3 --retry-delay 5 --retry-connrefused \ - "https://nodejs.org/dist/v24.21.0/$file" -o "$work/$file" + "https://nodejs.org/dist/v24.22.3/$file" -o "$work/$file" printf '%s %s\n' "$checksum" "$work/$file" | sha256sum --check --status mkdir -p "$root/runtime" tar -xJf "$work/$file" -C "$root/runtime" - node="$root/runtime/node-v24.21.0-linux-$arch/bin/node" + node="$root/runtime/node-v24.22.3-linux-$arch/bin/node" chmod -R a+rX "$root/runtime" fi if [[ -n "${ARKVORY_ARTIFACT_DIR:-}" ]]; then diff --git a/deploy/legal/EULA.en.txt b/deploy/legal/EULA.en.txt index 505725ad..709bdd72 100644 --- a/deploy/legal/EULA.en.txt +++ b/deploy/legal/EULA.en.txt @@ -18,14 +18,14 @@ Free of charge, worldwide and non-exclusively, without the right to transfer the 2. What you may not do -- Distribute the software or changed versions of it, in whole or in part, in source or built form, to anyone outside your organization, or publish them. This includes forks, builds, container images and patches that contain code of the software. Copies are obtained only from official sources: https://github.com/ProAnima/Arkvory, the ProAnimaStudio update service and the container registries named in the official documentation. A fork that a hosting platform creates under its own terms gives no rights beyond this license. +- Distribute the software or changed versions of it, in whole or in part, in source or built form, to anyone outside your organization, or publish them. This includes forks, builds, container images and patches that contain code of the software. Copies are obtained only from official sources: , the ProAnimaStudio update service and the container registries named in the official documentation. A fork that a hosting platform creates under its own terms gives no rights beyond this license. - Sell, rent or lend the software or access to it, or charge for it, or provide it to third parties as a hosted or managed service. Using your installation to store and deliver your own artifacts, including to your own customers, is permitted. - Remove, hide or change copyright notices, this license, NOTICE.md, or the names ProAnima Arkvory and ProAnimaStudio in the interface and documentation of the software. - Present a changed version as the original software or as released by the licensor. 3. Attribution -When you publicly describe a product, service or infrastructure that uses the software (on a website, in documentation, publications or presentations), name the source: "ProAnima Arkvory by ProAnimaStudio (Ian Panaev), https://github.com/ProAnima/Arkvory". +When you publicly describe a product, service or infrastructure that uses the software (on a website, in documentation, publications or presentations), name the source: "ProAnima Arkvory by ProAnimaStudio (Ian Panaev), ". 4. Third-party components diff --git a/deploy/legal/EULA.ru.txt b/deploy/legal/EULA.ru.txt index d47306a0..55f6913b 100644 --- a/deploy/legal/EULA.ru.txt +++ b/deploy/legal/EULA.ru.txt @@ -18,14 +18,14 @@ ProAnima Arkvory предоставляется бесплатно, а её ис 2. Что запрещено -- Распространять программу или её изменённые версии, целиком или частично, в исходном или собранном виде, кому-либо вне своей организации или публиковать их. Это касается и форков, сборок, образов контейнеров и патчей, содержащих код программы. Копии берутся только из официальных источников: https://github.com/ProAnima/Arkvory, сервис обновлений ProAnimaStudio и реестры образов, названные в официальной документации. Форк, который хостинг-платформа создаёт по своим правилам, не даёт прав сверх этой лицензии. +- Распространять программу или её изменённые версии, целиком или частично, в исходном или собранном виде, кому-либо вне своей организации или публиковать их. Это касается и форков, сборок, образов контейнеров и патчей, содержащих код программы. Копии берутся только из официальных источников: , сервис обновлений ProAnimaStudio и реестры образов, названные в официальной документации. Форк, который хостинг-платформа создаёт по своим правилам, не даёт прав сверх этой лицензии. - Продавать, сдавать в аренду или во временное пользование программу или доступ к ней, брать за неё плату или предоставлять её третьим лицам как размещённый или управляемый сервис. Хранить и выдавать через свою установку собственные артефакты, в том числе своим клиентам, разрешено. - Удалять, скрывать или изменять уведомления об авторских правах, эту лицензию, NOTICE.md, названия ProAnima Arkvory и ProAnimaStudio в интерфейсе и документации программы. - Выдавать изменённую версию за оригинальную программу или за выпущенную лицензиаром. 3. Указание источника -Если вы публично описываете продукт, сервис или инфраструктуру, которые используют программу (на сайте, в документации, публикациях или презентациях), указывайте источник: «ProAnima Arkvory, ProAnimaStudio (Ян Панаев), https://github.com/ProAnima/Arkvory». +Если вы публично описываете продукт, сервис или инфраструктуру, которые используют программу (на сайте, в документации, публикациях или презентациях), указывайте источник: «ProAnima Arkvory, ProAnimaStudio (Ян Панаев), ». 4. Сторонние компоненты diff --git a/deploy/native/README.md b/deploy/native/README.md index 04e9402d..dcc9bfae 100644 --- a/deploy/native/README.md +++ b/deploy/native/README.md @@ -1,6 +1,6 @@ # Нативные пакеты Arkvory -Сборка запускается через `npm run gate -- native-package`; нужны готовые build-зависимости проекта. Windows скачивает проверенный компилятор Inno Setup 6.7.3 (или использует `ARKVORY_ISCC`), Linux требует dpkg-deb/rpmbuild. Зависимости скачиваются только при сборке, SHA-256 закреплены в `scripts/native-dependencies.mjs`. Для выпуска используется runtime из `ARKVORY_RELEASE_ARTIFACT`, а не произвольная пересборка. +Сборка запускается через `npm run gate -- native-package`; нужны готовые build-зависимости проекта. Windows скачивает проверенный компилятор Inno Setup 6.7.4 (или использует `ARKVORY_ISCC`), Linux требует dpkg-deb/rpmbuild. Зависимости скачиваются только при сборке, SHA-256 закреплены в `scripts/native-dependencies.mjs`. Для выпуска используется runtime из `ARKVORY_RELEASE_ARTIFACT`, а не произвольная пересборка. Выход: `test-results/native-candidate` либо `ARKVORY_NATIVE_ARTIFACT`: diff --git a/deploy/native/THIRD-PARTY.md b/deploy/native/THIRD-PARTY.md index 1f6ade1a..2343b3d8 100644 --- a/deploy/native/THIRD-PARTY.md +++ b/deploy/native/THIRD-PARTY.md @@ -2,10 +2,10 @@ Arkvory is provided under the ProAnima Arkvory License 1.0 (LICENSE.md), copyright Ian Panaev. Independent components retain their own licenses: -- Node.js 24.21.0: MIT and bundled notices in `runtime/NODE-LICENSE.txt` (Linux: `NODE-LICENSE.txt`). -- PostgreSQL 18.4 Windows binaries supplied by EDB: `runtime/postgres/server_license.txt`, `commandlinetools_3rd_party_licenses.txt` and `doc`. Linux uses distribution packages with their original notices. +- Node.js 24.22.3: MIT and bundled notices in `runtime/NODE-LICENSE.txt` (Linux: `NODE-LICENSE.txt`). +- PostgreSQL 18.7 Windows binaries supplied by EDB: `runtime/postgres/server_license.txt`, `commandlinetools_3rd_party_licenses.txt` and `doc`. Linux uses distribution packages with their original notices. - WinSW 2.12.0: MIT, copyright 2008–2020 Kohsuke Kawaguchi, Sun Microsystems, Inc., CloudBees, Inc., Oleg Nenashev, and other contributors. https://github.com/winsw/winsw/blob/v2.12.0/LICENSE.txt - Microsoft Visual C++ Redistributable x64: Microsoft redistribution license and bundled installer terms. https://learn.microsoft.com/cpp/windows/latest-supported-vc-redist -- Inno Setup 6.7.3 is a build tool, not a Arkvory runtime dependency. License: https://github.com/jrsoftware/issrc/blob/is-6_7_3/license.txt . Commercial licensing guidance: https://jrsoftware.org/isorder.php . +- Inno Setup 6.7.4 is a build tool, not a Arkvory runtime dependency. License: https://github.com/jrsoftware/issrc/blob/is-6_7_4/license.txt . Commercial licensing guidance: https://jrsoftware.org/isorder.php . Versions, origin URLs and SHA-256 values are pinned in `scripts/native-dependencies.mjs`. Dependency upgrades require new checksums and native acceptance. Database major upgrades are operator maintenance, never an automatic side effect of updating Arkvory. diff --git a/docs/API_MAP.md b/docs/API_MAP.md index 3d9e34ec..d7872298 100644 --- a/docs/API_MAP.md +++ b/docs/API_MAP.md @@ -6,7 +6,7 @@ Управление установленным кодом: `GET/HEAD /api/v1/system/updates` и `POST /api/v1/system/updates/requests`. Surface administration, глобальный administrator, команды check/configure/apply с revision и UUID. SDK: `client.updates`. [Контракт, права и восстановление](UPDATES.md). -Резервные копии экземпляра (B2, [ADR 0056](adr/0056-unattended-backups.md)): `/api/v1/backup/*`, surface administration, системные права `backup.read`/`backup.manage` (администратор учётных записей или файловый ключ владельца/bootstrap; ключи репозиториев — 403). Подробности — [раздел 1a](#1a-резервные-копии--реализовано). Схема БД введена в 26; в ядре 0.6.3 актуальная — 52 (`SCHEMA_VERSION`). +Резервные копии экземпляра (B2, [ADR 0056](adr/0056-unattended-backups.md)): `/api/v1/backup/*`, surface administration, системные права `backup.read`/`backup.manage` (администратор учётных записей или файловый ключ владельца/bootstrap; ключи репозиториев — 403). Подробности — [раздел 1a](#instance-backups). Схема БД введена в 26; в ядре 0.6.3 актуальная — 52 (`SCHEMA_VERSION`). Области ответственности, уровни видимости, каталог операций текущего credential и SDK для удалённых клиентов реализованы: [API_SURFACES](API_SURFACES.md). `GET/HEAD /api/v1/operations` — authenticated, контекст repository необязателен, pagination до 100, advisory conditions. `GET/HEAD /api/v1/openapi.json?surface=…` — документационное представление. Версия схемы определяется `packages/infrastructure/src/schema-version.ts`; для выпущенного ядра 0.6.3 это 52. @@ -54,6 +54,8 @@ CORS: OPTIONS для `/api/v1/*` и `/health/ready` проверяет origin/method/headers без Bearer. Это не разрешение на саму операцию; см. [EXTERNAL_UI](EXTERNAL_UI.md). `/console/` — статический клиент, не API управления. + + ## 1a. Резервные копии — реализовано Команды выполняет агент `arkvory-backup agent`; API ставит задания в очередь и читает состояние из БД, не принимает и не возвращает путей. Права проверяются до разбора входа. Байты — десятичные строки, время — ISO UTC. SDK: `client.backup`; CLI: `arkvoryctl backup`. diff --git a/docs/CI.md b/docs/CI.md index b1081a0a..38bf25a8 100644 --- a/docs/CI.md +++ b/docs/CI.md @@ -16,15 +16,15 @@ | `deployment` | ubuntu-22.04, ubuntu-24.04, windows-2022/5 | `npm run gate -- deployment` | всегда | | `deployment-services` | ubuntu-22.04, ubuntu-24.04, windows-2022/5 | `npm run gate -- deployment-services` | всегда | | `native` | ubuntu-24.04, windows-2022 | `npm run gate -- native-install` (включает `native-package`) | всегда | -| `integration` | ubuntu-24.04 + PostgreSQL 18.4 | `npm run gate -- integration` | всегда | -| `browser` | ubuntu-24.04 + PostgreSQL 18.4 | `npm run gate -- browser` | всегда | +| `integration` | ubuntu-24.04 + PostgreSQL 18.7 | `npm run gate -- integration` | всегда | +| `browser` | ubuntu-24.04 + PostgreSQL 18.7 | `npm run gate -- browser` | всегда | | `security` | ubuntu-24.04 | `npm run gate -- security` | всегда | | `deployment-containers` | ubuntu-24.04 (Docker Engine) | `npm run gate -- deployment-containers` | всегда | | `stand` | ubuntu-24.04 (Docker Engine) | `npm run gate -- deployment-stand` (включает `native-package`): два сайта и обновление с последнего релиза | всегда | | `nas` | ubuntu-24.04 (Docker Engine) | `modprobe cifs nfs nfsd`, затем `npm run gate -- deployment-nas` | всегда | | `ha-base` | ubuntu-24.04 (KVM, libvirt) | `node scripts/ha-base-image.mjs`: образ гостя с DRBD 9 и Pacemaker в кеше Actions | всегда | | `ha-failures`, `ha-power`, `ha-operations`, `ha-three` | ubuntu-24.04 (KVM, libvirt) | `npm run gate -- deployment-ha`, `deployment-ha-power`, `deployment-ha-operations`, `deployment-ha-three` (ADR 0072) | всегда | -| `large` | ubuntu-24.04 + PostgreSQL 18.4, ×2 | `npm run gate -- large-full` / `large-multipart` | push в main, `v*`, merge queue, schedule, ручной `large_transfers=true` | +| `large` | ubuntu-24.04 + PostgreSQL 18.7, ×2 | `npm run gate -- large-full` / `large-multipart` | push в main, `v*`, merge queue, schedule, ручной `large_transfers=true` | | `verdict` | ubuntu-24.04 | `node scripts/ci-verdict.mjs` | всегда | Обязательны все lanes, кроме `large`. Итоговый `Arkvory merge gate` (verdict) запускается всегда и блокирует результат при missing/failed/cancelled/skipped любого обязательного job. Для push в main, `v*`, merge queue, расписания и ручного запуска с `large_transfers` он требует также оба сценария 5 GiB. Обычный pull request может пропустить только `large`. @@ -52,7 +52,7 @@ npm run release:local -- 1.2.3 # черновик релиза на GitHub | Lane | Где | Гейты (verify) | | -------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | | `windows` | хост, рабочее дерево; БД `npm run test:db:up` | static, unit, security, integration, browser, deployment, deployment-containers, native-package (+ 5 GiB в release) | -| `linux` | контейнер `scripts/ci/linux.Dockerfile` + PostgreSQL 18.4 | static, unit, integration, browser, deployment | +| `linux` | контейнер `scripts/ci/linux.Dockerfile` + PostgreSQL 18.7 | static, unit, integration, browser, deployment | | `linux-system` | одноразовый контейнер с systemd | native-package, deployment-services, native-install, deployment-stand | Не выполняются локально (gap): Windows `deployment-services` и `native-install` — они ставят службы и пакет на машину; `deployment-nas` и `deployment-ha*` на обеих платформах (HA — гостевые ВМ KVM со своим ядром для DRBD) — монтирование SMB и NFS требует модулей ядра `cifs`, `nfs`, `nfsd` на хосте Docker, а гейты не загружают модули ядра на машине разработчика; Linux `deployment-containers` — Docker Desktop отдаёт файлы Windows без владельцев POSIX, поэтому bind mount с uid 1000 (vault Compose) на Linux-хосте ведёт себя иначе и проверяется только в GitHub Actions. Покрыты другим lane: Linux `security`, оба сценария 5 GiB. Полнота плана проверяется `tests/local-ci.test.mjs`: новый гейт в config/gates.json без lane или явного объявления роняет unit-гейт. @@ -77,6 +77,13 @@ npm run release:local -- 1.2.3 # черновик релиза на GitHub Если Actions снова станут недоступны, обязательные проверки выполняет `npm run ci:local`, а PR перечисляет фактически выполненные и невыполненные гейты. +На 2026-11-16 проверка актуализации зависимостей ядра для `8d653e39` завершилась +успешно: [run 43859770009](https://github.com/ProAnima/Arkvory/actions/runs/43859770009), +27 выполненных jobs, включая merge gate, PostgreSQL, браузерные, нативные, +контейнерные, NAS и четыре HA-профиля. Это результат указанного коммита, а не +свидетельство проверки последующих изменений. Состав и ограничения: +[MAINTENANCE_2026-11-16](MAINTENANCE_2026-11-16.md). + ## Отчёты Каждая job публикует итог в logs и job summary даже после ошибки. Архивы test-results загружаются только при repository variable `ARKVORY_UPLOAD_ARTIFACTS=true`; это дополнительный канал, который требует свободной квоты GitHub. Подробности и локальные эквиваленты: [ENGINEERING_GATES](ENGINEERING_GATES.md). diff --git a/docs/CORE_RUNBOOK.md b/docs/CORE_RUNBOOK.md index a9be5dc8..b7870e04 100644 --- a/docs/CORE_RUNBOOK.md +++ b/docs/CORE_RUNBOOK.md @@ -42,7 +42,7 @@ npm run upload -- ./example.upack releases | `ARKVORY_MAX_UPLOADS` | Параллельные PUT/complete/cancel; по умолчанию 8 (ADR 0073) | | `ARKVORY_MAX_DOWNLOADS` | Параллельные GET/HEAD bytes; по умолчанию 16 | | `ARKVORY_MAX_REQUESTS` | Одновременные аутентифицированные запросы процесса, включая ожидающие в очереди передачи; по умолчанию 128, должно быть больше `ARKVORY_MAX_UPLOADS + ARKVORY_MAX_DOWNLOADS`. Без явного значения при больших лимитах передач берётся их сумма + 64 | -| `ARKVORY_DATABASE_POOL_SIZE` | Пул запросов API к PostgreSQL, 4–200, по умолчанию 20. Сессия владения, lease чтения и закрепления живут в отдельном пуле из 3 соединений (ADR 0073) | +| `ARKVORY_DATABASE_POOL_SIZE` | Пул запросов API к PostgreSQL, 4–200, по умолчанию 20. Сессия владения, lease чтения и закрепления живут в отдельном пуле до 8 соединений (ADR 0073) | | `ARKVORY_STORAGE_RESERVE_BYTES` | Свободное место тома, которое не отдаётся под загрузки; по умолчанию 1 GiB (1073741824), `0` отключает резерв. Читают API и worker | | `ARKVORY_STORAGE_RESERVE_INODES` | Свободные inode каждого тома, которые не отдаются под запись (ADR 0083, N6); по умолчанию 100000, `0` отключает. ФС без счётчика inode (NTFS) проверяются только по байтам. Читают API и worker | | `ARKVORY_REHOME_BYTES_PER_SECOND` | Скорость копирования переносов между томами (`arkvory storage rehome`, ADR 0083, N2), байт/с; по умолчанию 0 — без предела. Читает worker | diff --git a/docs/CURRENT_STATE.md b/docs/CURRENT_STATE.md index 59740ece..7479f8f9 100644 --- a/docs/CURRENT_STATE.md +++ b/docs/CURRENT_STATE.md @@ -1,6 +1,14 @@ # Актуальное состояние Arkvory -Сверено 2026-10-25. Это навигация по реализованным возможностям и ограничениям, а не новый план разработки. При изменении поведения обновляются соответствующая страница wiki, её переводы и этот обзор. Исторические отчёты и ADR сохраняют даты и исходные результаты. +Сверено 2026-11-16. Это навигация по реализованным возможностям и ограничениям, а не новый план разработки. При изменении поведения обновляются соответствующая страница wiki, её переводы и этот обзор. Исторические отчёты и ADR сохраняют даты и исходные результаты. + +Актуализация зависимостей, инструментов и CI поверх `main` / `2c5408af` описана в +[отчёте 2026-11-16](MAINTENANCE_2026-11-16.md). Эти изменения готовятся к следующему +выпуску; опубликованной совместимой парой остаются версии ниже. + +Сверка инструкций, справочника API, текстов консоли и полное дополнение +японского и арабского переводов описаны в +[аудите документации](DOCS_TRANSLATIONS_AUDIT_2026-11-16.md). ## Выпуски и совместимость @@ -40,7 +48,7 @@ ## Как читать документацию -- Wiki — пользовательские процедуры; английский текст является источником переводов. Японский и арабский разделы частично показывают английские страницы с предупреждением. Это не полный перевод всех страниц на 11 языков. +- Wiki — пользовательские процедуры; английский текст является источником переводов. Все 46 пользовательских страниц переведены на 11 языков, включая японский и арабский; английских заглушек нет. Справочник API генерируется из контракта и переводов операций, полей и ошибок. - `ARCHITECTURE`, `RELIABILITY`, `API_CONTRACTS`, `CORE_RUNBOOK`, `UPDATES` — действующие инженерные контракты и инструкции в пределах указанной области. - `PROJECT_PLAN`, ранние разделы `ROADMAP`, проектные части backup/replication и ADR со статусом proposed — планы и история, не обещание поставленной функции. - Датированные аудиты и `CORE_VALIDATION` — результаты конкретного коммита и стенда. Их не переписывают как новую приёмку. diff --git a/docs/DOCS_TRANSLATIONS_AUDIT_2026-11-16.md b/docs/DOCS_TRANSLATIONS_AUDIT_2026-11-16.md new file mode 100644 index 00000000..35c84840 --- /dev/null +++ b/docs/DOCS_TRANSLATIONS_AUDIT_2026-11-16.md @@ -0,0 +1,131 @@ +# Аудит документации и переводов — 2026-11-16 + +Срез рабочей ветки поверх `8d653e39e4989c6dec273d06b02ed675c49991d2`. +Это проверка документации и её исполняемых примеров, а не новая приёмка +опубликованного выпуска или конкретной производственной площадки. + +## Объём + +Начальный инвентарь — 701 Markdown-файл: 506 пользовательских страниц +wiki (46 страниц на каждом из 11 языков) и 195 остальных документов. +Проверены локальные пути и якоря; исторические ADR, планы и датированные +результаты сохранены как исторические записи. + +Консоль содержит 1174 исходных ключа; у каждого языка проверены полнота, +актуальность исходного английского текста и плейсхолдеры. У справочника API +146 операций, 13 кодов ошибок и 58 причин; переводы операций, описаний полей, +ошибок, текстов сайта и глоссариев проверяются относительно текущего контракта. + +Все 68 ранее непереведённых страниц японского и арабского разделов переведены +полностью. Все 11 языков включены в `COMPLETE`: английская заглушка теперь +считается ошибкой для любого существующего языка. Проверка структуры всех +460 переводов не находит пропущенных заголовков, UI-меток, блоков кода или +технических идентификаторов. Структурная проверка не заменяет смысловую вычитку. + +Для ранее полных переводов дополнительно сверены числовые ограничения, +блоки содержания и примеры кода. Различия, оставленные намеренно, — +локализованные комментарии, человекочитаемые значения и дополнительные +пояснения интерфейса. Независимая смысловая сверка охватила все 68 новых +страниц и 72 критические страницы прежних переводов (9 страниц на каждом +из остальных 8 языков), относительно английского источника и реализации. +Дополнительно вычитаны 12 ранее переведённых арабских страниц и отдельные +разделы прежних японских, испанских, французских, корейских, русских, +китайских и хинди-переводов. Найденные общие расхождения исправлены на всех +языках. Расширенная независимая вычитка оставшихся страниц прервана лимитом +сервиса субагентов: она не объявляется завершённой. Автоматическая проверка +охватывает весь корпус; полного независимого лингвистического заключения +для каждого из 460 переводов этот отчёт не даёт. + +## Исправления + +- Удалена ссылка на отсутствующий `IMPLEMENTATION_STATUS.md` в ADR 0071. +- Сохранён регистр camelCase-якорей операций API при рендеринге VitePress: + прежняя нормализация ссылок переводила фрагмент в нижний регистр, хотя + явный id операции оставался прежним. В API_MAP добавлен устойчивый якорь + раздела резервных копий. +- Исправлено распознавание ограждений кода с отступом в проверке заголовков; + добавлен текстовый alias для подсветки Caddyfile. +- В переводах восстановлены отсутствовавшие права `artifact.delete`, + `storage.read`, `storage.manage`, ошибка `routes_unsupported` и глобальные + флаги CLI ожидания, класса и временного окна. +- Во всех языках исправлены размер отдельного пула долгих сессий каталога + (8 вместо 3), единицы таймаута, назначение лимита активных скачиваний и + чтение настроек модулей агентом резервного копирования. Удалена + несуществующая группа `ARKVORY_SHARED_DOWNLOADS_*`; указаны реальные + параметры шлюзов и общего бюджета. +- В инструкции конфигурации обновлены defaults API query pool (20), + одновременных загрузок (8) и обе формулы лимитов на одного принципала. + Для расчёта `max_connections` учтены отдельные пулы запросов, сессий и + блокировок API/worker, а также оба пула backup. Исправлены единицы + `tcp_keepalives_count`: число проб, а не секунды. +- Восстановлены default hostname, расположение `fleet.key` в каталоге данных + и предупреждение о проверке задержки реальным fence agent для исключения + отключения обоих узлов. Исправлены переводы CA-сертификатов получателей + webhook, учётных данных в немецком аудите, рабочего диска DRBD и + условия HTTPS/HTTP в корейском разделе. +- Уточнены границы доверия reverse proxy: без доверенного адреса нельзя + подменить IP клиента, request id или host; повышение публичной схемы + до HTTPS по `X-Forwarded-Proto` — отдельное предусмотренное поведение. +- Требования администратора и `--root` ограничены соответствующими + командами управления установкой. Отсутствие failover относится к + standalone, а не к поддерживаемому HA-кластеру с fencing. +- Истёкший срок в примере single-copy заменён вычислением будущего UTC + времени. SDK-пример promotion теперь выбирает ту же группу пакета, + что соседние примеры HTTP и CLI. +- Пример возобновления raw download использует сохранённый ETag исходного + GET, размер существующего частичного файла и временный ответ. Только + `206` дописывается; `200` и ошибка запроса сохраняют частичный файл. + Исправлено несогласованное значение SHA-256 в примере события. +- В четырёх протокольных инструкциях исправлены старые defaults загрузок: + 8 одновременно на сервер, 4 на принципала; справочник учитывает формулу + `min(4, ARKVORY_MAX_UPLOADS)` и аналогичную формулу скачиваний. +- Уточнены публичные login/register/options/live/status и закрытые + ready/metrics; регистрация при выключенной настройке возвращает + `403 registration_disabled`. Долг неверных паролей аккаунта хранится в + PostgreSQL и переживает перезапуск; неверный текущий пароль вне backoff + даёт `401 current_password_invalid`, а во время backoff — + `429 password_attempts`. +- Исправлены exit code `tree verify` при одних лишь `extra`, максимальный + размер Git LFS и ошибочный совет обходить его через CLI. Создание owner + установщиком относится только к графическому EXE; Windows PowerShell, + Linux и Docker используют recovery key. Восстановлены условие включения + ежедневных резервных копий администратором и способ выдачи service key. +- URL источника в цитатах лицензии и FAQ оформлены явными ссылками: + автоматическое распознавание захватывало русские, японские и китайские + кавычки и текст в URL. Условия лицензии не менялись. + +Изменения английских процедур внесены во все 10 переводов в той же ветке. +Текущие инструкции и README отражают полное покрытие японского и арабского; +датированные свидетельства приёмки не объявлены результатами новых коммитов. + +## Воспроизводимые проверки + +Проверки входят в [реестр гейтов](../config/gates.json): + +- `tests/wiki.test.mjs` — структура, переводы справочника, UI-метки, + сохранение технических идентификаторов и распознавание заголовков. +- `tests/wiki-sdk.test.mjs` — строгая компиляция всех 27 TypeScript-примеров + английской wiki против настоящего публичного SDK без исполнения примеров. +- `tests/wiki-links.test.mjs` — ссылки на все операции API в настоящем + Markdown-рендерере с сохранением регистра фрагментов. +- `tests/wiki-download-example.test.mjs` — опубликованная shell-команда + с управляемым транспортом: `206`, смена представления (`200`) и отказ + запроса; одинаковая безопасная команда во всех языках. +- `docs` — генерация справочника и полная сборка сайта; `browser` — + в том числе языки консоли, арабский RTL и ширины 320/1440 px. + +При повторном unit-прогоне исправлен порядок очистки Windows-фикстуры +`release-staging`: junction удаляется до рекурсивного удаления временной +папки. Продуктовое поведение и условия приёмки не менялись. + +Внешние ссылки проверялись отдельно от локальных: для закрытых репозиториев +GitHub использовался аутентифицированный API, сетевые таймауты перепроверены. +Старый архив документации Epic вернул 403 и оставлен как недоступный для +автоматической проверки исторический источник; недоступность не объявлена +доказанным отсутствием страницы. + +После синхронизации текстовых копий лицензии для установщиков завершился +`npm run gate -- unit docs`: **1267/1267**, без пропусков, сборка wiki успешна. +Условия лицензии не менялись. Переход поставляемых Node.js/PostgreSQL на +security releases и связанные изменения всех языков описаны в +[аудите безопасности](SECURITY_AUDIT_2026-11-16.md). diff --git a/docs/ENGINEERING_GATES.md b/docs/ENGINEERING_GATES.md index 587be4c1..fb7594ad 100644 --- a/docs/ENGINEERING_GATES.md +++ b/docs/ENGINEERING_GATES.md @@ -52,7 +52,7 @@ Native jobs в check/release кэшируют только `.cache/native-downlo | `deployment-nas` | не выполняется | только одноразовый runner: модули ядра `cifs`, `nfs`, `nfsd` и привилегированные контейнеры с systemd | | `deployment-ha*` | не выполняется | только одноразовый runner с KVM: libvirt, гостевые ВМ с DRBD 9 и Pacemaker, `fence_virsh` через SSH к хосту; базовый образ гостя строит `scripts/ha-base-image.mjs` (ADR 0072) | -`deployment-containers` требует, чтобы на движке не было проекта `proanima-arkvory` (контейнеров и volumes): gate удаляет свои volumes и не трогает чужую установку. Он скачивает проверенный Node.js 24.21.0 с nodejs.org, как поставляемый установщик. Пример для Windows: `npm run gate -- quick deployment deployment-containers`; для Linux CI-эквивалент Quality — `npm run gate -- quick deployment deployment-services`. +`deployment-containers` требует, чтобы на движке не было проекта `proanima-arkvory` (контейнеров и volumes): gate удаляет свои volumes и не трогает чужую установку. Он скачивает проверенный Node.js 24.22.3 с nodejs.org, как поставляемый установщик. Пример для Windows: `npm run gate -- quick deployment deployment-containers`; для Linux CI-эквивалент Quality — `npm run gate -- quick deployment deployment-services`. Для large нужно не менее 11 GiB свободного temp. Suites с одной БД не запускать одновременно даже из разных checkout: standalone advisory lock действует на всю БД. Локальный lock .cache/gates.lock содержит PID; после аварии сначала убедиться, что процесс завершён, затем удалить только этот файл. При ошибке гейт останавливается; не делает retry, skip или карантин. diff --git a/docs/LOCALIZATION.md b/docs/LOCALIZATION.md index 0d35f4c0..492504db 100644 --- a/docs/LOCALIZATION.md +++ b/docs/LOCALIZATION.md @@ -2,9 +2,9 @@ | Переключатель в шапке | `apps/web/src/language-menu.ts`: кнопка с флагом и двумя буквами, список-popover со всеми языками (флаг, своё название, галочка); стрелки, Home, End, буква, Enter, Escape. Флаги — `apps/web/flags/<страна>.svg` (flag-icons, MIT; лицензия там же и в `THIRD-PARTY.txt`), сервер отдаёт их через `GET /console/flags/:file` (два символа и `.svg`). Флаг — страна, не язык: английский показан флагом Великобритании, португальский — Бразилии, арабский — Саудовской Аравии (`flag` в `languages.ts`) | -Состояние: 2026-10-25. Языки: английский (исходный), русский, испанский, французский, немецкий, португальский (Бразилия), китайский (упрощённый), японский, корейский, хинди, арабский — справа налево. Решение: [ADR 0068](adr/0068-documentation-site-and-languages.md). +Состояние: 2026-11-16. Языки: английский (исходный), русский, испанский, французский, немецкий, португальский (Бразилия), китайский (упрощённый), японский, корейский, хинди, арабский — справа налево. Решение: [ADR 0068](adr/0068-documentation-site-and-languages.md). -Консоль поддерживает все перечисленные языки. Wiki полностью переведена на en, ru, es, de, zh, hi, ko, fr и pt; для ja/ar часть страниц включает английский оригинал с явным предупреждением. Актуальный перечень полных переводов задаёт `COMPLETE` в `wiki/.vitepress/structure.ts`. +Консоль и все 46 пользовательских страниц wiki доступны на всех 11 языках; английских заглушек в переводах нет. Актуальный перечень полных переводов задаёт `COMPLETE` в `wiki/.vitepress/structure.ts`. Справочник API генерируется из текущего контракта с переводами операций, полей и ошибок на те же языки. ## 1. Где живут тексты {#where} @@ -46,7 +46,7 @@ | Выбор языка: сохранённый → браузер → английский; RTL; латинские цифры в арабском | `tests/web-locales.test.mjs` | | Сервер отдаёт словарь по двум буквам и 404 на любое другое имя | `tests/integration/sdk.test.mjs` | | Консоль на каждом языке: направление, ничего шире окна на 320 и 1440 px, нет пустых подписей, текст в своей письменности, ссылка на документацию того же языка | `tests/browser/languages.mjs` (гейт `browser`) | -| В каждом языке все страницы документации, те же id заголовков, метки `[[ui:]]` и блоки кода | `tests/wiki.test.mjs` | +| В каждом языке все страницы документации, те же id заголовков, метки `[[ui:]]`, блоки кода и технические идентификаторы | `tests/wiki.test.mjs` | | Все тексты сайта, глоссарий, тексты операций API, ошибок и полей — у каждого языка, не устаревшие | `tests/wiki.test.mjs` | | Каждая `[[ui:key]]` — существующая подпись без плейсхолдеров | `tests/wiki.test.mjs` и сборка сайта | | Сайт собирается без битых ссылок | гейт `docs` | diff --git a/docs/MAINTENANCE_2026-11-16.md b/docs/MAINTENANCE_2026-11-16.md new file mode 100644 index 00000000..11327125 --- /dev/null +++ b/docs/MAINTENANCE_2026-11-16.md @@ -0,0 +1,115 @@ +# Актуализация Arkvory — 2026-11-16 + +Репозиторий: `ProAnima/Arkvory`, рабочая папка `Depot`. Основа — актуальный +`origin/main` / `2c5408afb8821da128433dc2010b14d143a9f97d`, ветка +`codex/refresh-core-2026-11-16`. Опубликованный выпуск остаётся +[0.6.3](https://github.com/ProAnima/Arkvory/releases/tag/v0.6.3); +эта актуализация не меняет номер выпуска или extension API 0.13. + +## Зависимости и инструменты + +| Компонент | Было | Стало | +| ---------------------------- | -------------- | -------------- | +| @types/node | 24.13.6 | 24.19.2 | +| dependency-cruiser | 18.4.0 | 18.7.2 | +| eslint | 10.11.0 | 10.15.0 | +| playwright | 1.63.0 | 1.65.1 | +| prettier | 3.9.8 | 3.10.1 | +| typescript | 5.9.3 | 6.0.3 | +| typescript-eslint | 8.70.1 | 8.72.2 | +| vitepress | 2.0.0-alpha.20 | 2.0.0-alpha.21 | +| fastify | 5.12.6 | 5.12.8 | +| pg | 8.23.0 | 8.23.1 | +| @modelcontextprotocol/server | 2.3.0 | 2.4.0 | +| zod | 4.6.6 | 4.6.7 | + +Транзитивные зависимости обновлены в пределах manifest-диапазонов; +точные версии и integrity сохранены в `package-lock.json`. Override +`minimatch` 11.0.8 закрывает +[GHSA-g3hv-75wg-m249](https://github.com/advisories/GHSA-g3hv-75wg-m249). +Исходный аудит показывал 9 moderate, после обновления — 0 уязвимостей. +Runtime-зависимости обновлены в прежних major-линиях; новых библиотек нет. + +TypeScript 6.0.3 находится в +[поддерживаемом диапазоне typescript-eslint](https://typescript-eslint.io/users/dependency-versions/) +(`>=4.8.4 <6.1.0`). TypeScript 7 и Node 26 types не выбраны: компилятор и +типы должны соответствовать инструментам и поддерживаемой линии Node 24. +VitePress остаётся в уже используемом канале 2 alpha. Закреплённые бинарные +зависимости нативных установщиков и их контрольные суммы не менялись. + +## Документация и CI + +Обновлены `CONTRIBUTING.md`, обзор текущего состояния и changelog следующего +patch-выпуска. Контракты API, схема БД, пользовательские процедуры и условия +лицензии прежние; историческая приёмка не переписывается. + +Тип `Toggle` формы регистрации теперь берётся из DOM через +`Pick`: TypeScript 6 расширил объявление `hidden`, +поэтому прежний собственный тип `boolean` не принимал HTML-кнопки и формы. +Действия формы прежние; helper по-прежнему записывает только boolean. +DNS resolver webhook использует `order: 'verbatim'` вместо устаревшего +`verbatim: true`; порядок адресов сохраняется согласно +[Node.js DNS API](https://nodejs.org/docs/latest-v24.x/api/dns.html#dnspromiseslookuphostname-options). +Prettier 3.10 изменил выравнивание таблиц 52 страниц арабской и хинди wiki; +проверено, что кроме отступов и длины разделителей содержимое не изменилось. + +В check, release и Pages workflows обновлены закреплённые SHA checkout 7.0.1, +setup-node 7.1.0, upload-artifact 7.0.2 и download-artifact 8.0.2. +Cache 6.1.0 и Pages actions уже актуальны. Права токенов, ограничения публикации, +обязательные jobs и условия агрегирующего verdict сохранены. + +Последний main CI на исходном коммите +[43844066844](https://github.com/ProAnima/Arkvory/actions/runs/43844066844) +завершился успешно 2026-11-16. Это результат исходной версии, а не новых +зависимостей. Для актуализации требуется отдельный PR и его собственные проверки. + +## Проверки актуализации + +Локальная среда — Windows, Node 24.13.0, npm 11.6.2. + +| Проверка | Результат | +| ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | +| `npm ci --ignore-scripts --no-audit`, `npm ls --all` | Воспроизводимая установка и корректное дерево зависимостей | +| `npm run gate -- quick security docs` | Policy, формат, типы всех 16 пакетов, lint, границы, сборка, 1257 unit-тестов, аудит и wiki — passed | +| `npm run gate -- integration browser` | 451 PostgreSQL/HTTP-тест и все 7 браузерных сценариев — passed; без skip/cancel | +| `npm audit` через security gate | 0 уязвимостей | +| `actionlint` для check, release и Pages | Passed | +| Сравнение разобранных YAML с исходной версией | Меняются только четыре закреплённых action; структура, permissions и условия прежние | +| Проверка diff 52 страниц wiki | Только отступы и ширина разделителей таблиц, без изменения текста и направления выравнивания столбцов | +| `git diff --check` | Passed | + +Первый PR CI обнаружил расхождение npm: runner с npm 11.19.1 отклонил lock, +который локальный npm 11.6.2 принимал, из-за отсутствующих optional-зависимостей +`@emnapi/core` и `@emnapi/runtime` wasm-binding Rolldown. Lock пересоздан +в чистой временной workspace через npm 11.19.1; добавлены только эти два +пакета и нормализованы peer-флаги. Версии и integrity ранее проверенных +пакетов не изменились. После исправления `npm ci --ignore-scripts --no-audit` +и `npm ls --all` через npm 11.19.1 прошли на Windows и в чистом Linux-контейнере +(Node 24.21.0). Гейты не ослаблялись; исходный неуспешный CI сохранён в +[run 43859130070](https://github.com/ProAnima/Arkvory/actions/runs/43859130070). +После исправления повторно прошёл `npm run gate -- security docs`: аудит 0, +policy, сборка и wiki — passed. Логи установки npm 11.19.1 и повторных гейтов: +`maintenance-ci-npm-repository-2026-11-16.log`, +`maintenance-ci-npm-linux-2026-11-16.log`, +`maintenance-lock-followup-2026-11-16.log` в `test-results/`. + +PostgreSQL 18.4 работал в отдельном одноразовом контейнере и отдельной тестовой +БД; после завершения контейнер удалён. Chromium установлен в изолированный +кеш `.cache/maintenance-playwright`. Браузер проверил консоль, управление +доступом, возобновляемое скачивание, обновления, обратную связь, ссылки +скачивания и Remote Setup. Интеграционный набор занял 874 секунды при +существующем лимите 900 секунд; лимиты и политики не менялись. + +Логи и JSON evidence остаются в игнорируемом `test-results/`: +`maintenance-quick-final-2026-11-16.log`, +`maintenance-integration-browser-2026-11-16.log`, +`dependency-audit-after-2026-11-16.json` и `gates/`. +Успешный quick/security/docs evidence — +`2020063c-b18b-4c18-af42-eb8b4d77c5f8.json`. +Успешный integration/browser evidence — +`0f6679d6-d568-4d99-a2e4-36adbf2f58e0.json`. + +Полные профили `verify` и `release` локально не запускались. Нативная установка, +службы, NAS/HA и передачи 5 GiB этим локальным прогоном не подтверждаются; +новому PR нужен собственный зелёный CI. Подготовка и публикация нового релиза +в эту актуализацию не входят. diff --git a/docs/READ_GATEWAYS.md b/docs/READ_GATEWAYS.md index 76ba5ce8..01d11747 100644 --- a/docs/READ_GATEWAYS.md +++ b/docs/READ_GATEWAYS.md @@ -46,13 +46,13 @@ PostgreSQL резервирует slot на 10 секунд. Локальное При потере lease шлюз прекращает выдачу новых квантов payload, возвращает 503 на новые авторизуемые запросы и требует перезапуска. Это относится и к writer: новые upload-кванты и запросы останавливаются консервативно. Уже начатая локальная сборка может корректно завершиться и зафиксировать результат; lease раздачи не заменяет storage-транзакции. Обрыв download требует клиентского retry/Range. Закрытие процесса не сокращает DB expiry. Поэтому повторный запуск того же slot сам ждёт истечения резервации, до 10 секунд после последнего продления. Неподвижная резервация остановленного процесса дожидается, а продлеваемая (тот же slot у работающего шлюза) отклоняется как `busy` через 2–3 секунды. Ожидание ограничено 15 секундами; супервизор с задержкой всё равно нужен. -Аренда держит собственное соединение с PostgreSQL от запуска до остановки: продление каждые 2 секунды не ждёт общего пула, который передачи и запросы каталога могут занять дольше срока аренды. Каждому шлюзу нужно на одно соединение больше, чем `ARKVORY_DATABASE_POOL_SIZE`. +Аренда держит собственное соединение с PostgreSQL от запуска до остановки: продление каждые 2 секунды не ждёт пула запросов, который передачи и запросы каталога могут занять дольше срока аренды. Каждый шлюз использует пул запросов размером `ARKVORY_DATABASE_POOL_SIZE` и отдельный пул до 8 соединений для служебных сессий (владение хранилищем, закрепления скачиваний и аренда шлюза). При расчёте `max_connections` PostgreSQL учитывайте оба пула; у writer дополнительно есть пул блокировок записи размером `ARKVORY_MAX_UPLOADS`. Предел зависит от стабильности часов: суммарный сдвиг/дрейф часов БД и узла за lease должен быть существенно меньше двухсекундного запаса. Скачок DB clock вперёд, изменение времени при failover или длительная остановка VM требуют остановки/ограждения старых процессов перед запуском замены. Lease не является аппаратным fencing. Уже разрешённые байты могут оставаться в ограниченных пользовательских, TCP и proxy буферах. Контролируется payload приложения с допустимым burst, а не физический uplink; см. [TRAFFIC_CONTROL](TRAFFIC_CONTROL.md). Авторизованный `/health/ready` возвращает `role`, `writable` (всегда false на reader), `sharedDownloads: { slot, slots, active, leaseSeconds }` и локальные `transfers`. В standalone `sharedDownloads` равен null. При потерянном владении — 503. `/health/live` показывает только живой HTTP-процесс и не подходит для выбора обслуживающего шлюза. Для балансировщика без ключа подходит публичный `/health/status`: он отвечает 503, пока шлюз не может обслуживать (потеря владения, lease или drain, а также план модулей, отличный от записанного процессом записи, — `module_plan_mismatch`, [ADR 0079](adr/0079-extension-modules.md)). Шлюз читает тот же `ARKVORY_MODULES_FILE`, что процесс записи. Сравнивается отпечаток совместимости плана: набор модулей, их источники, точки расширения, выбор и настройки, у внешних модулей — линия caret версии; версии ядра и встроенных модулей в него не входят. Поэтому шлюз прежнего релиза с тем же планом остаётся готовым рядом с обновлённым процессом записи, если схема БД не менялась. -Захват роли после сбоя зависит от того, когда PostgreSQL освободит сессионные замки умершего процесса. При обрыве сети без FIN сервер узнаёт об этом только по TCP keepalive. Задайте на PostgreSQL `tcp_keepalives_idle`, `tcp_keepalives_interval` и `tcp_keepalives_count` (например, 10 с, 5 с и 3) или `tcp_user_timeout`. Иначе новый writer или worker может ждать системных часов по умолчанию. +Захват роли после сбоя зависит от того, когда PostgreSQL освободит сессионные замки умершего процесса. При обрыве сети без FIN сервер узнаёт об этом только по TCP keepalive. Задайте на PostgreSQL `tcp_keepalives_idle`, `tcp_keepalives_interval` и `tcp_keepalives_count` (например, 10 с, 5 с и 3) или `tcp_user_timeout`. Иначе новый writer или worker может ждать системного тайм-аута по умолчанию. ## Обновление и обслуживание diff --git a/docs/SECURITY_AUDIT_2026-11-16.md b/docs/SECURITY_AUDIT_2026-11-16.md new file mode 100644 index 00000000..cd1fcc9b --- /dev/null +++ b/docs/SECURITY_AUDIT_2026-11-16.md @@ -0,0 +1,189 @@ +# Проверка безопасности и инфраструктуры — 2026-11-16 + +Область: исходники и история Git `ProAnima/Arkvory` и `ProAnima/Arkvory-Pro`, +зависимости npm, поставляемые runtime, Docker/Compose, GitHub Actions и локальные +одноразовые стенды. Рабочие серверы, внешние развёртывания и другие проекты на +этой машине не проверялись. Проверка не доказывает отсутствие неизвестных ошибок +и не является полной независимой экспертизой исходного кода. + +Связанный результат: [документация и переводы](DOCS_TRANSLATIONS_AUDIT_2026-11-16.md). +Историческая приёмка обновления npm сохранена отдельно в +[отчёте обслуживания](MAINTENANCE_2026-11-16.md). + +## Исправления + +### Поставляемые runtime отставали от security releases + +Node.js 24.21.0 заменён на **24.22.3** в Windows/Linux-установщиках, +нативной упаковке, Dockerfile, CI-образе и защищённой сборке Pro. Обновлены +SHA-256 Windows ZIP, Linux x64/arm64 и `node.exe`, проверки установщика, +инструкции и все 11 языков wiki. Минимум Node в manifests/lockfiles обоих +репозиториев и `.nvmrc` теперь 24.22.3. CI читает `.nvmrc`. + +Это [security release Node.js от 11 ноября](https://nodejs.org/en/blog/release/v24.22.3/), +в том числе исправления HTTP/TLS. Применимость каждого upstream CVE к Arkvory +отдельно не доказана; например, приложение не использует серверный `node:http2`. + +PostgreSQL 18.4 заменён на **18.7** в Compose, тестовых сервисах CI и +нативном Windows-пакете; digest Linux-стенда обновлён. Вендор выпустил +[исправления безопасности 12 ноября](https://www.postgresql.org/about/news/postgresql-187-1712-1616-1520-1425-and-19-rc-2-released-3442/). +В частности, [CVE-2026-6460](https://www.postgresql.org/support/security/CVE-2026-6460/) +позволяет владельцу SQL-объекта исполнить код сервера. Наличие работающего +Arkvory-эксплойта этой ошибки не утверждается. + +Архивы Node проверены по официальному `SHASUMS256.txt`; подпись Windows +`node.exe` действительна, издатель OpenJS Foundation. Windows ZIP PostgreSQL +получен по HTTPS с `get.enterprisedb.com`; версия `postgres.exe` — 18.7, +Authenticode действителен, издатель EnterpriseDB Corporation. Это проверка +конкретного исполняемого файла, а не подпись всего ZIP. +SHA-256 архива `ead0bbc27fb678fa24dcf86b738981323042abd073c744103bf7f3aed23f9a33` +измерен локально и закреплён в `scripts/native-dependencies.mjs`. +**Независимый опубликованный checksum EDB не найден**: это ограничение +проверки происхождения, а не подтверждение подписи поставщика. При каждом +использовании упаковщик проверяет закреплённый хеш. + +### Инструменты упаковки и стенды + +Inno Setup обновлён с 6.7.3 до +[6.7.4](https://github.com/jrsoftware/issrc/releases/tag/is-6_7_4) в поддерживаемой +ветке 6.x. PowerShell Linux-стенда обновлён с 7.6.6 до +[7.6.10 LTS](https://github.com/PowerShell/PowerShell/releases/tag/v7.6.10). +SHA-256 получены из digest официальных GitHub release assets. База Ubuntu +24.04 для CI и одноразовых системных стендов заменена на registry digest +`sha256:73b999393d07f2bf65a40373778a44dc9a6d54ad7718d29247d8ff9413c4d6a8`. + +Microsoft VC++ ветки VS 17 проверен заново через официальный download endpoint: +версия 14.44.35211.0, действительная подпись Microsoft Corporation и тот же +SHA-256, который уже закреплён в репозитории. Изменение не требуется. + +WinSW остаётся 2.12.0: авторы пометили +[2.13.0](https://github.com/winsw/winsw/releases/tag/v2.13.0) как экспериментальную +версию с несовместимыми изменениями. Номер latest сам по себе не является +основанием менять сервисный wrapper без отдельной проверки. Его старые +зависимости не объявляются свободными от уязвимостей. + +Глобальный Node.js этой Windows-машины — 24.13.0; он не заменялся, поскольку +его используют и другие проекты. Проверки этого изменения запускаются с +проверенным portable Node.js 24.22.3 через PATH только процесса. Для обычной +разработки требуется переключить менеджер версий на значение `.nvmrc`. + +### Аудит npm отсутствовал в обязательной приёмке Pro + +В Pro добавлен гейт `security` с `npm audit --audit-level=moderate`, +включённый в `verify` и `release`. Отдельное задание CI выполняет +`quick security`, чтобы формат, типы, unit/HTTP/recovery и аудит зависимостей +проверялись независимо от ресурсоёмкой физической приёмки. Сетевой отказ +аудита считается ошибкой. Полный `verify` и его требования не ослаблены. + +## Результаты сканеров + +Проверка npm включает dev-зависимости: **0 известных уязвимостей** в обоих +lockfiles. Trivy 0.76.2 также не нашёл уязвимых npm-зависимостей в этих lockfiles. +Для Core сканировалась копия текущих файлов из `git ls-files`, включая новые +неигнорируемые файлы: старые игнорируемые `.claude/worktrees` не относятся к +дереву этой ветки и исключены из результата. + +Gitleaks 8.30.1 проверил текущие файлы и всю доступную локальную историю +`git --all`, с полным скрытием значений секретов в отчётах: + +| Репозиторий | Текущие файлы | История | Разбор | +| ----------- | ------------: | ------: | -------------------------------------------------------------------------------------------------------- | +| Core | 13 | 13 | Только тестовые фикстуры, ID модульного ключа, checksum происхождения и локальный webhook signing secret | +| Pro | 11 | 12 | Те же лицензионные golden vectors, фиктивный token ID в replay-тесте и ID блока delta-client | + +Все срабатывания имеют правило `generic-api-key` и пути под `tests/`. +Фиксированные ключи golden vectors описаны в +[`tests/fixtures/licence-vectors/README.md`](../tests/fixtures/licence-vectors/README.md) +и не являются доверенными production roots. Webhook secret используется только +в одноразовом тестовом сервере. Подтверждённых действующих секретов среди этих +срабатываний нет; исходные срабатывания не скрыты allowlist или baseline. + +### Базовые контейнерные образы + +Trivy использовал базу, загруженную 2026-11-16. Числа — записи «пакет/CVE», +включая повторения одного CVE в нескольких пакетах, а не число доступных атак +или уникальных уязвимостей приложения. Сканировались базовые Docker Hub образы, +а не все варианты установленных систем и не внешние рабочие контейнеры. + +| Образ | CRITICAL | HIGH | MEDIUM | LOW | UNKNOWN | С известной исправленной версией | Уникальных CVE | +| ---------------------------- | -------: | ---: | -----: | --: | ------: | -------------------------------: | -------------: | +| `node:24.21.0-bookworm-slim` | 4 | 55 | 121 | 86 | 8 | 47 | 151 | +| `node:24.22.3-bookworm-slim` | 1 | 44 | 110 | 86 | 5 | 19 | 124 | +| `postgres:18.4` | 14 | 214 | 289 | 180 | 15 | 279 | 282 | +| `postgres:18.7` | 2 | 149 | 194 | 156 | 11 | 65 | 221 | + +У обновлённого Node-образа 19 исправляемых записей относятся к зависимостям +bundled npm (`brace-expansion`, `glob`, `ip-address`, `minimatch`, +`postcss-selector-parser`, `undici`), а не к lockfile Arkvory. Они остаются +открытым долгом upstream-образа; обновление приложения через npm audit их не +устраняет. У PostgreSQL остаются `zlib1g` и зависимости бинарника `gosu`, +в том числе Go stdlib. Наличие Go HTTP/TLS CVE в `gosu` само по себе не +доказывает сетевую достижимость: этот бинарник переключает пользователя при +старте. Полная проверка достижимости всех записей не проводилась. Неисправленные +записи и записи без доступного исправления не объявлены безопасными. + +Проверенные registry digests обновлённых multi-platform образов: + +- Node: `sha256:dc26ae92c9fb15cf6b1d63e20f0944b2efe0f115b20e00be48fb23fceb061c54`. +- PostgreSQL: `sha256:2ea8630df176ad090ec92136dee850397c5af8781e4bcf2e4162593691c61bbc`. + +### Конфигурация и доступ + +Trivy сообщил `DS-0026` (LOW: нет `HEALTHCHECK`) в production Dockerfile: +фактический healthcheck API определён в `deploy/compose.yml` и вызывает +`apps/deploy/dist/probe.js`. Для запуска вне Compose отдельный probe должен +назначить оператор. + +В `scripts/ci/linux.Dockerfile` найдены `DS-0002` (HIGH: root) и `DS-0026` +(LOW). Это одноразовый инструментальный образ для системных служб, упаковки +и стендов, не production runtime. Нужные привилегии CI не перенесены в продукт. +Срабатывания оставлены в отчёте; успешный exit сканера без порога severity +не означает отсутствия таких находок. + +Ручная проверка Compose/Actions подтвердила: + +- API/worker работают как `node`, с `read_only`, `cap_drop: ALL`, + `no-new-privileges`, ограниченным tmpfs и ротацией логов; опубликованный + API-порт привязан к loopback, production PostgreSQL не публикует порт хоста. +- Root у `initialize`/`vault-owner` нужен для одноразовой подготовки владельца + volumes. `vault-owner` не имеет сети и запускается через maintenance profile. +- Подготовка Pro передаёт manifests/lockfile в сетевую фазу; защищённая сборка + выполняется без сети, с readonly mounts, снятыми capabilities и отдельными + лимитами ресурсов. Образы выбираются по immutable ID. +- Actions закреплены по SHA, checkout не сохраняет credentials, доступ по + умолчанию `contents: read`. Release admission Core требует полный merge gate + для точного коммита на main. Публикация релиза в рамках этой проверки не запускалась. + +**Dependabot alerts отключены в обоих GitHub-репозиториях**: API ответил 403 +с явным сообщением об отключённой функции. Доступ текущей учётной записи не +позволяет включить её; это открытая задача владельца репозиториев. `npm audit` +в CI остаётся действующим контролем, но не заменяет уведомления GitHub. + +Серверный SAST-отчёт GitHub недоступен: для Pro API явно сообщил, что code +scanning выключен; для Core вернул `no analysis found` с требованием +дополнительного scope. Отсутствие доступного отчёта не считается нулём +находок. Включение сервиса и условия доступа требуют действий владельца. + +Полный Pro CI ранее останавливался на preflight: 8 978 329 600 свободных байт +при требовании 60 GiB, ещё до `verify`. Нужен runner с достаточным диском, +числом inodes и KVM. Требования к 4 млн физическим файлам, 12 млн ссылкам и +виртуализации сохранены; отсутствие полной приёмки нельзя считать PASS. + +## Воспроизведение и свидетельства + +Приёмочные проверки выполняются через `npm run gate`. Для ручного аудита: + +```text +npm audit --json +gitleaks git --log-opts=--all --redact=100 --ignore-gitleaks-allow --report-format=json --report-path= . +gitleaks dir --redact=100 --ignore-gitleaks-allow --report-format=json --report-path= +trivy fs --scanners vuln,misconfig --include-dev-deps --format json --output +trivy image --scanners vuln --format json --output +``` + +Локальные исходные отчёты сохранены в игнорируемых `test-results/security-*`: +версии и checksum инструментов, официальные Node SHASUMS, provenance EDB, +Gitleaks, Trivy, registry manifests и вывод гейтов. Они не содержат раскрытых +значений секретов и не являются автоматически опубликованными CI artifacts. +Сканирование истории охватывает полученные локально refs, а не скрытые +удалённые объекты, удалённые репозитории или серверные secret stores. diff --git a/docs/WIKI.md b/docs/WIKI.md index 936dbbc9..115dda5c 100644 --- a/docs/WIKI.md +++ b/docs/WIKI.md @@ -62,8 +62,24 @@ npm run gate -- docs # сборка как в CI ## Языки, у которых переведено не всё {#stubs} -Полностью переведены `en`, `ru`, `es`, `de`, `zh`, `hi`, `ko`, `fr` и `pt` (`COMPLETE` в `wiki/.vitepress/structure.ts`): для них нехватка страницы — ошибка теста. Остальные языки могут показывать английскую страницу там, где своей ещё нет: это файл-заглушка (``, предупреждение на языке читателя и `` английской страницы). Заглушки лежат в git, чтобы у каждого языка были все страницы; их пишет `npm run wiki -- stubs`, тест требует, чтобы они были актуальны. Перевести страницу — перезаписать её заглушку (сначала удалите файл или прочитайте его); `npm run wiki -- check <код>` перечисляет, что ещё осталось английским. Язык добавляется в `COMPLETE`, когда переведено всё. +Все 11 языков (`en`, `ru`, `es`, `de`, `zh`, `hi`, `ko`, `fr`, `pt`, `ja`, `ar`) входят в `COMPLETE` в `wiki/.vitepress/structure.ts`: для каждого обязательны все 46 пользовательских страниц, нехватка перевода — ошибка теста. Английских заглушек сейчас нет. + +При добавлении нового языка, который ещё не входит в `COMPLETE`, непереведённая страница может быть файлом-заглушкой: ``, предупреждение на языке читателя и `` английской страницы. Такие файлы пишет `npm run wiki -- stubs`, тест требует их актуальности. Перевести страницу — перезаписать её заглушку (сначала удалите файл или прочитайте его); `npm run wiki -- check <код>` перечисляет, что ещё осталось английским. Язык добавляется в `COMPLETE`, когда переведено всё. ## Перевод {#translation} -Изменённая английская страница меняется во всех языках в том же коммите. `tests/wiki.test.mjs` сравнивает каждую страницу с английской: те же id заголовков, те же метки `[[ui:]]`, столько же блоков кода, нет лишних страниц. Код, команды, пути, имена переменных и полей не переводятся. Термины — по глоссарию языка. +Изменённая английская страница меняется во всех языках в том же коммите. `tests/wiki.test.mjs` сравнивает каждую страницу с английской: те же id заголовков, те же метки `[[ui:]]`, столько же блоков кода, нет лишних страниц. Проверка также требует сохранить технические идентификаторы: переменные `ARKVORY_*`, флаги CLI, коды ошибок, разрешения и служебные HTTP-заголовки. Это защита от пропущенного параметра или ограничения, а не проверка смысловой точности перевода: содержание всё равно сверяется с исходником и кодом. Код, команды, пути, имена переменных и полей не переводятся. Термины — по глоссарию языка. + +`tests/wiki-sdk.test.mjs` компилирует каждый английский блок `typescript` / `ts` +в строгом режиме против собранного публичного SDK. Примеры не исполняются: +файлы, сохранение секретов и другие значения приложения получают явные типы +контекста. При добавлении нового контекста укажите его реальный публичный тип; +не заменяйте методы SDK или результаты вызовов заглушками. Проверка входит +в обычный `unit` через `npm run gate`. + +`tests/wiki-links.test.mjs` проверяет переходы к операциям API в настоящем +Markdown-рендерере: их явные camelCase-id должны пережить нормализацию ссылок +VitePress. Плагин `api-fragments.ts` сохраняет регистр таких фрагментов. +`tests/wiki-download-example.test.mjs` запускает опубликованную команду +возобновления скачивания с управляемым транспортом: только `206` дописывает +ответ, а смена представления (`200`) и ошибка запроса сохраняют прежние байты. diff --git a/docs/adr/0031-release-installation-and-supervision.md b/docs/adr/0031-release-installation-and-supervision.md index 5365b238..87d841c9 100644 --- a/docs/adr/0031-release-installation-and-supervision.md +++ b/docs/adr/0031-release-installation-and-supervision.md @@ -62,7 +62,7 @@ Download → checksum → ограниченное безопасное извл **Решение.** -- **Проверенный runtime.** `install.ps1` запускает Node.js только после проверки `runtime\node-v24.21.0-win-x64`: `node.exe` имеет SHA-256 из закреплённого архива (`scripts/native-dependencies.mjs` закрепляет тот же архив), каталог и `node.exe` — не ссылки, рядом только записи архива (Windows загружает библиотеки сначала из каталога исполняемого файла). Иначе скрипт скачивает архив, проверяет его SHA-256, распаковывает в новый каталог внутри защищённого `runtime`, проверяет его, переносит прежний каталог в `runtime\unverified-` (он не запускается) и переключается на проверенный. Непроверенный runtime не запускается никогда. Каталог распаковки удаляется и после отказа; каталоги `runtime\fresh-*`, оставшиеся от прерванного запуска, удаляются перед новой распаковкой (без перехода по ссылкам). Закреплённый SHA-256 `node.exe` и список записей `$nodeEntries` берутся из того же архива, что закрепляет `scripts/native-dependencies.mjs`; обновление Node.js меняет их вместе, а упаковка нативного установщика (gate `native-package`) останавливается, если `node.exe` архива имеет другой SHA-256 или в архиве есть запись вне `$nodeEntries`. +- **Проверенный runtime.** `install.ps1` запускает Node.js только после проверки `runtime\node-v24.22.3-win-x64`: `node.exe` имеет SHA-256 из закреплённого архива (`scripts/native-dependencies.mjs` закрепляет тот же архив), каталог и `node.exe` — не ссылки, рядом только записи архива (Windows загружает библиотеки сначала из каталога исполняемого файла). Иначе скрипт скачивает архив, проверяет его SHA-256, распаковывает в новый каталог внутри защищённого `runtime`, проверяет его, переносит прежний каталог в `runtime\unverified-` (он не запускается) и переключается на проверенный. Непроверенный runtime не запускается никогда. Каталог распаковки удаляется и после отказа; каталоги `runtime\fresh-*`, оставшиеся от прерванного запуска, удаляются перед новой распаковкой (без перехода по ссылкам). Закреплённый SHA-256 `node.exe` и список записей `$nodeEntries` берутся из того же архива, что закрепляет `scripts/native-dependencies.mjs`; обновление Node.js меняет их вместе, а упаковка нативного установщика (gate `native-package`) останавливается, если `node.exe` архива имеет другой SHA-256 или в архиве есть запись вне `$nodeEntries`. - **Каталоги кода.** При установке и восстановлении служб (`register-windows.ps1`) и в нативном Setup до запуска кода из корня (`native/prepare.ps1`, затем `apply.ps1`) `protect-windows.ps1` оставляет `runtime`, `releases`, `config` и `modules` корня группе Administrators с защищённым DACL: SYSTEM и Administrators — полный доступ, LocalService — чтение и выполнение, NetworkService — чтение и выполнение `runtime`, если есть управляемая база (как выдаёт `database-windows.ps1`). Каталог, который ещё не в этом состоянии, передаётся Administrators целиком (`takeown /R`), записи внутри получают только наследуемые права; ссылки проверяются до и после обхода, поэтому `takeown` и `icacls` не выходят за каталог. Уже защищённый каталог Administrators не обходится: добавлять в него могли только они. Ссылка (junction или символическая ссылка) на месте каталога кода или внутри непроверенного каталога останавливает установку с понятной ошибкой; для самих каталогов — до изменения корня. DACL корня и каталогов кода заменяется целиком защищённым набором записей, а не дополняется: явные записи, которые оставил создатель каталога или прежний инструмент (например, полный доступ учётной записи, создавшей корень), не сохраняются, поэтому загрузчик модулей ([ADR 0079](0079-extension-modules.md)) видит только эти записи. Корень получает SYSTEM и Administrators — полный доступ, LocalService — чтение и выполнение, NetworkService — чтение самого корня, если есть управляемая база (как выдаёт `database-windows.ps1`); `install.ps1` — SYSTEM и Administrators, в режиме Compose также пользователь движка. Явные права `data`, `logs` и `updates\inbox` выдаются после защиты корня, `database` защищён своим DACL. Файлы с учётными данными защищаются после каталогов кода: Administrators сначала забирают каждый файл (`takeown /A`), потому что `github-token.txt` и `bootstrap.owner` в корне могли существовать до установки, а ссылка на их месте останавливает установку. Новая нативная установка удаляет существовавший до неё `bootstrap.owner` до того, как Setup запишет в него учётные данные владельца: дескриптор, открытый на прежний файл, их не прочитает. `install.ps1` поставляется отдельно и содержит идентичную копию этих правил (unit-тест сравнивает копии); он защищает `runtime` и `releases` в режиме служб, Compose сохраняет права корня ([ADR 0050](0050-windows-compose-engine-user.md)) и проверяет только ссылки. Новая нативная установка копирует runtime в защищённый каталог и останавливается, если там есть записи, которых Setup не поставляет. - **Повторное использование релиза.** `stage()` использует существующий `releases/` только если он совпадает с проверенным архивом релиза: архив читается снова, его SHA-256 проверяется, архив распаковывается в новый каталог сравнения, и деревья сравниваются по записям и байтам (кроме `release.json`). Ссылки и специальные файлы не совпадают никогда; на POSIX каждая запись принадлежит пользователю установки и доступна на запись только ему. Отличающийся каталог остаётся нетронутым, операция останавливается с ошибкой. Архив, который источник скачал в корень (`download-.zip`, до 512 MiB), `stage()` удаляет после работы с ним на всех путях, в том числе после отказа; локальный артефакт оператора не удаляется. Архивы, оставшиеся от прерванной операции, удаляются в начале следующей: только обычные файлы корня с этим именем, изменённые до её начала (операция держит блокировку); ссылки не удаляются и не разыменовываются. - **Этап Remote Setup.** На Windows каталог этапа создаётся вызовом `[IO.Directory]::CreateDirectory` с владельцем Administrators и защищённым DACL (SYSTEM и Administrators) в том же вызове, поэтому ни в один момент не доступен на запись другим; существующий путь останавливает шаг, результат проверяется после создания. Команда установки снова проверяет этап, копирует загруженный установщик в новый файл этапа, считает SHA-256 через дескриптор, который держит открытым только для чтения, и запускает эту копию. Копия удаляется на всех путях; удаление этапа убирает и копию, оставшуюся после разрыва соединения. Принимаются только пути этапа, который назвал `makeRemoteStage`. На Linux этап по-прежнему создаётся `mkdir` с `umask 077`, существующий путь — ошибка. diff --git a/docs/adr/0033-native-installers-and-guided-setup.md b/docs/adr/0033-native-installers-and-guided-setup.md index 06ba1dfa..8a2eebb7 100644 --- a/docs/adr/0033-native-installers-and-guided-setup.md +++ b/docs/adr/0033-native-installers-and-guided-setup.md @@ -4,7 +4,7 @@ ## Решение -Основной Windows-дистрибутив — EXE Inno Setup 6.7.3, RU/EN, системная светлая/тёмная тема, отдельная бренд-панель. В комплекте проверенные SHA-256 Node.js 24, PostgreSQL 18, WinSW и Microsoft VC++ runtime. На целевой машине не выполняются npm, сборка или скачивание исполняемого кода. UAC и создание пароля владельца остаются необходимыми действиями пользователя. Перезагрузка, запрошенная Microsoft runtime, не маскируется успешной установкой. +Основной Windows-дистрибутив — EXE Inno Setup 6.7.4, RU/EN, системная светлая/тёмная тема, отдельная бренд-панель. В комплекте проверенные SHA-256 Node.js 24, PostgreSQL 18, WinSW и Microsoft VC++ runtime. На целевой машине не выполняются npm, сборка или скачивание исполняемого кода. UAC и создание пароля владельца остаются необходимыми действиями пользователя. Перезагрузка, запрошенная Microsoft runtime, не маскируется успешной установкой. Linux получает DEB/RPM с готовыми Node.js/Arkvory. Зависимости PostgreSQL, systemd, Python и сертификаты разрешает пакетный менеджер. Первый профиль: x64/glibc, Ubuntu 24.04 / Debian с PostgreSQL >=16, RPM-дистрибутивы с PostgreSQL 16–19. Не обещаем GUI на headless, Alpine/musl, macOS или штатный пакет для старых дистрибутивов. Графический менеджер приложений может установить локальный пакет; автоматическое открытие браузера из root post-install запрещено. Ярлык ведёт в onboarding. Docker остаётся самостоятельным Compose-профилем с заранее установленным engine: установщик хранилища не включает гипервизор или WSL. @@ -36,4 +36,4 @@ API-справочник использует существующий paginated ## Источники зависимостей -[Inno Setup](https://jrsoftware.org/isdl.php), [лицензия компилятора](https://github.com/jrsoftware/issrc/blob/is-6_7_3/license.txt), [PostgreSQL Windows](https://www.postgresql.org/download/windows/), [EDB binaries](https://www.enterprisedb.com/download-postgresql-binaries), [WinSW](https://github.com/winsw/winsw/releases/tag/v2.12.0). Все URL и digest версий зафиксированы в scripts/native-dependencies.mjs; сторонние лицензии входят в Windows payload. +[Inno Setup](https://jrsoftware.org/isdl.php), [лицензия компилятора](https://github.com/jrsoftware/issrc/blob/is-6_7_4/license.txt), [PostgreSQL Windows](https://www.postgresql.org/download/windows/), [EDB binaries](https://www.enterprisedb.com/download-postgresql-binaries), [WinSW](https://github.com/winsw/winsw/releases/tag/v2.12.0). Все URL и digest версий зафиксированы в scripts/native-dependencies.mjs; сторонние лицензии входят в Windows payload. diff --git a/docs/adr/0053-local-ci-and-release.md b/docs/adr/0053-local-ci-and-release.md index cbd35669..e4370b38 100644 --- a/docs/adr/0053-local-ci-and-release.md +++ b/docs/adr/0053-local-ci-and-release.md @@ -10,7 +10,7 @@ - `npm run ci:local -- [verify|release]` воспроизводит lanes CI на одной машине: - `windows`: гейты на хосте в рабочем дереве (static, unit, security, integration, browser, deployment, deployment-containers на Linux-движке Docker Desktop, native-package; в release ещё оба сценария 5 GiB); - - `linux`: непривилегированный контейнер из `scripts/ci/linux.Dockerfile` с отдельным PostgreSQL 18.4 в собственной сети (static, unit, integration, browser, deployment); + - `linux`: непривилегированный контейнер из `scripts/ci/linux.Dockerfile` с отдельным PostgreSQL 18.7 в собственной сети (static, unit, integration, browser, deployment); - `linux-system`: одноразовый привилегированный контейнер с systemd как PID 1 (native-package, deployment-services, native-install). Пакеты, службы, пользователи и sudo живут только в нём; контейнер удаляется после прогона. - Образ закреплён по digest Ubuntu 24.04. Node.js берётся из того же архива с проверкой SHA-256, что и runtime поставки (`scripts/native-dependencies.mjs`). Playwright задан точной версией из `package.json`. Тег образа выводится из Dockerfile, хеша Node.js и версии Playwright. - Контейнерные lanes получают исходники через `git bundle`, а не через bind mount: тестируется ровно коммит, `node_modules` хоста в Linux не попадает. При `--allow-dirty` рабочее дерево фиксируется как отдельный commit object через временный индекс (HEAD, индекс и stash не меняются). Такое evidence помечено `dirty` и для выпуска не годится. diff --git a/docs/adr/0071-s3-backup-vault.md b/docs/adr/0071-s3-backup-vault.md index 01683705..1ee39f8c 100644 --- a/docs/adr/0071-s3-backup-vault.md +++ b/docs/adr/0071-s3-backup-vault.md @@ -44,7 +44,7 @@ Vault ADR 0054 живёт в каталоге на диске или NAS. Коп ## Проверка -Контрактный набор адаптера (одни и те же тесты для `FileVault` и `S3Vault`): capture → verify `--deep` → restore в пустую цель; конкурентная публикация одной точки (ровно один `committed`, второй `exists`); прерванная загрузка blob не видна; подменённый, усечённый и переставленный объект отвергается; prune удаляет только неперечисленные blob и брошенные попытки; повтор после `500`, `429`, обрыва соединения и истечения дедлайна; неверные и просроченные учётные данные, закрытый бакет, переполненная квота; backend без условной записи отвергается при подключении; учётные данные и ключи не попадают в журнал, argv, ответы API. Интеграционный гейт поднимает MinIO (образ закреплён по digest). Реальные S3 AWS и облачные провайдеры в гейт не входят; результат ручной проверки фиксируется в [IMPLEMENTATION_STATUS](../IMPLEMENTATION_STATUS.md) как непроверенный до выполнения. +Контрактный набор адаптера (одни и те же тесты для `FileVault` и `S3Vault`): capture → verify `--deep` → restore в пустую цель; конкурентная публикация одной точки (ровно один `committed`, второй `exists`); прерванная загрузка blob не видна; подменённый, усечённый и переставленный объект отвергается; prune удаляет только неперечисленные blob и брошенные попытки; повтор после `500`, `429`, обрыва соединения и истечения дедлайна; неверные и просроченные учётные данные, закрытый бакет, переполненная квота; backend без условной записи отвергается при подключении; учётные данные и ключи не попадают в журнал, argv, ответы API. Интеграционный гейт поднимает MinIO (образ закреплён по digest). Реальные S3 AWS и облачные провайдеры в гейт не входят; результат ручной проверки фиксируется в [CURRENT_STATE](../CURRENT_STATE.md) как непроверенный до выполнения. ## Открытые вопросы для Ian Panaev diff --git a/package-lock.json b/package-lock.json index d87846b0..c44c7826 100644 --- a/package-lock.json +++ b/package-lock.json @@ -14,26 +14,26 @@ ], "devDependencies": { "@eslint/js": "10.0.1", - "@types/node": "24.13.6", + "@types/node": "24.19.2", "@types/pg": "8.23.1", "@types/ssh2": "1.15.6", "@types/yauzl": "3.4.0", "ajv": "8.20.0", "ajv-formats": "3.0.1", - "dependency-cruiser": "18.4.0", + "dependency-cruiser": "18.7.2", "esbuild": "0.28.2", - "eslint": "10.11.0", + "eslint": "10.15.0", "minisearch": "7.2.0", - "playwright": "1.63.0", - "prettier": "3.9.8", - "typescript": "5.9.3", - "typescript-eslint": "8.70.1", - "vitepress": "2.0.0-alpha.20", + "playwright": "1.65.1", + "prettier": "3.10.1", + "typescript": "6.0.3", + "typescript-eslint": "8.72.2", + "vitepress": "2.0.0-alpha.21", "yaml": "2.9.1", "yazl": "3.3.1" }, "engines": { - "node": ">=24.13.0 <25", + "node": ">=24.22.3 <25", "npm": ">=11 <12" } }, @@ -48,8 +48,8 @@ "@proanima/arkvory-extension-api": "0.13.0", "@proanima/arkvory-infrastructure": "0.0.0", "@proanima/arkvory-resolution": "0.0.0", - "fastify": "5.12.6", - "pg": "8.23.0" + "fastify": "5.12.8", + "pg": "8.23.1" } }, "apps/backup": { @@ -71,13 +71,13 @@ "version": "0.0.0", "license": "SEE LICENSE IN LICENSE.md", "dependencies": { - "@modelcontextprotocol/server": "2.3.0", + "@modelcontextprotocol/server": "2.4.0", "@proanima/arkvory-contracts": "0.0.0", "@proanima/arkvory-extension-api": "0.13.0", "@proanima/arkvory-resolution": "0.0.0", "@proanima/arkvory-sdk": "0.0.0", "@proanima/arkvory-signing": "0.0.0", - "zod": "4.6.6" + "zod": "4.6.7" }, "bin": { "arkvoryctl": "dist/main.js" @@ -124,9 +124,9 @@ } }, "node_modules/@babel/helper-string-parser": { - "version": "7.29.7", - "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.29.7.tgz", - "integrity": "sha512-Pb5ijPrZ89GDH8223L4UP8i6QApWxs04RbPQJTeWDV0/keR2E36MeKnyr6LYmUUvqRRI+Iv87SuF1W6ErINzYw==", + "version": "7.29.14", + "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.29.14.tgz", + "integrity": "sha512-CXvKMFvM80ihI7Vox9jb+kQjnyjESQNPM+vB7U0Zz6TWuZA+Z/FL0QPMH300h33qJtIx+REeBhXqWOPW48TcAQ==", "dev": true, "license": "MIT", "engines": { @@ -144,13 +144,13 @@ } }, "node_modules/@babel/parser": { - "version": "7.29.9", - "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.9.tgz", - "integrity": "sha512-CjXrNHTnvqBVqHgdBysY3vk2T8tpJHb5/RMeHJBTyVa9xgugCB0CJTx/3oO8RV2QRQP391RWpB7D6hLjm8V9uA==", + "version": "7.29.14", + "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.14.tgz", + "integrity": "sha512-VL220vXuyO2z3rNIQwY7ftj9UwpqOt+33sH+sBWkOekbsSR2g7EEMnOx24ZlCH0xOA3DM/33SifVFGbnJD8r/w==", "dev": true, "license": "MIT", "dependencies": { - "@babel/types": "^7.29.8" + "@babel/types": "^7.29.14" }, "bin": { "parser": "bin/babel-parser.js" @@ -160,13 +160,13 @@ } }, "node_modules/@babel/types": { - "version": "7.29.8", - "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.8.tgz", - "integrity": "sha512-Vj1jF3cPfxg7OAfoI7QnVKLoILlm2JF9pnVHrX8qx7AHMiYWT+NDAA7jChlNgRS4WTLc/fD1lXLmPixluj+3Gg==", + "version": "7.29.14", + "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.14.tgz", + "integrity": "sha512-UjI/dKmwJwT9pOszJitq2G6EObZPnsZUfdCr92z2TlF3EZK9J3EdfOKUrCzHl6wFthbzwhzl1Soc/UIwxRiq6w==", "dev": true, "license": "MIT", "dependencies": { - "@babel/helper-string-parser": "^7.29.7", + "@babel/helper-string-parser": "^7.29.14", "@babel/helper-validator-identifier": "^7.29.7" }, "engines": { @@ -198,26 +198,60 @@ } }, "node_modules/@docsearch/css": { - "version": "4.7.0", - "resolved": "https://registry.npmjs.org/@docsearch/css/-/css-4.7.0.tgz", - "integrity": "sha512-Sk5xkdRFeE7PeWjG9l4AfTwdvMfr9wHiwNNCpHXT4v4SNyNMKdHGvEILc31BgaVFGDDNbv5u/a73tofRiwbEZw==", + "version": "4.7.1", + "resolved": "https://registry.npmjs.org/@docsearch/css/-/css-4.7.1.tgz", + "integrity": "sha512-AsMPnbNmVLDNjhtgfq4ZRskNvWR8vuK6riEegHp3kjBFtxbmTWPzZ5s1FJ04SGr2D0ZXglueUNISsV2sDgV6Jw==", "dev": true, "license": "MIT" }, "node_modules/@docsearch/js": { - "version": "4.7.0", - "resolved": "https://registry.npmjs.org/@docsearch/js/-/js-4.7.0.tgz", - "integrity": "sha512-x5lCqu1tetgsJFkjQ6VSocbHldsRkGEgwg5N98Vx21sq/V5wcmj4u226PY9k+TEpIgQ772zlYbPLTPicWyGnpA==", + "version": "4.7.1", + "resolved": "https://registry.npmjs.org/@docsearch/js/-/js-4.7.1.tgz", + "integrity": "sha512-3FWRs18TuemPlLP5NeQG3+aYarmp3gTGnYLnZTLVlTnbFLWAgHafxUdFDWqtsqyvsbCMAeHyzwrX6MG6BuZfZA==", "dev": true, "license": "MIT" }, "node_modules/@docsearch/sidepanel-js": { - "version": "4.7.0", - "resolved": "https://registry.npmjs.org/@docsearch/sidepanel-js/-/sidepanel-js-4.7.0.tgz", - "integrity": "sha512-A8r34jCU8kcIk2viECEn2msA28ojUF1BLi/3v5OWWc5G2N3jOuuumBXoeYjfr8dA0UxgFSy5R2bt12dnFJQSyA==", + "version": "4.7.1", + "resolved": "https://registry.npmjs.org/@docsearch/sidepanel-js/-/sidepanel-js-4.7.1.tgz", + "integrity": "sha512-uyOKbC6rjHCZBVbLCSZVb1NDWzjbD27WqxTuRYnkTW717laEj2dX+W8Ho1fNHSyG4dqssIlPWlXdg+McGxxxxg==", "dev": true, "license": "MIT" }, + "node_modules/@emnapi/core": { + "version": "2.0.0-beta.2", + "resolved": "https://registry.npmjs.org/@emnapi/core/-/core-2.0.0-beta.2.tgz", + "integrity": "sha512-MzCVoWtcg4Pm2B3je5mMvYMvj3MmBKw+fU7vbsJc9/iT8ip6/eYIHo/Dsm/mr+wsHB6SEyJDuxB09Yy6r/8+4A==", + "dev": true, + "license": "MIT", + "optional": true, + "dependencies": { + "@emnapi/wasi-threads": "2.2.0", + "tslib": "^2.4.0" + } + }, + "node_modules/@emnapi/runtime": { + "version": "2.0.0-beta.2", + "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-2.0.0-beta.2.tgz", + "integrity": "sha512-JcrSPzPvZuNZvJqPTF9Fw25LbOJ8avzFVlaf2grmH4Cku0oGP47tRgqPZadcfj3YoZMHkFVnCYFbQM8I+i5QEw==", + "dev": true, + "license": "MIT", + "optional": true, + "dependencies": { + "tslib": "^2.4.0" + } + }, + "node_modules/@emnapi/wasi-threads": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/@emnapi/wasi-threads/-/wasi-threads-2.2.0.tgz", + "integrity": "sha512-JP7OYH38Q7+pyTAe14raZHLQIK7BDKbdwji+Xi3pcd/6QkJYQH3SX4wu6EplGrGJWRepoNzedfm0G3B9Z4e9Rw==", + "dev": true, + "license": "MIT", + "optional": true, + "dependencies": { + "tslib": "^2.4.0" + } + }, "node_modules/@esbuild/aix-ppc64": { "version": "0.28.2", "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.28.2.tgz", @@ -693,9 +727,9 @@ } }, "node_modules/@eslint-community/regexpp": { - "version": "4.12.2", - "resolved": "https://registry.npmjs.org/@eslint-community/regexpp/-/regexpp-4.12.2.tgz", - "integrity": "sha512-EriSTlt5OC9/7SXkRSCAhfSxxoSUgBm33OH+IkwbdpgoqsSsUg7y3uh+IICI/Qg4BBWr3U2i39RpmycbxMq4ew==", + "version": "4.12.3", + "resolved": "https://registry.npmjs.org/@eslint-community/regexpp/-/regexpp-4.12.3.tgz", + "integrity": "sha512-R76UKbvsqI68DJJVTVyqFKqU98CN4+B+acxNfEA2IFarSzP0SjtKf/3+fFiXzTyv5Fj3PxLkGHe2wnVWWMxobQ==", "dev": true, "license": "MIT", "engines": { @@ -703,15 +737,15 @@ } }, "node_modules/@eslint/config-array": { - "version": "0.23.5", - "resolved": "https://registry.npmjs.org/@eslint/config-array/-/config-array-0.23.5.tgz", - "integrity": "sha512-Y3kKLvC1dvTOT+oGlqNQ1XLqK6D1HU2YXPc52NmAlJZbMMWDzGYXMiPRJ8TYD39muD/OTjlZmNJ4ib7dvSrMBA==", + "version": "0.23.6", + "resolved": "https://registry.npmjs.org/@eslint/config-array/-/config-array-0.23.6.tgz", + "integrity": "sha512-WrTH7nioI9QPY4NZGnsywmecswJdgeq4BCM76qok9VgjTO29ZgUzUvcuJLVPYVQM4uDbaPBU0M33R9DIxI8X3w==", "dev": true, "license": "Apache-2.0", "dependencies": { "@eslint/object-schema": "^3.0.5", "debug": "^4.3.1", - "minimatch": "^10.2.4" + "minimatch": "^11.0.5" }, "engines": { "node": "^20.19.0 || ^22.13.0 || >=24" @@ -789,9 +823,9 @@ } }, "node_modules/@fastify/ajv-compiler": { - "version": "4.0.6", - "resolved": "https://registry.npmjs.org/@fastify/ajv-compiler/-/ajv-compiler-4.0.6.tgz", - "integrity": "sha512-NtuzM0SfaMJbGlnjr9LWQUN5LzgSrbB8tf/wRZNas+4E1O/Nmzl53e7ruT61HDZyRCJGC6FxIogmNZO1c5ETBA==", + "version": "4.0.7", + "resolved": "https://registry.npmjs.org/@fastify/ajv-compiler/-/ajv-compiler-4.0.7.tgz", + "integrity": "sha512-VP0yIfwlc1ohj733keYDqyHm1VWeP9VQxYomunhr90jkC4aNNibbkrRiaNgPgqj1ORxUenILR4qzA/ppYBNAtQ==", "funding": [ { "type": "github", @@ -809,10 +843,42 @@ "fast-uri": "^4.0.0" } }, + "node_modules/@fastify/ajv-compiler/node_modules/fast-uri": { + "version": "4.2.3", + "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-4.2.3.tgz", + "integrity": "sha512-I1PXwP5eAhlNlcdpjt9CgB59op2ZvZfxw+BkqGFVIUOgNpCVTcTqp3HhTX7brxj5vsip+nSY4nTvff+eIA76hg==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "BSD-3-Clause" + }, + "node_modules/@fastify/deepmerge": { + "version": "3.2.4", + "resolved": "https://registry.npmjs.org/@fastify/deepmerge/-/deepmerge-3.2.4.tgz", + "integrity": "sha512-kc8GQq5gX9RRhw0rov3DMrN8wS8yRlxJRdDzsYwwdBV/wazuVgc/1K7CKL90tlvu3RlHan6Y0R0aE3nJtBz2eQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "MIT" + }, "node_modules/@fastify/error": { - "version": "4.2.0", - "resolved": "https://registry.npmjs.org/@fastify/error/-/error-4.2.0.tgz", - "integrity": "sha512-RSo3sVDXfHskiBZKBPRgnQTtIqpi/7zhJOEmAxCiBcM7d0uwdGdxLlsCaLzGs8v8NnxIRlfG0N51p5yFaOentQ==", + "version": "4.2.1", + "resolved": "https://registry.npmjs.org/@fastify/error/-/error-4.2.1.tgz", + "integrity": "sha512-MYBumuIwP+5MIpXSyKm6/o1Eigcoij186lWUssX3LH5U8KWqU0ktZhzC4CErIX9EJeQeRGI+zJZQWakBlFbUcg==", "funding": [ { "type": "github", @@ -826,9 +892,9 @@ "license": "MIT" }, "node_modules/@fastify/fast-json-stringify-compiler": { - "version": "5.1.0", - "resolved": "https://registry.npmjs.org/@fastify/fast-json-stringify-compiler/-/fast-json-stringify-compiler-5.1.0.tgz", - "integrity": "sha512-PxcYtKLbQ8Z+yApiqjK8FwxIwvEj38k2OiLc17u8dkJSlmfi2wHHPaSnaoqBPQqtvF8YVsDgDpP2snDCfFrpfw==", + "version": "5.2.0", + "resolved": "https://registry.npmjs.org/@fastify/fast-json-stringify-compiler/-/fast-json-stringify-compiler-5.2.0.tgz", + "integrity": "sha512-LPTVA0w4oPITWHAvox9NgI1rDSrjUnjxX6QN5MCb9FY+HqvDsUmgLucbj9eQakqC8lYwO7UgkDPHEQLJNl9vtg==", "funding": [ { "type": "github", @@ -841,13 +907,13 @@ ], "license": "MIT", "dependencies": { - "fast-json-stringify": "^7.0.0" + "fast-json-stringify": "^7.3.0" } }, "node_modules/@fastify/forwarded": { - "version": "3.0.2", - "resolved": "https://registry.npmjs.org/@fastify/forwarded/-/forwarded-3.0.2.tgz", - "integrity": "sha512-NE8HgKLgYejV9lDpqkEFaDKMLYelJBVfHekhB0UKvX0ghagXRJqg68feg8er1NPXxG4N9i6vPxzt8E+3wHfcmA==", + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/@fastify/forwarded/-/forwarded-3.1.2.tgz", + "integrity": "sha512-89WiRG+hW3VQSfCwg4Hb8b43PeyEX15K5+lEfsZ4EUth/FyOjS/lv8HsVuswUNXWiSnxMGNouE/fq/0w3VumHQ==", "funding": [ { "type": "github", @@ -861,9 +927,9 @@ "license": "MIT" }, "node_modules/@fastify/merge-json-schemas": { - "version": "0.2.1", - "resolved": "https://registry.npmjs.org/@fastify/merge-json-schemas/-/merge-json-schemas-0.2.1.tgz", - "integrity": "sha512-OA3KGBCy6KtIvLf8DINC5880o5iBlDX4SxzLQS8HorJAbqluzLRn80UXU0bxZn7UOFhFgpRJDasfwn9nG4FG4A==", + "version": "0.2.2", + "resolved": "https://registry.npmjs.org/@fastify/merge-json-schemas/-/merge-json-schemas-0.2.2.tgz", + "integrity": "sha512-d/gx9sRbUCVgGRGzma46wLcwiY8noTqO2Nmjg/vbTARxHRE5bdh5PIL8s97Lt1X7ScRWRW52eVYxwIoPwIdVUA==", "funding": [ { "type": "github", @@ -880,9 +946,9 @@ } }, "node_modules/@fastify/proxy-addr": { - "version": "5.1.1", - "resolved": "https://registry.npmjs.org/@fastify/proxy-addr/-/proxy-addr-5.1.1.tgz", - "integrity": "sha512-zv07Y9GEuDsJPegZoDFd4SDWaZOW8N2pa0GSrYmKpId/tjt1Hgo3BjZBVjdVpfVrHaA+Qv5jawtS2O50J5xM9g==", + "version": "5.1.3", + "resolved": "https://registry.npmjs.org/@fastify/proxy-addr/-/proxy-addr-5.1.3.tgz", + "integrity": "sha512-ptgIgB+abBNTs5lsKNvFaKMCauPaTOE6ZIjxJr3FxCLehmYQQKYGg4srwwNICR9QQlFrYw59jWAo+i9GalVCaw==", "funding": [ { "type": "github", @@ -966,9 +1032,9 @@ } }, "node_modules/@iconify-json/simple-icons": { - "version": "1.2.98", - "resolved": "https://registry.npmjs.org/@iconify-json/simple-icons/-/simple-icons-1.2.98.tgz", - "integrity": "sha512-35CEBG1H/3nsohVgJaRWtOZ/P5syRTL++ZXTISdQSC76o1mAFXngFoSm9EOnnBiDApKPu8WN/DY+z69yCycL9A==", + "version": "1.2.102", + "resolved": "https://registry.npmjs.org/@iconify-json/simple-icons/-/simple-icons-1.2.102.tgz", + "integrity": "sha512-IwbAj1ZI6LBy+qU7sVYxB1wgbSSIDKjY9I0BnnpjfIdlqfXoYnBb80UvYA0WkodUFWfQyL4AjaKMg48fqX8sIw==", "dev": true, "license": "CC0-1.0", "dependencies": { @@ -982,6 +1048,13 @@ "dev": true, "license": "MIT" }, + "node_modules/@isaacs/nonrecursive-glob-match": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@isaacs/nonrecursive-glob-match/-/nonrecursive-glob-match-1.1.0.tgz", + "integrity": "sha512-GPm/Dbvk5RLmhRnxXIa7nTpK0xtl4E0wj0MslsuNiJ1FIROU+2+9lgUC/dgF7Ey4QCWhfEsgxilMRMCdHPfDfw==", + "dev": true, + "license": "BlueOak-1.0.0" + }, "node_modules/@jridgewell/sourcemap-codec": { "version": "1.6.0", "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.6.0.tgz", @@ -1014,9 +1087,9 @@ "license": "MIT" }, "node_modules/@modelcontextprotocol/core": { - "version": "2.3.0", - "resolved": "https://registry.npmjs.org/@modelcontextprotocol/core/-/core-2.3.0.tgz", - "integrity": "sha512-09BHFaNVBe5pB2AhzCfLj0cqmsKLERvZQ4FblzP90UMGLaXVqdZPByFjURwsUYCmxonUW2yAwgTTvle+8O2/8w==", + "version": "2.4.0", + "resolved": "https://registry.npmjs.org/@modelcontextprotocol/core/-/core-2.4.0.tgz", + "integrity": "sha512-z8QBKqdfXLPzkLQuG4xp8hrVEMm1PZ1IgxMN2sMbJiFiAKOWXnAzogXn2W4aqIBlP1ea6U5yiqVquvUNM1Cj6Q==", "license": "Apache-2.0", "dependencies": { "zod": "^4.2.0" @@ -1026,18 +1099,40 @@ } }, "node_modules/@modelcontextprotocol/server": { - "version": "2.3.0", - "resolved": "https://registry.npmjs.org/@modelcontextprotocol/server/-/server-2.3.0.tgz", - "integrity": "sha512-+6b0LdsQLmHsvS7J6sQJ4weTpzUn61fU1JKS+321/+IyDYoHW5CR2Tgqcs6GgAAQvlesCo6yX3xttgmx+XGtJw==", + "version": "2.4.0", + "resolved": "https://registry.npmjs.org/@modelcontextprotocol/server/-/server-2.4.0.tgz", + "integrity": "sha512-rgR9yxSaAJ+bcsi/XroT/S2AfPiIWloXAnrdfYSCms9ivVju0ishu/wW0J21Ho6+ZOR1r7RyeRbjiRuF87ix5Q==", "license": "Apache-2.0", "dependencies": { - "@modelcontextprotocol/core": "2.3.0", + "@modelcontextprotocol/core": "2.4.0", "zod": "^4.2.0" }, "engines": { "node": ">=20" } }, + "node_modules/@napi-rs/wasm-runtime": { + "version": "1.2.6", + "resolved": "https://registry.npmjs.org/@napi-rs/wasm-runtime/-/wasm-runtime-1.2.6.tgz", + "integrity": "sha512-mRyDmEw9/fCDXCGfL1sbgIw/GUK0PVxRW4YwgPN61F3LQ+fSyoBFarJVzgGyhF6kRzEQZ0FejDqm4WLXSeqQmw==", + "dev": true, + "license": "MIT", + "optional": true, + "dependencies": { + "@tybys/wasm-util": "^0.10.3" + }, + "engines": { + "node": "^20.19.0 || ^22.13.0 || >=23.5.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/Brooooooklyn" + }, + "peerDependencies": { + "@emnapi/core": "^1.7.1 || 2.0.0-beta.2", + "@emnapi/runtime": "^1.7.1 || 2.0.0-beta.2" + } + }, "node_modules/@noble/hashes": { "version": "2.4.0", "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-2.4.0.tgz", @@ -1051,9 +1146,9 @@ } }, "node_modules/@oxc-project/types": { - "version": "0.154.0", - "resolved": "https://registry.npmjs.org/@oxc-project/types/-/types-0.154.0.tgz", - "integrity": "sha512-KYOUGQFlLWR+s4QMV2Q9ko38TZm7EdO87Qm7rvZLqk/webse/cDjtyxKhg/47l0byCbs/k46LT8qc4PKjAikzA==", + "version": "0.156.0", + "resolved": "https://registry.npmjs.org/@oxc-project/types/-/types-0.156.0.tgz", + "integrity": "sha512-1Duyg48TdJNdyhEB8Xn1L36bT9Pv6GUtlKjHxOys8xkaF/rQq3XJE+bAurSK/AgIz5mGFsb77cn9Pb20+WCScw==", "dev": true, "license": "MIT", "funding": { @@ -1131,9 +1226,9 @@ "link": true }, "node_modules/@rolldown/binding-android-arm-eabi": { - "version": "1.2.14", - "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm-eabi/-/binding-android-arm-eabi-1.2.14.tgz", - "integrity": "sha512-aWR+XKH9+rW7m5fWq/5360J3mHycrx/o6xZM2DQFdJnTMdyP7/WzxPjhtLbVWdKo2y612/4U1bWqb3HQhiF7vg==", + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm-eabi/-/binding-android-arm-eabi-1.2.19.tgz", + "integrity": "sha512-e+Ebe0WT+9tbXmNKPIiC8YrWAHYwug3m6i4p3rZGGulfZri1jtI4HslT+OZnFf/OIHowWF71DTlHwXBP2SiA7A==", "cpu": [ "arm" ], @@ -1148,9 +1243,9 @@ } }, "node_modules/@rolldown/binding-android-arm64": { - "version": "1.2.14", - "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm64/-/binding-android-arm64-1.2.14.tgz", - "integrity": "sha512-QiVxHofl6A8lQU7WAtOUY4QMVZXohxwz7WJJoeh8NBEUyKfIkMRKhYyq8az/1RypNiIXzNTtiS6KwHz0erxYRQ==", + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm64/-/binding-android-arm64-1.2.19.tgz", + "integrity": "sha512-hOombrTJ+szt2ciEzS7oCA78lMPBgF5UMQWCJIyNfnrI7GLl8HYoFqCnpL2gcPOaXMqryGCU5ExdQKyDDcC+yA==", "cpu": [ "arm64" ], @@ -1165,9 +1260,9 @@ } }, "node_modules/@rolldown/binding-darwin-arm64": { - "version": "1.2.14", - "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-arm64/-/binding-darwin-arm64-1.2.14.tgz", - "integrity": "sha512-lTQOzHuBIooh3jIr5XINQkjPGEuGy+Dsy0meXDr6Sjty0b99kYgGh4uBC/8mJX1T0kC8d6S0aPP1Y+bHkh6aBw==", + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-arm64/-/binding-darwin-arm64-1.2.19.tgz", + "integrity": "sha512-XoMA2pwCKGTQzUjPgtRwkedH4WmXhdIPKT6l6oOxd1PUbNodGI6DcBekgN7EC//+x3pfBYX/qL1gNmZAqivw5g==", "cpu": [ "arm64" ], @@ -1182,9 +1277,9 @@ } }, "node_modules/@rolldown/binding-darwin-x64": { - "version": "1.2.14", - "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-x64/-/binding-darwin-x64-1.2.14.tgz", - "integrity": "sha512-hyMKEGatjmBYCs/Q4sbIcL/GqpFEqsX3wc+HYVQ/85A4rxc1o7rPm4DUI4GV4k/h0ITddwFSGpqQunI14GXjTA==", + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-x64/-/binding-darwin-x64-1.2.19.tgz", + "integrity": "sha512-zo8EsSSwMZCY/e+fRnGaX02YGgvJD0yvhNi/9hpGPA2MJ9ZF8dPCw75UGfpI6OpQ/myR/dIYmogRvqiZD0TrXg==", "cpu": [ "x64" ], @@ -1199,9 +1294,9 @@ } }, "node_modules/@rolldown/binding-freebsd-x64": { - "version": "1.2.14", - "resolved": "https://registry.npmjs.org/@rolldown/binding-freebsd-x64/-/binding-freebsd-x64-1.2.14.tgz", - "integrity": "sha512-u371GbXoVXrEgP20PwzoGNOdAOqAMhzo19JzzY+V4YmmnC+DTOoqdbMu+O+54emM59Mik/UdrtWgcuEDKWRPKA==", + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-freebsd-x64/-/binding-freebsd-x64-1.2.19.tgz", + "integrity": "sha512-O8ISAOfI1nj7AuBPd30FSF47z7f7lzlk5poQVGgiikvQuGEBFYvW8ki+UEnT+YJPnNGjQzn304klt4O9FUE7mA==", "cpu": [ "x64" ], @@ -1216,9 +1311,9 @@ } }, "node_modules/@rolldown/binding-linux-arm-gnueabihf": { - "version": "1.2.14", - "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm-gnueabihf/-/binding-linux-arm-gnueabihf-1.2.14.tgz", - "integrity": "sha512-BqwKsdZQf6EqVWr8fv2MrDYzAvOZ7+NYFSJESRGs87fkseEhs0TU9TXgRJTkZoRRkxTizyEg1LKUXfU3/78uqg==", + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm-gnueabihf/-/binding-linux-arm-gnueabihf-1.2.19.tgz", + "integrity": "sha512-/lYCba5NO0yq4S0jGMH8QTBtkvQxoXjoQWzF5BcWp9MjB9jxVRD1GQDNofkVjcOj30DWyhLIN/4Oe60JKzaONw==", "cpu": [ "arm" ], @@ -1233,9 +1328,9 @@ } }, "node_modules/@rolldown/binding-linux-arm64-gnu": { - "version": "1.2.14", - "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-gnu/-/binding-linux-arm64-gnu-1.2.14.tgz", - "integrity": "sha512-SD9kY8M009x/7s57Z1dgUVlP5+uYBgKQK0Tkr1WIWngrtUJmRCW1RJFMY7QDla2khXhmg2i5Io7MUjcmZNZ/KQ==", + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-gnu/-/binding-linux-arm64-gnu-1.2.19.tgz", + "integrity": "sha512-pm/apFMBnSbFb3O6nG5pHO1iqHhZrjGDFEjSm+ot9J17XXPvH9L90y5h+jgfHCE+Qdlsvy8qKEcU4VKxgjD+vA==", "cpu": [ "arm64" ], @@ -1250,9 +1345,9 @@ } }, "node_modules/@rolldown/binding-linux-arm64-musl": { - "version": "1.2.14", - "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-musl/-/binding-linux-arm64-musl-1.2.14.tgz", - "integrity": "sha512-BJ2CL19M6uuWesMgnqJzgxoI+N+eV7b0A9O9vLV42y+gitC41fNa8KElau1tHVzuLWX5GzEuxMPhAO0tQXQMkg==", + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-musl/-/binding-linux-arm64-musl-1.2.19.tgz", + "integrity": "sha512-K1SmQp3FFichn8oqrNIwvFoZ5wcvjC7goBzpaMNvLf9FZc+QB/QvLmnpJZgAAGHiD980tP8FZZnXk2K94rvlxg==", "cpu": [ "arm64" ], @@ -1267,9 +1362,9 @@ } }, "node_modules/@rolldown/binding-linux-ppc64-gnu": { - "version": "1.2.14", - "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-ppc64-gnu/-/binding-linux-ppc64-gnu-1.2.14.tgz", - "integrity": "sha512-4+Kl8daPV8NDHaD7mfCcc1pRM+Qg7ab8DyMm5FG5WoZgv4h2i3KFN1CybYBNbQqmuYm7ftJLvmMI1eHYJ22S/Q==", + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-ppc64-gnu/-/binding-linux-ppc64-gnu-1.2.19.tgz", + "integrity": "sha512-I0xwD57jP/3A7+5UPZin2w8Y7XHEmEM5zqpYZOcQ45MlNW6tUJUziymV3yRr7rL4vwyfEcRsRksC4a7Kc08p5Q==", "cpu": [ "ppc64" ], @@ -1284,9 +1379,9 @@ } }, "node_modules/@rolldown/binding-linux-s390x-gnu": { - "version": "1.2.14", - "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-s390x-gnu/-/binding-linux-s390x-gnu-1.2.14.tgz", - "integrity": "sha512-V/h8ePq1fKDrmtFMz6xcCN3DKvuvMRrwwD1q0PkBeeo4DpK64biaKvqWGVxqCeYKqeRk7gE7/iKPxLCn08O97A==", + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-s390x-gnu/-/binding-linux-s390x-gnu-1.2.19.tgz", + "integrity": "sha512-BrtEHT24SNXj9HiXqy+s/kXiSiQGt6EKCPUlRirAoIioVxKGnbXBUEkbZASAei7iZJB0/Ynm+0JP00Ipx7AnSw==", "cpu": [ "s390x" ], @@ -1301,9 +1396,9 @@ } }, "node_modules/@rolldown/binding-linux-x64-gnu": { - "version": "1.2.14", - "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-gnu/-/binding-linux-x64-gnu-1.2.14.tgz", - "integrity": "sha512-WxalXzgrLVpKC93xfpaJ3gCXUWzeCr+FRCbDVD2mUAy4L6Vo3lNVz0epUEUpxPWJkLNYUwM4OSIikv36OJ9mLg==", + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-gnu/-/binding-linux-x64-gnu-1.2.19.tgz", + "integrity": "sha512-rm75/9DkHKeU2WnA8w4X94WGYgLlDCFCfkQC+4bguVJmC/jvDRv2B+2wLOYhyE0fVuv7//Ckk39OoOufyCu76Q==", "cpu": [ "x64" ], @@ -1318,9 +1413,9 @@ } }, "node_modules/@rolldown/binding-linux-x64-musl": { - "version": "1.2.14", - "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-musl/-/binding-linux-x64-musl-1.2.14.tgz", - "integrity": "sha512-3G3tnAmTpdk9jO3GQtyHXqeFD2SlecfTws/Y3M2mmj9nMBwwuLT4kur8sZKeu7ENUHSpVO3cIsm5A52LEWWwlg==", + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-musl/-/binding-linux-x64-musl-1.2.19.tgz", + "integrity": "sha512-irh/4+iYFM4GAzpluDErgjz89bj6NDtqqMAG/6O1LG38Ed3NpyebzCpcVNkFW8uhy+/3/BocUvnXDR33CXWe9A==", "cpu": [ "x64" ], @@ -1335,9 +1430,9 @@ } }, "node_modules/@rolldown/binding-openharmony-arm64": { - "version": "1.2.14", - "resolved": "https://registry.npmjs.org/@rolldown/binding-openharmony-arm64/-/binding-openharmony-arm64-1.2.14.tgz", - "integrity": "sha512-qyr5XiNGxm2ytx17vvtcJ9nXn6v1gENETi503bJx3OGwZ1tSonj7BosxbMa/xeAfSl5iS9X6KjEWYXLu6v1L7Q==", + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-openharmony-arm64/-/binding-openharmony-arm64-1.2.19.tgz", + "integrity": "sha512-+KWTWNoPt+CfSq94CiceWu3yPE+QzkaG+phPyz9G60tmZLwfQkcA4AeksafzvJAw4pvg1mcd5a1TkUqVv0s4JA==", "cpu": [ "arm64" ], @@ -1351,10 +1446,29 @@ "node": "^20.19.0 || >=22.12.0" } }, + "node_modules/@rolldown/binding-wasm32-wasi": { + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-wasm32-wasi/-/binding-wasm32-wasi-1.2.19.tgz", + "integrity": "sha512-7EH+skOsl5qpWnK0vzamgJFhOv1cwxQpsxm8tI883K9fur5c27p8q87fzEO6BbBPabA2/+s/zR63/pLc137iOg==", + "cpu": [ + "wasm32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "dependencies": { + "@emnapi/core": "2.0.0-beta.2", + "@emnapi/runtime": "2.0.0-beta.2", + "@napi-rs/wasm-runtime": "1.2.6" + }, + "engines": { + "node": "^20.19.0 || ^22.13.0 || >=23.5.0" + } + }, "node_modules/@rolldown/binding-win32-arm64-msvc": { - "version": "1.2.14", - "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-arm64-msvc/-/binding-win32-arm64-msvc-1.2.14.tgz", - "integrity": "sha512-oA4o5o0S2yB199YyYXDzKUv1Z56Rc+mgOjwm7Z/vJ9Z8igiDPYvoOuDyo6g7AK/ZaF09nPhDKVnGBcYHO11GXA==", + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-arm64-msvc/-/binding-win32-arm64-msvc-1.2.19.tgz", + "integrity": "sha512-3Q1Yg1Q7tEvBWoZf5rFvG/GKZQPgwfru+p4wBajDfJFBs0SHCpL++dfTjW9gyAKd1T7ZpIYvdaUax7Pa/IhFVQ==", "cpu": [ "arm64" ], @@ -1369,9 +1483,9 @@ } }, "node_modules/@rolldown/binding-win32-x64-msvc": { - "version": "1.2.14", - "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-x64-msvc/-/binding-win32-x64-msvc-1.2.14.tgz", - "integrity": "sha512-9mE94bf2GZUaR/fUSXCMpBoWkctu421Mi0ORpm4zqfbkjKep7RxzPFa5etcGs5h+2KApoWBOA/hAJa/7saGgEQ==", + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-x64-msvc/-/binding-win32-x64-msvc-1.2.19.tgz", + "integrity": "sha512-y/sqRRc6d7hECzOFc5n3LSeqctmIp9mMjY1Kq4s14uLPd/LZ4z7i1zrW6fMtp2mPeuQIC4e6ULMcwQzMomqQag==", "cpu": [ "x64" ], @@ -1386,38 +1500,38 @@ } }, "node_modules/@rolldown/pluginutils": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.1.tgz", - "integrity": "sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw==", + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.1.1.tgz", + "integrity": "sha512-glFIJDvLNDtJhT9qrMFWLPbvS+skxgt4L0K8Ei2YtnhPysAJnsI7nyxSJxKj4ADeKX0OLjC4ntRkwpLOoS3rwA==", "dev": true, "license": "MIT" }, "node_modules/@shikijs/core": { - "version": "4.5.0", - "resolved": "https://registry.npmjs.org/@shikijs/core/-/core-4.5.0.tgz", - "integrity": "sha512-6CIgwq+bt2JZ3OSjb/nBkkwEf/CfpHcbam+Mg5Pllco7HAGRQ2/EFhZrrJtbyNTgKwknfVS+llsXGygiDGwJWw==", + "version": "4.6.0", + "resolved": "https://registry.npmjs.org/@shikijs/core/-/core-4.6.0.tgz", + "integrity": "sha512-bfd4OKgvoyXYiYmMRuleA656P4V7M/Du9lcTl38Ngm6KszMj7bq4J1IGZwSYR4c95Tv5UQALtYNWUwaI9UT3xw==", "dev": true, "license": "MIT", "dependencies": { - "@shikijs/primitive": "4.5.0", - "@shikijs/types": "4.5.0", - "@shikijs/vscode-textmate": "^10.0.2", + "@shikijs/primitive": "4.6.0", + "@shikijs/types": "4.6.0", + "@shikijs/vscode-textmate": "^10.1.0", "@types/hast": "^3.0.5", - "hast-util-to-html": "^9.0.5" + "hast-util-to-html": "^9.0.6" }, "engines": { "node": ">=20" } }, "node_modules/@shikijs/engine-javascript": { - "version": "4.5.0", - "resolved": "https://registry.npmjs.org/@shikijs/engine-javascript/-/engine-javascript-4.5.0.tgz", - "integrity": "sha512-Ed6UdEj84LyYkwnxM5CvSMWAD+id9ExTYri0/+x41U9zrgNifPSS9lZm0JqBP0VfYI8yr8tY5nbNq9+p9R0kFA==", + "version": "4.6.0", + "resolved": "https://registry.npmjs.org/@shikijs/engine-javascript/-/engine-javascript-4.6.0.tgz", + "integrity": "sha512-K0oqxFoL+kEMdz89mHLFO15Tsbv3kFZ6WR1cXZKMvLSc+oqaM00A6pyga1qSeXB22dP0tTiSApRcGBaKWsEccg==", "dev": true, "license": "MIT", "dependencies": { - "@shikijs/types": "4.5.0", - "@shikijs/vscode-textmate": "^10.0.2", + "@shikijs/types": "4.6.0", + "@shikijs/vscode-textmate": "^10.1.0", "oniguruma-to-es": "^4.3.6" }, "engines": { @@ -1425,41 +1539,41 @@ } }, "node_modules/@shikijs/engine-oniguruma": { - "version": "4.5.0", - "resolved": "https://registry.npmjs.org/@shikijs/engine-oniguruma/-/engine-oniguruma-4.5.0.tgz", - "integrity": "sha512-dKVmbJecVdB9recl8a/CU4jdpNXyjJQrIcesIkpS70s5HS02ohpnCSpMUbotPnEUzbAcLQ+S4hwZYbkBBiTcJw==", + "version": "4.6.0", + "resolved": "https://registry.npmjs.org/@shikijs/engine-oniguruma/-/engine-oniguruma-4.6.0.tgz", + "integrity": "sha512-aggd6Q7SuJOXNnsUbfG2XesxBJKBMAw/PDTUo9PyRjMaaJJ2dNrI+q0C+25ARXAK9yLHAlwxc9oRT2u68YKZ7w==", "dev": true, "license": "MIT", "dependencies": { - "@shikijs/types": "4.5.0", - "@shikijs/vscode-textmate": "^10.0.2" + "@shikijs/types": "4.6.0", + "@shikijs/vscode-textmate": "^10.1.0" }, "engines": { "node": ">=20" } }, "node_modules/@shikijs/langs": { - "version": "4.5.0", - "resolved": "https://registry.npmjs.org/@shikijs/langs/-/langs-4.5.0.tgz", - "integrity": "sha512-wwBTqwduXSz0X4v9Qa2EWeFaYJEw1clCncWjoRNQRbVDu3SPRTRWucnouYapKj3b8Q+sk/41Vbc4B5c8nuYzLA==", + "version": "4.6.0", + "resolved": "https://registry.npmjs.org/@shikijs/langs/-/langs-4.6.0.tgz", + "integrity": "sha512-1yMEX3oCVV54LUq/ovfpRkDQoYDkcvjSWFFa/YLUDMiSoRzMi2uxLJYbv41ahT8Lu9lFMaa7hecd3Q39trqUyg==", "dev": true, "license": "MIT", "dependencies": { - "@shikijs/types": "4.5.0" + "@shikijs/types": "4.6.0" }, "engines": { "node": ">=20" } }, "node_modules/@shikijs/primitive": { - "version": "4.5.0", - "resolved": "https://registry.npmjs.org/@shikijs/primitive/-/primitive-4.5.0.tgz", - "integrity": "sha512-UM7ShlA8oz0OWxLLO8BmO9Ip6fVqdkt8yF0EH7nOCqHfrx1eEAzF0ZUVK7L+I8NEgeu1PEWSRlxaiPPeCb4iDg==", + "version": "4.6.0", + "resolved": "https://registry.npmjs.org/@shikijs/primitive/-/primitive-4.6.0.tgz", + "integrity": "sha512-c54+TQEo9ToqgfL/AU8FpjnV09+GA9Oa7M5ROkkXteZfp5XzpAJGXjjvZQFQioJOwm/w/6Z3lIzQstAkl8coag==", "dev": true, "license": "MIT", "dependencies": { - "@shikijs/types": "4.5.0", - "@shikijs/vscode-textmate": "^10.0.2", + "@shikijs/types": "4.6.0", + "@shikijs/vscode-textmate": "^10.1.0", "@types/hast": "^3.0.5" }, "engines": { @@ -1467,40 +1581,40 @@ } }, "node_modules/@shikijs/themes": { - "version": "4.5.0", - "resolved": "https://registry.npmjs.org/@shikijs/themes/-/themes-4.5.0.tgz", - "integrity": "sha512-zGb87H3UBbpuI4yoh5UguB1XbU+2BDU3kflM7UfZ+Cy2hWo9lBtqjSVK20gmLY6ukYl040hAypGXMgud9vul8Q==", + "version": "4.6.0", + "resolved": "https://registry.npmjs.org/@shikijs/themes/-/themes-4.6.0.tgz", + "integrity": "sha512-qHAVAs80RiGD+IRuH9G+JPDOEc9A/kHsng4EzCUCwB9bLzW6Z0y9WETh2YyCcADJBmfrIaJ1Jp7KBNP6FHkgtQ==", "dev": true, "license": "MIT", "dependencies": { - "@shikijs/types": "4.5.0" + "@shikijs/types": "4.6.0" }, "engines": { "node": ">=20" } }, "node_modules/@shikijs/transformers": { - "version": "4.5.0", - "resolved": "https://registry.npmjs.org/@shikijs/transformers/-/transformers-4.5.0.tgz", - "integrity": "sha512-LM7twi043qCC3gRyGQfjoC2/sowzbEltWuruyRtT3RlBlk1hKzWk9ETnU7RcDBoVWQBmC8Mebnr7p28W7kPoaA==", + "version": "4.6.0", + "resolved": "https://registry.npmjs.org/@shikijs/transformers/-/transformers-4.6.0.tgz", + "integrity": "sha512-oZ28gYlPOYspv6AD74lCb14AAJugSY/+nJxRWjH42yDbdLAdftVU/PP36tOhb435Sfop2UGWcRGXY7HLLveKCg==", "dev": true, "license": "MIT", "dependencies": { - "@shikijs/core": "4.5.0", - "@shikijs/types": "4.5.0" + "@shikijs/core": "4.6.0", + "@shikijs/types": "4.6.0" }, "engines": { "node": ">=20" } }, "node_modules/@shikijs/types": { - "version": "4.5.0", - "resolved": "https://registry.npmjs.org/@shikijs/types/-/types-4.5.0.tgz", - "integrity": "sha512-drtPrtD8N0DENyD2cyt6Ajy+IWsiCLgMxODwLTpvH1UsN6a9jf90tNTPjqwHvA+0Lzu9e0txk8DjfqH1p9UJRw==", + "version": "4.6.0", + "resolved": "https://registry.npmjs.org/@shikijs/types/-/types-4.6.0.tgz", + "integrity": "sha512-+ENG1adsKt/X7cRYw1Nl7BEpBmPOjmQ7bR/eGmHuMlT8gtOFf3KEi5l31DJYyAWhW6Y6bjP1plU7FmaxWGENFw==", "dev": true, "license": "MIT", "dependencies": { - "@shikijs/vscode-textmate": "^10.0.2", + "@shikijs/vscode-textmate": "^10.1.0", "@types/hast": "^3.0.5" }, "engines": { @@ -1508,12 +1622,23 @@ } }, "node_modules/@shikijs/vscode-textmate": { - "version": "10.0.2", - "resolved": "https://registry.npmjs.org/@shikijs/vscode-textmate/-/vscode-textmate-10.0.2.tgz", - "integrity": "sha512-83yeghZ2xxin3Nj8z1NMd/NCuca+gsYXswywDy5bHvwlWL8tpTQmzGeUuHd9FC3E/SBEMvzJRwWEOz5gGes9Qg==", + "version": "10.1.0", + "resolved": "https://registry.npmjs.org/@shikijs/vscode-textmate/-/vscode-textmate-10.1.0.tgz", + "integrity": "sha512-cVBuhDQjBZaNMTwBquYfPydrUP+E3hE6oYGasx8h6ZrODIM7/r+gxLDXdd66oszbrggZHEntdE6j+5gYIVyMWQ==", "dev": true, "license": "MIT" }, + "node_modules/@tybys/wasm-util": { + "version": "0.10.5", + "resolved": "https://registry.npmjs.org/@tybys/wasm-util/-/wasm-util-0.10.5.tgz", + "integrity": "sha512-dOGOPxlaNV+G046mZzN+9C0dAcQZeSKcXiVaM0TYy/LM4ttTmgSBDxYfovcYI8Em3+eAbiAYpvWLOv8+ZVRJKA==", + "dev": true, + "license": "MIT", + "optional": true, + "dependencies": { + "tslib": "^2.4.0" + } + }, "node_modules/@types/esrecurse": { "version": "4.3.1", "resolved": "https://registry.npmjs.org/@types/esrecurse/-/esrecurse-4.3.1.tgz", @@ -1522,9 +1647,9 @@ "license": "MIT" }, "node_modules/@types/estree": { - "version": "1.0.9", - "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.9.tgz", - "integrity": "sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==", + "version": "1.0.10", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.10.tgz", + "integrity": "sha512-lTyOMnOcmRBzdCv6/4zUZCrEhV0xrqQiUZBZtVcbmLHBXKLnN8q89v/wKRF/Q0HbwVsqbIG3o5HDoFl9sduM+g==", "dev": true, "license": "MIT" }, @@ -1581,13 +1706,13 @@ "license": "MIT" }, "node_modules/@types/node": { - "version": "24.13.6", - "resolved": "https://registry.npmjs.org/@types/node/-/node-24.13.6.tgz", - "integrity": "sha512-SGrw/h3KPFshy3OE6ZL53LMBG5vGQQ8/gIpiqz/kRZhPJ7HgwCEs8LBuNtWLa8dvGZVpSF7+Bf+c11HUrCb/yg==", + "version": "24.19.2", + "resolved": "https://registry.npmjs.org/@types/node/-/node-24.19.2.tgz", + "integrity": "sha512-93d49wCWJkCyN87MxLpNN6KXPCwFw7bVUg79mGUV1OS40JGWwVCr8n61DXCSqz7CV6/VfPkb7xec7uP2M+QHWQ==", "dev": true, "license": "MIT", "dependencies": { - "undici-types": "~7.18.0" + "undici-types": ">=7.24.0 <7.24.7" } }, "node_modules/@types/pg": { @@ -1654,17 +1779,17 @@ } }, "node_modules/@typescript-eslint/eslint-plugin": { - "version": "8.70.1", - "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.70.1.tgz", - "integrity": "sha512-nDNrUQ/4ruSNYbu749TRY7cfrzPtoLHEXSNBI8aaNY32LlZCajixqRf3FqcKC4p5Cam4VOHYx/t+i5+nKXvrqA==", + "version": "8.72.2", + "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.72.2.tgz", + "integrity": "sha512-222PKFXKihmFpi/pS5njoBgdAqsPhj2/GBmFbrNw8Tq8gEG9Sv+kSlKFy4u2q+mJv9ZzJgM2Gkv/bUzRZwZw5g==", "dev": true, "license": "MIT", "dependencies": { "@eslint-community/regexpp": "^4.12.2", - "@typescript-eslint/scope-manager": "8.70.1", - "@typescript-eslint/type-utils": "8.70.1", - "@typescript-eslint/utils": "8.70.1", - "@typescript-eslint/visitor-keys": "8.70.1", + "@typescript-eslint/scope-manager": "8.72.2", + "@typescript-eslint/type-utils": "8.72.2", + "@typescript-eslint/utils": "8.72.2", + "@typescript-eslint/visitor-keys": "8.72.2", "ignore": "^7.0.5", "natural-compare": "^1.4.0", "ts-api-utils": "^2.5.0" @@ -1677,23 +1802,22 @@ "url": "https://opencollective.com/typescript-eslint" }, "peerDependencies": { - "@typescript-eslint/parser": "^8.70.1", + "@typescript-eslint/parser": "^8.72.2", "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0", "typescript": ">=4.8.4 <6.1.0" } }, "node_modules/@typescript-eslint/parser": { - "version": "8.70.1", - "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.70.1.tgz", - "integrity": "sha512-nO974WLllwhSFWQXnMLj6nDGa8f0khKEz1JzpPJ1u7Vm/4X1X6ZHajpoknU4bb41vJyMB0HHVyS2GqdhWfIXZw==", + "version": "8.72.2", + "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.72.2.tgz", + "integrity": "sha512-llP+T1YuJOLlxEciP6OyQGtz5SMxyn+9LA2BvZw5RmToGVa1y4beEDVQL6Gje7T5WFYh19WREjDCN9Ev4gm5AA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { - "@typescript-eslint/scope-manager": "8.70.1", - "@typescript-eslint/types": "8.70.1", - "@typescript-eslint/typescript-estree": "8.70.1", - "@typescript-eslint/visitor-keys": "8.70.1", + "@typescript-eslint/scope-manager": "8.72.2", + "@typescript-eslint/types": "8.72.2", + "@typescript-eslint/typescript-estree": "8.72.2", + "@typescript-eslint/visitor-keys": "8.72.2", "debug": "^4.4.3" }, "engines": { @@ -1709,14 +1833,14 @@ } }, "node_modules/@typescript-eslint/project-service": { - "version": "8.70.1", - "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.70.1.tgz", - "integrity": "sha512-62xOgboPfwc3/IgPSX/W6oQR3ZbF04194FPGUGH8HL8iLFHbt/456/8Ph1wLNUgVF+s94FlHoipBsz+v7+LMnA==", + "version": "8.72.2", + "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.72.2.tgz", + "integrity": "sha512-6y5dLTZdHhI8Eh3yIQ/bfQhRKwn5e+TpJj64o18Cngc0iW/BCrVvrr6zGYqXPnYH31u6YXAYiFh0+qxX5mybJw==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/tsconfig-utils": "^8.70.1", - "@typescript-eslint/types": "^8.70.1", + "@typescript-eslint/tsconfig-utils": "^8.72.2", + "@typescript-eslint/types": "^8.72.2", "debug": "^4.4.3" }, "engines": { @@ -1731,14 +1855,14 @@ } }, "node_modules/@typescript-eslint/scope-manager": { - "version": "8.70.1", - "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.70.1.tgz", - "integrity": "sha512-Pa0EeSeAusQc1WbjQMac+YfenewYTBu0KjgYvkUKwhXaHUKbFog23Dm/rp0DX/6tyYOQ3Xl1a+3EcFNZynGHCw==", + "version": "8.72.2", + "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.72.2.tgz", + "integrity": "sha512-iIoMJ6/8c1/QpFNyFjU0d1YzPco4MsZjQw0k3V+vfzNWAFmUmvhlyMoYEoYYDQZXc+J6Gi1X5XcxlzW2taIIGQ==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/types": "8.70.1", - "@typescript-eslint/visitor-keys": "8.70.1" + "@typescript-eslint/types": "8.72.2", + "@typescript-eslint/visitor-keys": "8.72.2" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -1749,9 +1873,9 @@ } }, "node_modules/@typescript-eslint/tsconfig-utils": { - "version": "8.70.1", - "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.70.1.tgz", - "integrity": "sha512-jumze1fPI+sDOaM2TWGQdn39PDxTr7TZGeuyLkAbNyx2vtMT3uRnVKChN0hfht5V2TugphJzF6bYXvBcE09qqg==", + "version": "8.72.2", + "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.72.2.tgz", + "integrity": "sha512-+h3iCgZXuTNtoLXcnnjP12ZUHLMqoUcIHPfQrFEXTUqvb9dF8QK9b5nv5VtSo5fLkdHuks8ehbTzZj3rImAm9w==", "dev": true, "license": "MIT", "engines": { @@ -1766,15 +1890,15 @@ } }, "node_modules/@typescript-eslint/type-utils": { - "version": "8.70.1", - "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.70.1.tgz", - "integrity": "sha512-7zKTnyvaVWqzLZHPFQtX1hVHqgkMC+WebPWakNCSyrQVbIP1AM0L0TlBZtACldIRb6PptI8Odk+jyZ5kP3B1VA==", + "version": "8.72.2", + "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.72.2.tgz", + "integrity": "sha512-STfkR38qIdhfkLpgtXnUjAzsNy4xouqiBO0lrVc/Wpk9Kem5/aHXUx1J8dGC16zpdYN1+yc2ILQ28er1kXX7ag==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/types": "8.70.1", - "@typescript-eslint/typescript-estree": "8.70.1", - "@typescript-eslint/utils": "8.70.1", + "@typescript-eslint/types": "8.72.2", + "@typescript-eslint/typescript-estree": "8.72.2", + "@typescript-eslint/utils": "8.72.2", "debug": "^4.4.3", "ts-api-utils": "^2.5.0" }, @@ -1791,9 +1915,9 @@ } }, "node_modules/@typescript-eslint/types": { - "version": "8.70.1", - "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.70.1.tgz", - "integrity": "sha512-Dm1ypdhhrGCTyyehxElhgJ6kgk8MVCv5qXdoOVqPr1uqk42jX8KjrZqhROvdShczA8qrDoYiOWn1ykWlx2k81Q==", + "version": "8.72.2", + "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.72.2.tgz", + "integrity": "sha512-Xfn37OLZx03+PCU7qWx9DTv2FCRh1E6fk2+wONeNY15HXIwtcwuveaSwVpGAUptkNmPQegRxW5JyRel9T7wrog==", "dev": true, "license": "MIT", "engines": { @@ -1805,16 +1929,16 @@ } }, "node_modules/@typescript-eslint/typescript-estree": { - "version": "8.70.1", - "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.70.1.tgz", - "integrity": "sha512-TU8PwyGN0PQJUcE96mw8eCQ44SmxGdQlJmlWakHaHQ15eIuuvye5yNtmh/i6oS88jzXVQB71xdNkbkB/fMwL0g==", + "version": "8.72.2", + "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.72.2.tgz", + "integrity": "sha512-pQEGqIK/cqEvKivVWaFLYpe7XYejFxfuAOi4mu1oAWFvIo36aRHI9esRFTUxcIy/z8N482RJyH+LpZB0ZIU7Ow==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/project-service": "8.70.1", - "@typescript-eslint/tsconfig-utils": "8.70.1", - "@typescript-eslint/types": "8.70.1", - "@typescript-eslint/visitor-keys": "8.70.1", + "@typescript-eslint/project-service": "8.72.2", + "@typescript-eslint/tsconfig-utils": "8.72.2", + "@typescript-eslint/types": "8.72.2", + "@typescript-eslint/visitor-keys": "8.72.2", "debug": "^4.4.3", "minimatch": "^10.2.2", "semver": "^7.7.3", @@ -1833,16 +1957,16 @@ } }, "node_modules/@typescript-eslint/utils": { - "version": "8.70.1", - "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.70.1.tgz", - "integrity": "sha512-Esgul8MsnKnRLdYU2Eb2cRV9bS5HJYtKj1ByJnOzzG2M58DGdSUQ1jUuILxipqcpB2h9WLrbD5GijIWUjX/Tqw==", + "version": "8.72.2", + "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.72.2.tgz", + "integrity": "sha512-hv3eRYbpPbbpezuax1EfGrzpa3C4ySgNZkPUkLOWOAjU8HsOKowEDAr8C7nsNl1C+SBSKDpvno6VKHnlhvp9iA==", "dev": true, "license": "MIT", "dependencies": { "@eslint-community/eslint-utils": "^4.9.1", - "@typescript-eslint/scope-manager": "8.70.1", - "@typescript-eslint/types": "8.70.1", - "@typescript-eslint/typescript-estree": "8.70.1" + "@typescript-eslint/scope-manager": "8.72.2", + "@typescript-eslint/types": "8.72.2", + "@typescript-eslint/typescript-estree": "8.72.2" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -1857,13 +1981,13 @@ } }, "node_modules/@typescript-eslint/visitor-keys": { - "version": "8.70.1", - "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.70.1.tgz", - "integrity": "sha512-Vwj9lUIW5Xq3wQ9w6gv3R86g1hMK8f2zNOdGTAgeXUMMXFK78G9ruCjjqutHMNJc0+CH7LYRnHeUB9IT8wFmcw==", + "version": "8.72.2", + "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.72.2.tgz", + "integrity": "sha512-NAGrjn0Pitjqzq/GkgMC4kBYm233PQ8GffyQ9+kTA3AlNQYEzOf25EIM02BAHZv5FRJSpHpJk+OGUxVkOB93GQ==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/types": "8.70.1", + "@typescript-eslint/types": "8.72.2", "eslint-visitor-keys": "^5.0.0" }, "engines": { @@ -1882,9 +2006,9 @@ "license": "ISC" }, "node_modules/@vitejs/plugin-vue": { - "version": "6.0.9", - "resolved": "https://registry.npmjs.org/@vitejs/plugin-vue/-/plugin-vue-6.0.9.tgz", - "integrity": "sha512-rD/MORlhaZMlXWW0rEn4FB4wMinWC0z/D7Ye160S5+Rs1mC8ZDAdcDp4SjKfUhG5t8q1ktcPVw4xuTkPRlzrSA==", + "version": "6.0.11", + "resolved": "https://registry.npmjs.org/@vitejs/plugin-vue/-/plugin-vue-6.0.11.tgz", + "integrity": "sha512-m48lskIUJGlB6qUiYhDMI8nd2ngeidz2U4nKTjqI13cFMu5rH8JeEILPkDtK9Fk/TjBA2pkj8AlbenqDaKu+ww==", "dev": true, "license": "MIT", "dependencies": { @@ -1895,61 +2019,61 @@ }, "peerDependencies": { "vite": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0", - "vue": "^3.2.25" + "vue": "^3.2.25 || ^3.6.0-rc.15" } }, "node_modules/@vue/compiler-core": { - "version": "3.5.43", - "resolved": "https://registry.npmjs.org/@vue/compiler-core/-/compiler-core-3.5.43.tgz", - "integrity": "sha512-zdiLhnbe1QQqgDT8xZMpNmyqZ3qlI+/Q/FHQco57Kwl/b05HhCzN6eVGN9QU9rbga4CrS0H5SYY8VGHZCt/1Hg==", + "version": "3.5.45", + "resolved": "https://registry.npmjs.org/@vue/compiler-core/-/compiler-core-3.5.45.tgz", + "integrity": "sha512-XGHJrM6ufZARAc/w+tyOswStw9tdKiqCKBScI4gGaNxD+aaGu/HQWgKJ+JItjRLPqenQ7iE7G8AJC7T5ew1p+g==", "dev": true, "license": "MIT", "dependencies": { - "@babel/parser": "^7.29.8", - "@vue/shared": "3.5.43", + "@babel/parser": "^7.29.12", + "@vue/shared": "3.5.45", "entities": "^7.0.1", "estree-walker": "^2.0.2", - "source-map-js": "^1.2.1" + "source-map-js": "^1.2.2" } }, "node_modules/@vue/compiler-dom": { - "version": "3.5.43", - "resolved": "https://registry.npmjs.org/@vue/compiler-dom/-/compiler-dom-3.5.43.tgz", - "integrity": "sha512-PEZoAk3NQmsn/ejMzSOCyTYqwGqczrWm70PuhBKjjv1+TCoQAaO/zOqNwjV+honlNstT5ILxtc+8r8UUfj+iEQ==", + "version": "3.5.45", + "resolved": "https://registry.npmjs.org/@vue/compiler-dom/-/compiler-dom-3.5.45.tgz", + "integrity": "sha512-LbP2d19GSOYGPmvMBBCVJVlv7TKtjM1Cfeyu3cYia720pknZP+1cLX7H5MVatvruT6MuJhiPuNbQBW/MDn/EwA==", "dev": true, "license": "MIT", "dependencies": { - "@vue/compiler-core": "3.5.43", - "@vue/shared": "3.5.43" + "@vue/compiler-core": "3.5.45", + "@vue/shared": "3.5.45" } }, "node_modules/@vue/compiler-sfc": { - "version": "3.5.43", - "resolved": "https://registry.npmjs.org/@vue/compiler-sfc/-/compiler-sfc-3.5.43.tgz", - "integrity": "sha512-FCbrG3XNCRl+js3huuKx4IVHBLTvMkJhVepjbxSPu1gn4yWLaYtGNQdjJGZaMytXB6qb76qQDDmDSLy/vkmleQ==", + "version": "3.5.45", + "resolved": "https://registry.npmjs.org/@vue/compiler-sfc/-/compiler-sfc-3.5.45.tgz", + "integrity": "sha512-MKFjb2UX0M/l/jhfzqMLrI8VM4pfvFKG3pqFZkSZFHRLtNld/O4RtUPZFWSwhro/14qP88UQEkWzHxAZAQ0tsw==", "dev": true, "license": "MIT", "dependencies": { - "@babel/parser": "^7.29.8", - "@vue/compiler-core": "3.5.43", - "@vue/compiler-dom": "3.5.43", - "@vue/compiler-ssr": "3.5.43", - "@vue/shared": "3.5.43", + "@babel/parser": "^7.29.12", + "@vue/compiler-core": "3.5.45", + "@vue/compiler-dom": "3.5.45", + "@vue/compiler-ssr": "3.5.45", + "@vue/shared": "3.5.45", "estree-walker": "^2.0.2", "magic-string": "^0.30.21", - "postcss": "^8.5.28", - "source-map-js": "^1.2.1" + "postcss": "^8.5.32", + "source-map-js": "^1.2.2" } }, "node_modules/@vue/compiler-ssr": { - "version": "3.5.43", - "resolved": "https://registry.npmjs.org/@vue/compiler-ssr/-/compiler-ssr-3.5.43.tgz", - "integrity": "sha512-GF62orf7KiJX9RqrHNGrYBudsQGD0OhJ5nDs90O8UiDuS40+YMYomiXu6w6EuvtXuRDc3MSNis3EaaSKAVSWpg==", + "version": "3.5.45", + "resolved": "https://registry.npmjs.org/@vue/compiler-ssr/-/compiler-ssr-3.5.45.tgz", + "integrity": "sha512-RF5sbZOfYz5AK00tOJUn2PwFXR2fS1u2HVzI8D9VF9rGAFxuGBqg2bB1kJ3ZHMprqSltXnT9MZE1IsqjSM8oew==", "dev": true, "license": "MIT", "dependencies": { - "@vue/compiler-dom": "3.5.43", - "@vue/shared": "3.5.43" + "@vue/compiler-dom": "3.5.45", + "@vue/shared": "3.5.45" } }, "node_modules/@vue/devtools-api": { @@ -1983,68 +2107,71 @@ "license": "MIT" }, "node_modules/@vue/reactivity": { - "version": "3.5.43", - "resolved": "https://registry.npmjs.org/@vue/reactivity/-/reactivity-3.5.43.tgz", - "integrity": "sha512-G/c9GyOZNI2jVaaS6OX1EF1SSFSv7H0ERqNTl4+DTFMlZmB5eVAB53aLQNam/7NL2NPtaDD7RdVrzf8uJzMuOA==", + "version": "3.5.45", + "resolved": "https://registry.npmjs.org/@vue/reactivity/-/reactivity-3.5.45.tgz", + "integrity": "sha512-WqkyubNWpI4OYBOipSrjIssMdJO8K1i9Zts/Wm8Er10/0msOEwCyWWWvZnAI7WW3kQsTong6DJp8Cbb+vd4cPA==", "dev": true, "license": "MIT", "dependencies": { - "@vue/shared": "3.5.43" + "@vue/shared": "3.5.45" } }, "node_modules/@vue/runtime-core": { - "version": "3.5.43", - "resolved": "https://registry.npmjs.org/@vue/runtime-core/-/runtime-core-3.5.43.tgz", - "integrity": "sha512-hU6U6VnVhBGQDpvlnnDlIB8ZGJBiOcgk2lh/0InltHiz3D8oSkluvuvY+do1G2H3+udeKFsmaBlgVYP7gXQzEw==", + "version": "3.5.45", + "resolved": "https://registry.npmjs.org/@vue/runtime-core/-/runtime-core-3.5.45.tgz", + "integrity": "sha512-bzIO3+FABjpj85uIKSc+Qnj36/sxDNI3tcH9i6w6xKA1k6e0ejv0G0jMCfeJBvK3yGL5XbJ3DMZj+ClqyCHFYw==", "dev": true, "license": "MIT", "dependencies": { - "@vue/reactivity": "3.5.43", - "@vue/shared": "3.5.43" + "@vue/reactivity": "3.5.45", + "@vue/shared": "3.5.45" } }, "node_modules/@vue/runtime-dom": { - "version": "3.5.43", - "resolved": "https://registry.npmjs.org/@vue/runtime-dom/-/runtime-dom-3.5.43.tgz", - "integrity": "sha512-Bb2Jc0YjjJdMt1SJmb9b2L/IWd3I8lIT9x9eS/xvvP9CiVgna0ffua74xKRmt4/uSJ+0r4iN8ex1jrqkhQGWQw==", + "version": "3.5.45", + "resolved": "https://registry.npmjs.org/@vue/runtime-dom/-/runtime-dom-3.5.45.tgz", + "integrity": "sha512-ZvRTFMDgfqTDYWvJfoVpQTJx1RN5M6l7Pyd6wfdY2NaXzbPQVh9ezeQYFbNPP6bIcRVn2SqSSR25N/jSW69BFw==", "dev": true, "license": "MIT", "dependencies": { - "@vue/reactivity": "3.5.43", - "@vue/runtime-core": "3.5.43", - "@vue/shared": "3.5.43", + "@vue/reactivity": "3.5.45", + "@vue/runtime-core": "3.5.45", + "@vue/shared": "3.5.45", "csstype": "^3.2.3" } }, "node_modules/@vue/server-renderer": { - "version": "3.5.43", - "resolved": "https://registry.npmjs.org/@vue/server-renderer/-/server-renderer-3.5.43.tgz", - "integrity": "sha512-l2Ygjv9NehV94PSBxNWsAHC0j/eIIKbn92mBuWXAPGLnn6HfJ6MH5ubsd+Nk0YoZ5FRuxWI1P2VSoh+dbPQhCQ==", + "version": "3.5.45", + "resolved": "https://registry.npmjs.org/@vue/server-renderer/-/server-renderer-3.5.45.tgz", + "integrity": "sha512-1fNXUHhhsWf4EVL4XixbGBU5mKdiIXJAB82feHRTyPPo6ZUEYWIJuEeUl3mVV6QDBp50HJOX4obLhxYXlrjrzA==", "dev": true, "license": "MIT", "dependencies": { - "@vue/compiler-ssr": "3.5.43", - "@vue/runtime-dom": "3.5.43", - "@vue/shared": "3.5.43" + "@vue/compiler-ssr": "3.5.45", + "@vue/runtime-dom": "3.5.45", + "@vue/shared": "3.5.45" } }, "node_modules/@vue/shared": { - "version": "3.5.43", - "resolved": "https://registry.npmjs.org/@vue/shared/-/shared-3.5.43.tgz", - "integrity": "sha512-uksS7YGMR5NZyr4JNq0Rp+QyLns0ueaz20KwzIPW9R0LH1Vnt4E+XUM29PNseEbf1www2gOuhuDi5AKOIXag9Q==", + "version": "3.5.45", + "resolved": "https://registry.npmjs.org/@vue/shared/-/shared-3.5.45.tgz", + "integrity": "sha512-ue9fgHmVNPlP7iW3+cxoBX/Cnlw53dHlVSw0JKGY6z1lObg8pHoj928M2nzG4/yVsMZ3NaRZ2s2z61uC16NDwQ==", "dev": true, "license": "MIT" }, "node_modules/@vueuse/core": { - "version": "14.4.0", - "resolved": "https://registry.npmjs.org/@vueuse/core/-/core-14.4.0.tgz", - "integrity": "sha512-X4WHz1HlCzCBoYXesUkifzzWBAcZgXG8Fi5iNPQg/epdzOB3gu8Fawj3hvuwYR1nGcXGnvxwYYcUC/71++svtQ==", + "version": "15.0.0", + "resolved": "https://registry.npmjs.org/@vueuse/core/-/core-15.0.0.tgz", + "integrity": "sha512-Zv67h5mrk7YHDJsRObx+DXaCBz6RKBUpxqLesJ+3xZNPG6yuQs7ja7kg3veFrrouYLWAqydQ7CwGEbLVxB43Ng==", "dev": true, "license": "MIT", "dependencies": { "@types/web-bluetooth": "^0.0.21", - "@vueuse/metadata": "14.4.0", - "@vueuse/shared": "14.4.0" + "@vueuse/metadata": "15.0.0", + "@vueuse/shared": "15.0.0" + }, + "engines": { + "node": ">=22" }, "funding": { "url": "https://github.com/sponsors/antfu" @@ -2054,14 +2181,17 @@ } }, "node_modules/@vueuse/integrations": { - "version": "14.4.0", - "resolved": "https://registry.npmjs.org/@vueuse/integrations/-/integrations-14.4.0.tgz", - "integrity": "sha512-oJz9qTgczvA7L1nXQFRU7h8tQbOCoiceqvMMhT9XYMyOGTqLJ2rEa09PON+nD2t48sZUfeOmg4eaWJXV4sZb/w==", + "version": "15.0.0", + "resolved": "https://registry.npmjs.org/@vueuse/integrations/-/integrations-15.0.0.tgz", + "integrity": "sha512-uWC1608pEocJPeRk1IqrEA3uYHhAGTJNibcMAdxgdK2Sy2Hypc6b+VdNO9KekCxyPc4VXK8SKDp8vsXefR/ZFg==", "dev": true, "license": "MIT", "dependencies": { - "@vueuse/core": "14.4.0", - "@vueuse/shared": "14.4.0" + "@vueuse/core": "15.0.0", + "@vueuse/shared": "15.0.0" + }, + "engines": { + "node": ">=22" }, "funding": { "url": "https://github.com/sponsors/antfu" @@ -2070,7 +2200,7 @@ "async-validator": "^4", "axios": "^1", "change-case": "^5", - "drauu": "^0.4", + "drauu": "^1 || ^0.4", "focus-trap": "^7 || ^8", "fuse.js": "^7", "idb-keyval": "^6", @@ -2121,21 +2251,27 @@ } }, "node_modules/@vueuse/metadata": { - "version": "14.4.0", - "resolved": "https://registry.npmjs.org/@vueuse/metadata/-/metadata-14.4.0.tgz", - "integrity": "sha512-swx/255R6JyHZFJhx845iz5CRWDZdCfvkZOpACWc5+c5WHcG24mv8gUT1WIdFQaHt6dq79rvILd9QnCWiyVm9g==", + "version": "15.0.0", + "resolved": "https://registry.npmjs.org/@vueuse/metadata/-/metadata-15.0.0.tgz", + "integrity": "sha512-sfWE5LADAKJ0KnjtGliMdSN8Ij/L7uP6rXIZlgPloAI4zvvefbw6H5Lt7KJA6RqQOYgVqWF5Guj50HHMIzygBg==", "dev": true, "license": "MIT", + "engines": { + "node": ">=22" + }, "funding": { "url": "https://github.com/sponsors/antfu" } }, "node_modules/@vueuse/shared": { - "version": "14.4.0", - "resolved": "https://registry.npmjs.org/@vueuse/shared/-/shared-14.4.0.tgz", - "integrity": "sha512-JRgY90Sz8DDtPMsaDflvPMp9xYk69JZAmbuDvAquUVXKr2gEjqtzGNTTthLfckH0BzBqvnu31gb4a8TGLRe79g==", + "version": "15.0.0", + "resolved": "https://registry.npmjs.org/@vueuse/shared/-/shared-15.0.0.tgz", + "integrity": "sha512-vbNXhGrbV53xPOMSyOzMHQRvhMgZf7oNDw2RChUetVxwTIEkInQ1joZ9JbT0G3z2n2AJNjvmCWeM9ySYrnvogA==", "dev": true, "license": "MIT", + "engines": { + "node": ">=22" + }, "funding": { "url": "https://github.com/sponsors/antfu" }, @@ -2150,12 +2286,11 @@ "license": "MIT" }, "node_modules/acorn": { - "version": "8.18.0", - "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.18.0.tgz", - "integrity": "sha512-lGq+9yr1/GuAWaVYIHRjvvySG5/4VfKIvC8EWxStPdcDh/Ka7FG3twP6v4d5BkravUilhIAsG4Qj83t02LWUPQ==", + "version": "8.19.0", + "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.19.0.tgz", + "integrity": "sha512-oJlA3XiRm7Cyk6qFD2Jn8ak9B7jSy0qy00ADO3+8dpT0LSjFihQYv4C02LFCSYJV3Q37xYwwRy5m+IpIiUzqWw==", "dev": true, "license": "MIT", - "peer": true, "bin": { "acorn": "bin/acorn" }, @@ -2239,22 +2374,6 @@ } } }, - "node_modules/ajv/node_modules/fast-uri": { - "version": "3.1.9", - "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.9.tgz", - "integrity": "sha512-hS/0Wt3Ya043oKXs0sIxrMpKQITXhMLIrVAKKXi4gozGC9v7YRWVnXIZzjNPTO02M9BdxLCWqK1yRXgNziVyJQ==", - "funding": [ - { - "type": "github", - "url": "https://github.com/sponsors/fastify" - }, - { - "type": "opencollective", - "url": "https://opencollective.com/fastify" - } - ], - "license": "BSD-3-Clause" - }, "node_modules/ansi-styles": { "version": "4.3.0", "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", @@ -2290,9 +2409,9 @@ } }, "node_modules/avvio": { - "version": "9.3.0", - "resolved": "https://registry.npmjs.org/avvio/-/avvio-9.3.0.tgz", - "integrity": "sha512-g2tQ7LE7oOSqDfwEm3M+ZCMTJc7KiZCdJ4UwyZJb5ckTKyYu50OYmvv0mCFXPuYXoM4zkSt8zM9XQ9KCvxA74A==", + "version": "9.3.1", + "resolved": "https://registry.npmjs.org/avvio/-/avvio-9.3.1.tgz", + "integrity": "sha512-QyTKW61/qlba+cUQBm/sT9X8lri4UdomqSDwCnrnj1IvLVDRRiXRkz4CgBRWB+/cmfC7SK5WQc8T1vSdGvaUcQ==", "funding": [ { "type": "github", @@ -2339,9 +2458,9 @@ } }, "node_modules/brace-expansion": { - "version": "5.0.12", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.12.tgz", - "integrity": "sha512-YovQ3rzhaLMIrDjNDMkNS01tea93qhEhG5xy8f6+R0l+dw3Ki+5sCoIoI942iuLZTHWogWktgwVDhU09iNEimQ==", + "version": "5.0.13", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.13.tgz", + "integrity": "sha512-Vh3dmFbc4wZeox7M9I/0L9GfFd83Su4+yCck/OF9Gi/P/dAHn0RT7X4K9R7gMNMhDck3DvhR6QXsnQdjjgwNvQ==", "dev": true, "license": "MIT", "dependencies": { @@ -2476,12 +2595,12 @@ } }, "node_modules/cookie": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/cookie/-/cookie-1.1.1.tgz", - "integrity": "sha512-ei8Aos7ja0weRpFzJnEA9UHJ/7XQmqglbRwnf2ATjcB9Wq874VKH9kfjjirM6UhU2/E5fFYadylyhFldcqSidQ==", + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/cookie/-/cookie-2.0.2.tgz", + "integrity": "sha512-SL0cVuEdETEp7pN0FuZb01toc3vnODEfVUCooxG1SJN0yIirh7JMb9X9bvfCFf0vzzbT68RdbKDHYTiWy7a7iw==", "license": "MIT", "engines": { - "node": ">=18" + "node": ">=22" }, "funding": { "type": "opencollective", @@ -2550,28 +2669,28 @@ "license": "MIT" }, "node_modules/dependency-cruiser": { - "version": "18.4.0", - "resolved": "https://registry.npmjs.org/dependency-cruiser/-/dependency-cruiser-18.4.0.tgz", - "integrity": "sha512-LLBYQ2XYmOCMG+liUWI2ReRYnnFXIbnzvCGHTohXAViSkawXr3T35fF/FV2cxpmB661pfkJ3ZXn95jhcEQ9GqA==", + "version": "18.7.2", + "resolved": "https://registry.npmjs.org/dependency-cruiser/-/dependency-cruiser-18.7.2.tgz", + "integrity": "sha512-3Pkco0Kx3GI8tG6DTUDfl9RSZVOXMqD+lvili8m0qw2+zhGFcZMyPspUgb7Crqps1UkL23SFXslpj7a9hj11+A==", "dev": true, "license": "MIT", "dependencies": { - "acorn": "8.18.0", + "acorn": "8.19.0", "acorn-jsx": "5.3.2", "acorn-jsx-walk": "2.0.0", "acorn-loose": "8.5.2", "acorn-walk": "8.3.5", "commander": "15.0.0", - "enhanced-resolve": "5.25.1", - "ignore": "7.0.9", + "enhanced-resolve": "5.26.0", + "ignore": "7.0.14", "interpret": "3.1.1", - "is-installed-globally": "1.0.0", + "is-installed-globally": "1.0.1", "json5": "2.2.3", "picomatch": "4.0.7", "prompts": "2.4.2", "rechoir": "0.8.0", "safe-regex": "2.1.1", - "semver": "7.8.5", + "semver": "7.8.6", "tsconfig-paths-webpack-plugin": "4.2.0", "watskeburt": "6.0.0" }, @@ -2621,9 +2740,9 @@ } }, "node_modules/enhanced-resolve": { - "version": "5.25.1", - "resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.25.1.tgz", - "integrity": "sha512-nGXts5znJzmWPu+mIE9izCOzdg63oJca2mDzGWWTth7sr4aCToKcoyFVBQwN75Ij5Pf6p510EwkTqViTRzDV+w==", + "version": "5.26.0", + "resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.26.0.tgz", + "integrity": "sha512-9vhedylFonb2YGogzUKX6+Ja72gOJbN1QHAqdrvqLwhdl/QWbKopzoUC9EbQNVsAns/bx/4uyqalrQAoy1IByw==", "dev": true, "license": "MIT", "dependencies": { @@ -2664,7 +2783,6 @@ "dev": true, "hasInstallScript": true, "license": "MIT", - "peer": true, "bin": { "esbuild": "bin/esbuild" }, @@ -2714,23 +2832,22 @@ } }, "node_modules/eslint": { - "version": "10.11.0", - "resolved": "https://registry.npmjs.org/eslint/-/eslint-10.11.0.tgz", - "integrity": "sha512-P7a6UEEqb9G95MYAtqkmsTbVXIYyzIfl6NGOIJk162PaahFxFyeGcrlXYFSiagECg4sEm8IseJdZBKR3rx6MsQ==", + "version": "10.15.0", + "resolved": "https://registry.npmjs.org/eslint/-/eslint-10.15.0.tgz", + "integrity": "sha512-+5Wg4p+ze3sG1WErYgUO/3H1IQIfFBymVUA0Fo/XTeBOLS6UQIUekpSJ8sdRkn7O7wjh84b55w/roqavH2aScg==", "dev": true, "license": "MIT", - "peer": true, "workspaces": [ "packages/*" ], "dependencies": { "@eslint-community/eslint-utils": "^4.8.0", "@eslint-community/regexpp": "^4.12.2", - "@eslint/config-array": "^0.23.5", + "@eslint/config-array": "^0.23.6", "@eslint/config-helpers": "^0.7.0", "@eslint/core": "^1.2.1", "@eslint/plugin-kit": "^0.7.3", - "@humanfs/node": "^0.16.6", + "@humanfs/node": "^0.16.8", "@humanwhocodes/module-importer": "^1.0.1", "@humanwhocodes/retry": "^0.4.2", "@types/estree": "^1.0.6", @@ -2751,7 +2868,7 @@ "imurmurhash": "^0.1.4", "is-glob": "^4.0.0", "json-stable-stringify-without-jsonify": "^1.0.1", - "minimatch": "^10.2.5", + "minimatch": "^11.0.5", "natural-compare": "^1.4.0", "optionator": "^0.9.3" }, @@ -2930,9 +3047,9 @@ "license": "MIT" }, "node_modules/fast-json-stringify": { - "version": "7.0.1", - "resolved": "https://registry.npmjs.org/fast-json-stringify/-/fast-json-stringify-7.0.1.tgz", - "integrity": "sha512-eRSayARSbbwlBjpP4vnTTIRD5QPcIrmihPxDeN1DtKnHPg66UuJLx+8hlK1kaFdjvzyQ/dzALoi4vwAQ+T+iZA==", + "version": "7.3.6", + "resolved": "https://registry.npmjs.org/fast-json-stringify/-/fast-json-stringify-7.3.6.tgz", + "integrity": "sha512-hXCpiZTZGiER/Xree1Tb4PY1DREPUnlWTP5Df9hgtoDnUppulV7Km8lh1/NEBuqz4JnNGSXghnABudfZ/iwIzg==", "funding": [ { "type": "github", @@ -2953,6 +3070,22 @@ "rfdc": "^1.2.0" } }, + "node_modules/fast-json-stringify/node_modules/fast-uri": { + "version": "4.2.3", + "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-4.2.3.tgz", + "integrity": "sha512-I1PXwP5eAhlNlcdpjt9CgB59op2ZvZfxw+BkqGFVIUOgNpCVTcTqp3HhTX7brxj5vsip+nSY4nTvff+eIA76hg==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "BSD-3-Clause" + }, "node_modules/fast-levenshtein": { "version": "2.0.6", "resolved": "https://registry.npmjs.org/fast-levenshtein/-/fast-levenshtein-2.0.6.tgz", @@ -2970,9 +3103,9 @@ } }, "node_modules/fast-uri": { - "version": "4.2.3", - "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-4.2.3.tgz", - "integrity": "sha512-I1PXwP5eAhlNlcdpjt9CgB59op2ZvZfxw+BkqGFVIUOgNpCVTcTqp3HhTX7brxj5vsip+nSY4nTvff+eIA76hg==", + "version": "3.1.9", + "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.9.tgz", + "integrity": "sha512-hS/0Wt3Ya043oKXs0sIxrMpKQITXhMLIrVAKKXi4gozGC9v7YRWVnXIZzjNPTO02M9BdxLCWqK1yRXgNziVyJQ==", "funding": [ { "type": "github", @@ -2986,9 +3119,9 @@ "license": "BSD-3-Clause" }, "node_modules/fastify": { - "version": "5.12.6", - "resolved": "https://registry.npmjs.org/fastify/-/fastify-5.12.6.tgz", - "integrity": "sha512-XeErl1DDsxdbhE9RPRJ05iNnfMhHRHHewVNNAJXaGTOaCY4wHb6rEizphhgzBq5YQe4JyqQWPpGd+hLh2PXXJA==", + "version": "5.12.8", + "resolved": "https://registry.npmjs.org/fastify/-/fastify-5.12.8.tgz", + "integrity": "sha512-moP8exb2sCHLUbJkwp+I6C0padhy4D8lp0SdmzY7HhSdZuqm7O/u3o2aq7u8okaQ//33QDzj3G/u+FsSdB8Qzw==", "funding": [ { "type": "github", @@ -3008,7 +3141,7 @@ "abstract-logging": "^2.0.1", "avvio": "^9.0.0", "fast-json-stringify": "^7.0.0", - "find-my-way": "^9.6.0", + "find-my-way": "^9.10.0", "light-my-request": "^6.0.0", "pino": "^9.14.0 || ^10.1.0", "process-warning": "^5.1.0", @@ -3056,9 +3189,9 @@ } }, "node_modules/find-my-way": { - "version": "9.9.0", - "resolved": "https://registry.npmjs.org/find-my-way/-/find-my-way-9.9.0.tgz", - "integrity": "sha512-sJsgZ1sQH2UDuowPuMKg8az7Qc8F0jnj+SKkFWU/+T0xcFlgV5skgXOGUqmQzOdmW6ALA7AhJINWx3qFBkbLHA==", + "version": "9.10.1", + "resolved": "https://registry.npmjs.org/find-my-way/-/find-my-way-9.10.1.tgz", + "integrity": "sha512-UwbZdEdk59YXIGPW/rbDn/Ayr3mJ5fPH/HJeMPlK8Ez10aUin4iyRwgJvNTSkRfpZ2h8uLX0LbvZm/YUBUpymw==", "license": "MIT", "dependencies": { "fast-deep-equal": "^3.1.3", @@ -3106,14 +3239,13 @@ "license": "ISC" }, "node_modules/focus-trap": { - "version": "8.2.2", - "resolved": "https://registry.npmjs.org/focus-trap/-/focus-trap-8.2.2.tgz", - "integrity": "sha512-qV0g8hRYBqgACcFOH3f9wXc4zPKhr/0z9RI2a6ZijZ72EeBi4g8oBy8zAWuUR1TsMpOzwpUMFvjdasrC41Joug==", + "version": "8.2.5", + "resolved": "https://registry.npmjs.org/focus-trap/-/focus-trap-8.2.5.tgz", + "integrity": "sha512-VrqfyRXaHZ0EkhXlfyalszmhnSN9yjdYXwlwLSRoJrDJ0/eswY5J5Avj/Hcd/PrOHCMnsMhwx7+7+s1kmv9Asg==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { - "tabbable": "^6.5.0" + "tabbable": "^6.5.2" } }, "node_modules/fsevents": { @@ -3171,11 +3303,11 @@ } }, "node_modules/graceful-fs": { - "version": "4.2.11", - "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz", - "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==", + "version": "4.2.12", + "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.12.tgz", + "integrity": "sha512-iuyGF2E4oafQfPsRrG2wtY2ILupMhvtdrhzrxB+0VcjsPpSPttpfYdjnGFGsTi5MaJFjI1jOKHPQ6UTbTj9TAw==", "dev": true, - "license": "ISC" + "license": "BlueOak-1.0.0" }, "node_modules/has-flag": { "version": "4.0.0", @@ -3214,9 +3346,9 @@ } }, "node_modules/hast-util-to-html": { - "version": "9.0.5", - "resolved": "https://registry.npmjs.org/hast-util-to-html/-/hast-util-to-html-9.0.5.tgz", - "integrity": "sha512-OguPdidb+fbHQSU4Q4ZiLKnzWo8Wwsf5bZfbvu7//a9oTYoqD/fWpe96NuHkoS9h0ccGOTe0C4NGXdtS0iObOw==", + "version": "9.0.6", + "resolved": "https://registry.npmjs.org/hast-util-to-html/-/hast-util-to-html-9.0.6.tgz", + "integrity": "sha512-1SZUxCN3TtJAE7e2BQN2MBHsoZ1gnmi9GoCP5Di59CSWptIezSAW09yDZyVbanb78V9eCwrKqdQsjtfVTxYHWA==", "dev": true, "license": "MIT", "dependencies": { @@ -3277,9 +3409,9 @@ } }, "node_modules/ignore": { - "version": "7.0.9", - "resolved": "https://registry.npmjs.org/ignore/-/ignore-7.0.9.tgz", - "integrity": "sha512-brTTsvFRt5C1gGHtPst/281UjPD5t9fBqbgoMPlVWy11ZLTPfu7HxK4ZYqO9H7o/yC9rSTCI85EaQ4OoY12qYw==", + "version": "7.0.14", + "resolved": "https://registry.npmjs.org/ignore/-/ignore-7.0.14.tgz", + "integrity": "sha512-wCBiZ77u1tuWde6G/nfOtLaCTYcFDU5yCzARzK10y+rLhzYoL7a7yEemcopcc2Mzow7gZOIjnV2ym1NYmdiJOQ==", "dev": true, "license": "MIT", "engines": { @@ -3326,9 +3458,9 @@ } }, "node_modules/is-core-module": { - "version": "2.17.0", - "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.17.0.tgz", - "integrity": "sha512-J/vG0zBCbIKOQFfufSwyXdMrsohyJIUNkrnmo6WZGzoM7tr/lsbfW5b2BvisL6zsyMzK9UxV9L6c7AoFbyXHOA==", + "version": "2.18.0", + "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.18.0.tgz", + "integrity": "sha512-qyax9fgaKOEC4qK8WZn7Q4IcoZC9RC1O1fFxRcRTq/oMMkWT/uXpqpXa12kzWR409zAt1drYN9N9BO26UmBCmw==", "dev": true, "license": "MIT", "dependencies": { @@ -3365,9 +3497,9 @@ } }, "node_modules/is-installed-globally": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/is-installed-globally/-/is-installed-globally-1.0.0.tgz", - "integrity": "sha512-K55T22lfpQ63N4KEN57jZUAaAYqYHEe8veb/TycJRk9DdSCLLcovXz/mL6mOnhQaZsQGwPhuFopdQIlqGSEjiQ==", + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/is-installed-globally/-/is-installed-globally-1.0.1.tgz", + "integrity": "sha512-li88H4QGRoNMX27jEmY8nR515oJVspAgC/WFMlhHfFV8RJ4QyGpHhXnwAe9gH5RIgKmdYRUmrOhQobcgEjIdSw==", "dev": true, "license": "MIT", "dependencies": { @@ -3402,9 +3534,9 @@ "license": "ISC" }, "node_modules/json-schema-ref-resolver": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/json-schema-ref-resolver/-/json-schema-ref-resolver-3.0.0.tgz", - "integrity": "sha512-hOrZIVL5jyYFjzk7+y7n5JDzGlU8rfWDuYyHwGa2WA8/pcmMHezp2xsVwxrebD/Q9t8Nc5DboieySDpCp4WG4A==", + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/json-schema-ref-resolver/-/json-schema-ref-resolver-3.0.1.tgz", + "integrity": "sha512-w+HwgljXpVwZ3IidoUR1qPZxSOQ+NRQWuVe6a5pe8XbHsNZE4UAwVPUvzZagn7yBKbJtt6UJnRFYbNTRPZI45Q==", "funding": [ { "type": "github", @@ -3452,7 +3584,6 @@ "integrity": "sha512-CYDD3SOtsHtyXeEORYRx2qBtpDJFjRTGXUtmNEMGyzYOKj1TE3tycdlho7kA1Ufx9OYWZzg52QFBGALTirzDSw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@keyv/serialize": "^1.1.1" } @@ -3482,9 +3613,9 @@ } }, "node_modules/light-my-request": { - "version": "6.6.0", - "resolved": "https://registry.npmjs.org/light-my-request/-/light-my-request-6.6.0.tgz", - "integrity": "sha512-CHYbu8RtboSIoVsHZ6Ye4cj4Aw/yg2oAFimlF7mNvfDV192LR7nDiKtSIfCuLT7KokPSTn/9kfVLm5OGN0A28A==", + "version": "6.8.1", + "resolved": "https://registry.npmjs.org/light-my-request/-/light-my-request-6.8.1.tgz", + "integrity": "sha512-20biUK0HAIPG9BZOK3/4s8uVAkAoi1+qW55lciHZCR0puTWipBgyMPEUjqXDWLjsZeqfO6DGsuwW5eyfsTGtyg==", "funding": [ { "type": "github", @@ -3497,27 +3628,12 @@ ], "license": "BSD-3-Clause", "dependencies": { - "cookie": "^1.0.1", - "process-warning": "^4.0.0", - "set-cookie-parser": "^2.6.0" + "@fastify/deepmerge": "^3.1.0", + "cookie": "^2.0.0", + "process-warning": "^5.0.0", + "set-cookie-parser": "^3.0.1" } }, - "node_modules/light-my-request/node_modules/process-warning": { - "version": "4.0.1", - "resolved": "https://registry.npmjs.org/process-warning/-/process-warning-4.0.1.tgz", - "integrity": "sha512-3c2LzQ3rY9d0hc1emcsHhfT9Jwz0cChib/QN89oME2R451w5fy3f0afAhERFZAwrbDU43wk12d0ORBpDVME50Q==", - "funding": [ - { - "type": "github", - "url": "https://github.com/sponsors/fastify" - }, - { - "type": "opencollective", - "url": "https://opencollective.com/fastify" - } - ], - "license": "MIT" - }, "node_modules/lightningcss": { "version": "1.33.0", "resolved": "https://registry.npmjs.org/lightningcss/-/lightningcss-1.33.0.tgz", @@ -3813,9 +3929,9 @@ "license": "MIT" }, "node_modules/mdast-util-to-hast": { - "version": "13.2.1", - "resolved": "https://registry.npmjs.org/mdast-util-to-hast/-/mdast-util-to-hast-13.2.1.tgz", - "integrity": "sha512-cctsq2wp5vTsLIcaymblUriiTcZd0CwWtCbLvrOzYCDZoWyMNV8sZ7krj09FSnsiJi3WVsHLM4k6Dq/yaPyCXA==", + "version": "13.2.2", + "resolved": "https://registry.npmjs.org/mdast-util-to-hast/-/mdast-util-to-hast-13.2.2.tgz", + "integrity": "sha512-l2pnmOuqs+SGLVpTVXnRLQu5v1AzvDe181404fbXzzqObVxrAnnVxapAP27pUwzLBL/ABIkgUhGlPVU7QSvIFg==", "dev": true, "license": "MIT", "dependencies": { @@ -3929,16 +4045,17 @@ "license": "MIT" }, "node_modules/minimatch": { - "version": "10.2.6", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.6.tgz", - "integrity": "sha512-vpLQEs+VLCr1nU0BXS07maYoFwlDAH0gngQuuttxIwutDFEMHq2blX+8vpgxDdK3J1PwjCJiep77OitTZ4Ll1A==", + "version": "11.0.8", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-11.0.8.tgz", + "integrity": "sha512-nFQuYSTVrGvysVBps5Ih+0BdnYFN/Cj3C816r6+p7yK+FHrVLGE4O4N9AFwykrlNlvM2HYt+Rad1Uiro6h88Ig==", "dev": true, "license": "BlueOak-1.0.0", "dependencies": { - "brace-expansion": "^5.0.8" + "@isaacs/nonrecursive-glob-match": "^1.1.0", + "brace-expansion": "^5.0.12" }, "engines": { - "node": "18 || 20 || >=22" + "node": "20 || >=22" }, "funding": { "url": "https://github.com/sponsors/isaacs" @@ -3969,9 +4086,9 @@ "license": "MIT" }, "node_modules/nan": { - "version": "2.29.0", - "resolved": "https://registry.npmjs.org/nan/-/nan-2.29.0.tgz", - "integrity": "sha512-GlGk3HIvitbvs+LT3g6XUP1kpirKNvmDFwF/bmo6XNWSb/eYEs/O4bfgIEIXCZ+lIOTS5xNwDvSGMw6FJdAhtA==", + "version": "2.30.0", + "resolved": "https://registry.npmjs.org/nan/-/nan-2.30.0.tgz", + "integrity": "sha512-P5mokDkSvCGBz6mZDD/2l+w9QoICRXdCyZ9ONGmTePr40oihJg3Kpn0YU3twKd6PJnwSlLBWNQeOT6yWEV2c4A==", "license": "MIT", "optional": true }, @@ -4120,15 +4237,14 @@ "license": "MIT" }, "node_modules/pg": { - "version": "8.23.0", - "resolved": "https://registry.npmjs.org/pg/-/pg-8.23.0.tgz", - "integrity": "sha512-Ip2EQCngowJLGOfCwkFhPXU7/ljlhn6Rxlmy4XYfL2Y+vyRM59+8uR2xqRWKdYmbXmxCFOAmKxBuSUCdF34qLg==", + "version": "8.23.1", + "resolved": "https://registry.npmjs.org/pg/-/pg-8.23.1.tgz", + "integrity": "sha512-aL96AHANtWjPLDOLqnhx+ngp9+UK7ETEU8VJrDCGvsSSi/mGLcWYsS6Herg7lmaBJe4uwrfqsa7gTEFaSizDoQ==", "license": "MIT", - "peer": true, "dependencies": { - "pg-connection-string": "^2.14.0", + "pg-connection-string": "^2.14.1", "pg-pool": "^3.14.0", - "pg-protocol": "^1.16.0", + "pg-protocol": "^1.16.1", "pg-types": "2.2.0", "pgpass": "1.0.5" }, @@ -4136,7 +4252,7 @@ "node": ">= 16.0.0" }, "optionalDependencies": { - "pg-cloudflare": "^1.4.0" + "pg-cloudflare": "^1.4.1" }, "peerDependencies": { "pg-native": ">=3.0.1" @@ -4148,16 +4264,16 @@ } }, "node_modules/pg-cloudflare": { - "version": "1.4.0", - "resolved": "https://registry.npmjs.org/pg-cloudflare/-/pg-cloudflare-1.4.0.tgz", - "integrity": "sha512-Vo7z/6rrQYxpNRylp4Tlob2elzbh+N/MOQbxFVWCxS7oEx6jF53GTJFxK2WWpKuBRkmiin4Mt+xofFDjx09R0A==", + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/pg-cloudflare/-/pg-cloudflare-1.4.1.tgz", + "integrity": "sha512-6PQbsFWZcp9EmJEwy5cGQ2La+AMWpP46lgbb8X+U/XsHIUweYDNCpeuKck5RxL2MdVFi7krbbEi5nX4Zh7JhrQ==", "license": "MIT", "optional": true }, "node_modules/pg-connection-string": { - "version": "2.14.0", - "resolved": "https://registry.npmjs.org/pg-connection-string/-/pg-connection-string-2.14.0.tgz", - "integrity": "sha512-XwWDGcLRGCXAR8F/AM5bG7Q+A3Wm2s6QeEjlOKZLlH3UYcguiqCWKyWXVag5TLTIjR7oOJUY8kcADaZgWPyLeg==", + "version": "2.14.1", + "resolved": "https://registry.npmjs.org/pg-connection-string/-/pg-connection-string-2.14.1.tgz", + "integrity": "sha512-qR3kGNPBLpCNtz0evbKA0Y/MRFXwSSdT+pTJvYp/bXTcReZbvX1kzF0IyTc1QnxqF7AZbOeBhNL8R5mYQZV/MA==", "license": "MIT" }, "node_modules/pg-int8": { @@ -4179,9 +4295,9 @@ } }, "node_modules/pg-protocol": { - "version": "1.16.0", - "resolved": "https://registry.npmjs.org/pg-protocol/-/pg-protocol-1.16.0.tgz", - "integrity": "sha512-sILXutLVjCLjcDuOmvhX5e2Z4cS5qG/6Bu3VkpFwdf/633ElGLpEh9bgmuI5I4sqKqkifQiGyiCcx1HdtrK7tg==", + "version": "1.16.1", + "resolved": "https://registry.npmjs.org/pg-protocol/-/pg-protocol-1.16.1.tgz", + "integrity": "sha512-p9VOFMiHB/ZbJATetbg+99PxssTVSQRnyuPSQ67mN1+1KBOjZaZ83ZQzltnxPhJwSsC3nwVjJ10DVJlerbFzLg==", "license": "MIT" }, "node_modules/pg-types": { @@ -4230,9 +4346,9 @@ } }, "node_modules/pino": { - "version": "10.3.1", - "resolved": "https://registry.npmjs.org/pino/-/pino-10.3.1.tgz", - "integrity": "sha512-r34yH/GlQpKZbU1BvFFqOjhISRo1MNx1tWYsYvmj6KIRHSPMT2+yHOEb1SG6NMvRoHRF0a07kCOox/9yakl1vg==", + "version": "10.4.0", + "resolved": "https://registry.npmjs.org/pino/-/pino-10.4.0.tgz", + "integrity": "sha512-bk1ZMTwG/Vymx+zPoa28MhNzucFvXJWp3csrSuxuHPSMeUettaCoQ5Jvg07mtC4JGNpcfTwz41oVCnNgBK9+vA==", "license": "MIT", "dependencies": { "@pinojs/redact": "^0.4.0", @@ -4242,7 +4358,7 @@ "pino-std-serializers": "^7.0.0", "process-warning": "^5.0.0", "quick-format-unescaped": "^4.0.3", - "real-require": "^0.2.0", + "real-require": "^1.0.0", "safe-stable-stringify": "^2.3.1", "sonic-boom": "^4.0.1", "thread-stream": "^4.0.0" @@ -4267,13 +4383,13 @@ "license": "MIT" }, "node_modules/playwright": { - "version": "1.63.0", - "resolved": "https://registry.npmjs.org/playwright/-/playwright-1.63.0.tgz", - "integrity": "sha512-+7ziBLidS4NaNCdt57SUDT+wYmmd5fmiQejUic/kb+YsYSCPyOOE9sebzMjNmQrsnNpDJqd4WHvV/8lfKfUDUg==", + "version": "1.65.1", + "resolved": "https://registry.npmjs.org/playwright/-/playwright-1.65.1.tgz", + "integrity": "sha512-vJ1FuoOrNwOKHUIVEvSt3jT1L+wjjDpwhwIstKtfvTh8XIG4FG4bIFuvNdMxi81LGfAhUgUZleVFaOLY4RIUUw==", "dev": true, "license": "Apache-2.0", "dependencies": { - "playwright-core": "1.63.0" + "playwright-core": "1.65.1" }, "bin": { "playwright": "cli.js" @@ -4283,9 +4399,9 @@ } }, "node_modules/playwright-core": { - "version": "1.63.0", - "resolved": "https://registry.npmjs.org/playwright-core/-/playwright-core-1.63.0.tgz", - "integrity": "sha512-rYCsBF/M5HjUch52bbtVONEFjv6Xu8sm8h72dNlR5bzIE1fvC/bxgspzkjSfU+MweEMmPM8KJebG6nnyxo5mCg==", + "version": "1.65.1", + "resolved": "https://registry.npmjs.org/playwright-core/-/playwright-core-1.65.1.tgz", + "integrity": "sha512-hqPpz7blSMPxWVdoeE1yiBSzXsKiVOd2k+kjCvmUywD2GPO2Dd9HfcWnq9NN0GHbNZDFgZ9JfBFr+X5/BLo0qw==", "dev": true, "license": "Apache-2.0", "bin": { @@ -4296,9 +4412,9 @@ } }, "node_modules/postcss": { - "version": "8.5.31", - "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.31.tgz", - "integrity": "sha512-YUbWYCgErwnMAVkjUnYa+KlMBzGpHwiIt/DE7f0G33AuX2LH9UcTk6KgWxd3zRU+pN3u/C+Xl3EnMLM4Hea7Sg==", + "version": "8.5.33", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.33.tgz", + "integrity": "sha512-RVHEU9/Pp1Fnjr/MpAJsZoADukCKhfIi15OunEYiGktIkYLkPVvC1sioWolGDS7XByMTx9m/IGbro0Js13zhnQ==", "dev": true, "funding": [ { @@ -4374,9 +4490,9 @@ } }, "node_modules/prettier": { - "version": "3.9.8", - "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.9.8.tgz", - "integrity": "sha512-WRFq3Wn3WId7LLROfMLdH7xaFr2jR62wU8nLO6rQUOLOxNZUviyJQs1M0iIhLexSFy+L+w0ch66wtoO2jRjG0A==", + "version": "3.10.1", + "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.10.1.tgz", + "integrity": "sha512-70vp3ZUYoPlFbF9uiTdXHUUCGEIp7d4+6p+8DYbkm2jP7x/3i/paXVF6dopSI3zd/CEitrZN1rc4i85xWmmXlg==", "dev": true, "license": "MIT", "bin": { @@ -4390,9 +4506,9 @@ } }, "node_modules/process-warning": { - "version": "5.1.0", - "resolved": "https://registry.npmjs.org/process-warning/-/process-warning-5.1.0.tgz", - "integrity": "sha512-jQSaVHsPgtyw60e1rQ/A+/ArPEj/S8pS/vFnyGa/gYFXrKk/6RuDkoqVDQ5NI5MmS01698ltlAk0NoDBNLujRw==", + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/process-warning/-/process-warning-5.1.1.tgz", + "integrity": "sha512-oCkNVj4OKnKEcocVBcDfiIugN1/cE6rgfT3nCtzeqZPA8+rIxMaQ0xXzIkGP8Gj2qUaP1UR7uhJ1VD8lUCpzCg==", "funding": [ { "type": "github", @@ -4467,13 +4583,10 @@ "license": "MIT" }, "node_modules/real-require": { - "version": "0.2.0", - "resolved": "https://registry.npmjs.org/real-require/-/real-require-0.2.0.tgz", - "integrity": "sha512-57frrGM/OCTLqLOAh0mhVA9VBMHd+9U7Zb2THMGdBUoZVOtGbJzjxsYGDJ3A9AYYCP4hn6y1TVbaOfzWtm5GFg==", - "license": "MIT", - "engines": { - "node": ">= 12.13.0" - } + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/real-require/-/real-require-1.0.0.tgz", + "integrity": "sha512-P4nbQYQfePJxRSmY+v/KINxVucm4NF3p3s7pJveMTtom52FR4YGltUQLB8idDXwDDWW+eYrWDFbuzUnjoWHF7g==", + "license": "MIT" }, "node_modules/rechoir": { "version": "0.8.0", @@ -4535,14 +4648,14 @@ } }, "node_modules/resolve": { - "version": "1.22.12", - "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.12.tgz", - "integrity": "sha512-TyeJ1zif53BPfHootBGwPRYT1RUt6oGWsaQr8UyZW/eAm9bKoijtvruSDEmZHm92CwS9nj7/fWttqPCgzep8CA==", + "version": "1.22.14", + "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.14.tgz", + "integrity": "sha512-1ZjYvR9sbkiwC5+9QHetqW5HmA2pHRMaoupD01t2HlYnV/vydC2zPwLixhsMieSWVZt0JJRg5LVIk0Ow1D/TrA==", "dev": true, "license": "MIT", "dependencies": { "es-errors": "^1.3.0", - "is-core-module": "^2.16.1", + "is-core-module": "^2.18.0", "path-parse": "^1.0.7", "supports-preserve-symlinks-flag": "^1.0.0" }, @@ -4557,9 +4670,9 @@ } }, "node_modules/ret": { - "version": "0.5.0", - "resolved": "https://registry.npmjs.org/ret/-/ret-0.5.0.tgz", - "integrity": "sha512-I1XxrZSQ+oErkRR4jYbAyEEu2I0avBvvMM5JN+6EBprOGRCs63ENqZ3vjavq8fBw2+62G5LF5XelKwuJpcvcxw==", + "version": "0.5.1", + "resolved": "https://registry.npmjs.org/ret/-/ret-0.5.1.tgz", + "integrity": "sha512-Z/nyvABwcRnRD2mMP7Kz6G1dFZZqX1mNErOnxF42OCQKE07b9k9hK9SQxHL3LFEZUdzQaLM4dId1E/E6Vm4WhA==", "license": "MIT", "engines": { "node": ">=10" @@ -4582,13 +4695,13 @@ "license": "MIT" }, "node_modules/rolldown": { - "version": "1.2.14", - "resolved": "https://registry.npmjs.org/rolldown/-/rolldown-1.2.14.tgz", - "integrity": "sha512-eTBTTqMR6uHKLgcUqpJP8ntzDI6V4LYA8negAMBEI7gkgVvOdrx6VsvS2Ym+83KhOPdLCHWJu0w7UQFJZhHKNw==", + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/rolldown/-/rolldown-1.2.19.tgz", + "integrity": "sha512-QIiV1J9d0pzN4jeeTH4sjPy0AZ6cAy2cG0ExeoE1+U8Rvj+hR3gYkokx0YbeUNGlZqiQJJ2utcETe0oKXwzsuA==", "dev": true, "license": "MIT", "dependencies": { - "@oxc-project/types": "=0.154.0", + "@oxc-project/types": "=0.156.0", "@rolldown/pluginutils": "^1.0.0" }, "bin": { @@ -4598,21 +4711,22 @@ "node": "^20.19.0 || >=22.12.0" }, "optionalDependencies": { - "@rolldown/binding-android-arm-eabi": "1.2.14", - "@rolldown/binding-android-arm64": "1.2.14", - "@rolldown/binding-darwin-arm64": "1.2.14", - "@rolldown/binding-darwin-x64": "1.2.14", - "@rolldown/binding-freebsd-x64": "1.2.14", - "@rolldown/binding-linux-arm-gnueabihf": "1.2.14", - "@rolldown/binding-linux-arm64-gnu": "1.2.14", - "@rolldown/binding-linux-arm64-musl": "1.2.14", - "@rolldown/binding-linux-ppc64-gnu": "1.2.14", - "@rolldown/binding-linux-s390x-gnu": "1.2.14", - "@rolldown/binding-linux-x64-gnu": "1.2.14", - "@rolldown/binding-linux-x64-musl": "1.2.14", - "@rolldown/binding-openharmony-arm64": "1.2.14", - "@rolldown/binding-win32-arm64-msvc": "1.2.14", - "@rolldown/binding-win32-x64-msvc": "1.2.14" + "@rolldown/binding-android-arm-eabi": "1.2.19", + "@rolldown/binding-android-arm64": "1.2.19", + "@rolldown/binding-darwin-arm64": "1.2.19", + "@rolldown/binding-darwin-x64": "1.2.19", + "@rolldown/binding-freebsd-x64": "1.2.19", + "@rolldown/binding-linux-arm-gnueabihf": "1.2.19", + "@rolldown/binding-linux-arm64-gnu": "1.2.19", + "@rolldown/binding-linux-arm64-musl": "1.2.19", + "@rolldown/binding-linux-ppc64-gnu": "1.2.19", + "@rolldown/binding-linux-s390x-gnu": "1.2.19", + "@rolldown/binding-linux-x64-gnu": "1.2.19", + "@rolldown/binding-linux-x64-musl": "1.2.19", + "@rolldown/binding-openharmony-arm64": "1.2.19", + "@rolldown/binding-wasm32-wasi": "1.2.19", + "@rolldown/binding-win32-arm64-msvc": "1.2.19", + "@rolldown/binding-win32-x64-msvc": "1.2.19" } }, "node_modules/safe-regex": { @@ -4626,9 +4740,9 @@ } }, "node_modules/safe-regex2": { - "version": "5.1.1", - "resolved": "https://registry.npmjs.org/safe-regex2/-/safe-regex2-5.1.1.tgz", - "integrity": "sha512-mOSBvHGDZMuIEZMdOz/aCEYDCv0E7nfcNsIhUF+/P+xC7Hyf3FkvymqgPbg9D1EdSGu+uKbJgy09K/RKKc7kJA==", + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/safe-regex2/-/safe-regex2-5.1.2.tgz", + "integrity": "sha512-tAtCGFPPP02VroDVzp4daGi6bC7jWG+41D47GKf18FeH/ubvKQHT9VmhAkvtjNOmJwqtApzWeUpEhkyEYULvmw==", "funding": [ { "type": "github", @@ -4663,9 +4777,9 @@ "license": "MIT" }, "node_modules/secure-json-parse": { - "version": "4.1.0", - "resolved": "https://registry.npmjs.org/secure-json-parse/-/secure-json-parse-4.1.0.tgz", - "integrity": "sha512-l4KnYfEyqYJxDwlNVyRfO2E4NTHfMKAWdUuA8J0yve2Dz/E/PdBepY03RvyJpssIpRFwJoCD55wA+mEDs6ByWA==", + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/secure-json-parse/-/secure-json-parse-4.1.1.tgz", + "integrity": "sha512-lnd81MQEZKjhW/Gd2TQqdd4XP6QYNdDW/EP+I7nTrFHP9y2LmaGPIHk9xsnzcOiEr1c39c/e84xFgGviQKBTRw==", "funding": [ { "type": "github", @@ -4679,9 +4793,9 @@ "license": "BSD-3-Clause" }, "node_modules/semver": { - "version": "7.8.5", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.5.tgz", - "integrity": "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==", + "version": "7.8.6", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.6.tgz", + "integrity": "sha512-9lpSSU4Mly3mrtruwLs1eLK6+gzbzqeBFwRNjIjE+9LuDpWdYctrQlQ3ej1Ilgi7gknpsTRnPoLP8DpCHqHIJw==", "license": "ISC", "bin": { "semver": "bin/semver.js" @@ -4691,9 +4805,9 @@ } }, "node_modules/set-cookie-parser": { - "version": "2.7.2", - "resolved": "https://registry.npmjs.org/set-cookie-parser/-/set-cookie-parser-2.7.2.tgz", - "integrity": "sha512-oeM1lpU/UvhTxw+g3cIfxXHyJRc/uidd3yK1P242gzHds0udQBYzs3y8j4gCCW+ZJ7ad0yctld8RYO+bdurlvw==", + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/set-cookie-parser/-/set-cookie-parser-3.2.2.tgz", + "integrity": "sha512-df017qMeYuXo4emL09nlyMpi2i2MtEIKS/6jtXH3vmjFgIRsOi852/5RmhJ4EkvN3ZF8jXadM/EkTPXgc8yPIw==", "license": "MIT" }, "node_modules/shebang-command": { @@ -4720,19 +4834,19 @@ } }, "node_modules/shiki": { - "version": "4.5.0", - "resolved": "https://registry.npmjs.org/shiki/-/shiki-4.5.0.tgz", - "integrity": "sha512-OcRW72ngQvc+MSVWBRIovC/BTW589iUE/Vxav7VeM4RcY9MUjqB+IR6ILG1k9nuW6LiG/nct9uma4/MBtnZbmQ==", + "version": "4.6.0", + "resolved": "https://registry.npmjs.org/shiki/-/shiki-4.6.0.tgz", + "integrity": "sha512-imjLsVHgPuWhvpU3P+zOekvMYqnel7QmKsFC4Sn0fCuAvaaalBsxwKEsrU8Ko5BdFnZA6Go/8a0RzahS634UgA==", "dev": true, "license": "MIT", "dependencies": { - "@shikijs/core": "4.5.0", - "@shikijs/engine-javascript": "4.5.0", - "@shikijs/engine-oniguruma": "4.5.0", - "@shikijs/langs": "4.5.0", - "@shikijs/themes": "4.5.0", - "@shikijs/types": "4.5.0", - "@shikijs/vscode-textmate": "^10.0.2", + "@shikijs/core": "4.6.0", + "@shikijs/engine-javascript": "4.6.0", + "@shikijs/engine-oniguruma": "4.6.0", + "@shikijs/langs": "4.6.0", + "@shikijs/themes": "4.6.0", + "@shikijs/types": "4.6.0", + "@shikijs/vscode-textmate": "^10.1.0", "@types/hast": "^3.0.5" }, "engines": { @@ -4854,16 +4968,16 @@ } }, "node_modules/tabbable": { - "version": "6.5.0", - "resolved": "https://registry.npmjs.org/tabbable/-/tabbable-6.5.0.tgz", - "integrity": "sha512-wieBHXygIm7OyQOu5hQlkk62/WyCFYGlWg7L6/ZCUZwx0o398Zkn4pVmMyfYhfMG8kGrj/Krt8eIk6UKC6VzwA==", + "version": "6.5.2", + "resolved": "https://registry.npmjs.org/tabbable/-/tabbable-6.5.2.tgz", + "integrity": "sha512-XgdnB1nGU6KU4VgMnZPaZCx7M1hBrLyEiZYau2G2gq9UT0d7d4FUBlNX7vvPlm/B1vk1PjrzJBx9Lbv4fsqS9g==", "dev": true, "license": "MIT" }, "node_modules/tapable": { - "version": "2.3.3", - "resolved": "https://registry.npmjs.org/tapable/-/tapable-2.3.3.tgz", - "integrity": "sha512-uxc/zpqFg6x7C8vOE7lh6Lbda8eEL9zmVm/PLeTPBRhh1xCgdWaQ+J1CUieGpIfm2HdtsUpRv+HshiasBMcc6A==", + "version": "2.3.4", + "resolved": "https://registry.npmjs.org/tapable/-/tapable-2.3.4.tgz", + "integrity": "sha512-NHFiWnAbMJxNNpBwiO7jJVGDuqMxT9/oV8v57RR+fgBQShkJil5inGD8/xWy0hjLyHQyX1tu27QANhlz3KBqCg==", "dev": true, "license": "MIT", "engines": { @@ -4875,9 +4989,9 @@ } }, "node_modules/thread-stream": { - "version": "4.2.0", - "resolved": "https://registry.npmjs.org/thread-stream/-/thread-stream-4.2.0.tgz", - "integrity": "sha512-e2zZ96wSChazBsbENf/Pcm/4swHt2cEKQ92rhUjkL9GCKiTDJIaTBenjE/m9DXi0QBmTMDkFDdOomUy20A1tDQ==", + "version": "4.2.1", + "resolved": "https://registry.npmjs.org/thread-stream/-/thread-stream-4.2.1.tgz", + "integrity": "sha512-Stg6edJXC/6/xqGwSXwFokrUhChJ18amEjpKH89WrQQ0oVFDF+pUUcTpiwWhFUrE89Vf16FBOlwhaw+lescxMQ==", "license": "MIT", "dependencies": { "real-require": "^1.0.0" @@ -4886,12 +5000,6 @@ "node": ">=20" } }, - "node_modules/thread-stream/node_modules/real-require": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/real-require/-/real-require-1.0.0.tgz", - "integrity": "sha512-P4nbQYQfePJxRSmY+v/KINxVucm4NF3p3s7pJveMTtom52FR4YGltUQLB8idDXwDDWW+eYrWDFbuzUnjoWHF7g==", - "license": "MIT" - }, "node_modules/tinyglobby": { "version": "0.2.17", "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.17.tgz", @@ -4973,6 +5081,14 @@ "node": ">=10.13.0" } }, + "node_modules/tslib": { + "version": "2.9.1", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.9.1.tgz", + "integrity": "sha512-a4Ux9VKuIMHsOS7ENbEq6hK2ZGYIT27Rtl0E4eD9KqwxhKiQeMZE/9xb3IdYwWaSOyIBQLExhQgXDTYoiCxnWA==", + "dev": true, + "license": "0BSD", + "optional": true + }, "node_modules/tweetnacl": { "version": "0.14.5", "resolved": "https://registry.npmjs.org/tweetnacl/-/tweetnacl-0.14.5.tgz", @@ -4993,12 +5109,11 @@ } }, "node_modules/typescript": { - "version": "5.9.3", - "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz", - "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==", + "version": "6.0.3", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-6.0.3.tgz", + "integrity": "sha512-y2TvuxSZPDyQakkFRPZHKFm+KKVqIisdg9/CZwm9ftvKXLP8NRWj38/ODjNbr43SsoXqNuAisEf1GdCxqWcdBw==", "dev": true, "license": "Apache-2.0", - "peer": true, "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" @@ -5008,16 +5123,16 @@ } }, "node_modules/typescript-eslint": { - "version": "8.70.1", - "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.70.1.tgz", - "integrity": "sha512-AcWG7KDjZ2THNXsgwttMaGmzVi0VFRlFYfqFHYQRbDpF3owuYbuiL8c7UUrd2k8s3PoSfIQrWfrGXfcElrWLYA==", + "version": "8.72.2", + "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.72.2.tgz", + "integrity": "sha512-c/+AKMW1KB81r28Sp0AAdcyXj5dzNmAsZFcsrxKbZTKmcBK2xIwBR31dcSYSDu3bKmzXe8GKrSxO+eDQ401Uzg==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/eslint-plugin": "8.70.1", - "@typescript-eslint/parser": "8.70.1", - "@typescript-eslint/typescript-estree": "8.70.1", - "@typescript-eslint/utils": "8.70.1" + "@typescript-eslint/eslint-plugin": "8.72.2", + "@typescript-eslint/parser": "8.72.2", + "@typescript-eslint/typescript-estree": "8.72.2", + "@typescript-eslint/utils": "8.72.2" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -5032,9 +5147,9 @@ } }, "node_modules/undici-types": { - "version": "7.18.2", - "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.18.2.tgz", - "integrity": "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w==", + "version": "7.24.6", + "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.24.6.tgz", + "integrity": "sha512-WRNW+sJgj5OBN4/0JpHFqtqzhpbnV0GuB+OozA9gCL7a993SmU+1JBZCzLNxYsbMfIeDL+lTsphD5jN5N+n0zg==", "dev": true, "license": "MIT" }, @@ -5081,15 +5196,15 @@ } }, "node_modules/unist-util-visit": { - "version": "5.1.0", - "resolved": "https://registry.npmjs.org/unist-util-visit/-/unist-util-visit-5.1.0.tgz", - "integrity": "sha512-m+vIdyeCOpdr/QeQCu2EzxX/ohgS8KbnPDgFni4dQsfSCtpz8UqDyY5GjRru8PDKuYn7Fq19j1CQ+nJSsGKOzg==", + "version": "5.2.0", + "resolved": "https://registry.npmjs.org/unist-util-visit/-/unist-util-visit-5.2.0.tgz", + "integrity": "sha512-fpsYs/VVoZxfGY9/j3FQpZmN8wdLJaV1Pt38AaJNZu9uKIHcFU3halCdBveEq1HGKO1OEfJY65w1zvoFV1b3qQ==", "dev": true, "license": "MIT", "dependencies": { "@types/unist": "^3.0.0", "unist-util-is": "^6.0.0", - "unist-util-visit-parents": "^6.0.0" + "unist-util-visit-parents": "^6.1.0" }, "funding": { "type": "opencollective", @@ -5097,9 +5212,9 @@ } }, "node_modules/unist-util-visit-parents": { - "version": "6.0.2", - "resolved": "https://registry.npmjs.org/unist-util-visit-parents/-/unist-util-visit-parents-6.0.2.tgz", - "integrity": "sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ==", + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/unist-util-visit-parents/-/unist-util-visit-parents-6.1.0.tgz", + "integrity": "sha512-vKXxz6O38sKDj1mtx/k2cWvkkFBuYGx6uGrlzBkVeWCRF/F8sdI0j3Wbkz/5rVNRRuVc8UrgRdbCxNhmYXgP3w==", "dev": true, "license": "MIT", "dependencies": { @@ -5137,9 +5252,9 @@ } }, "node_modules/vfile-message": { - "version": "4.0.3", - "resolved": "https://registry.npmjs.org/vfile-message/-/vfile-message-4.0.3.tgz", - "integrity": "sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw==", + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/vfile-message/-/vfile-message-4.0.4.tgz", + "integrity": "sha512-66ycRswIkNmHH9PHku7ADtv5RVwgIrOcuv3J8Svz6h4qgGRrKVa+9/neuKyJZUXyOpYwLTvS+whZ4R2urHHgQg==", "dev": true, "license": "MIT", "dependencies": { @@ -5152,17 +5267,16 @@ } }, "node_modules/vite": { - "version": "8.3.5", - "resolved": "https://registry.npmjs.org/vite/-/vite-8.3.5.tgz", - "integrity": "sha512-z1YpjieJ9g0ebTmQpLBv/oq9E3F9EIlOe+7LahW8SrE3LTiG3udBRUXQOlYXP9b+IC2q2phHeVxj9xGlw34OEQ==", + "version": "8.3.8", + "resolved": "https://registry.npmjs.org/vite/-/vite-8.3.8.tgz", + "integrity": "sha512-LzOn3h9rG/0vhLdXrV4yJ4QFA9eEoqCl+Yx+kGJd7aB9w6nfNgVHKSYwLPZUHrz4ZGa+t+kXjV9itvcHDLQouA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "lightningcss": "^1.33.0", "picomatch": "^4.0.7", - "postcss": "^8.5.30", - "rolldown": "~1.2.14", + "postcss": "^8.5.32", + "rolldown": "~1.2.18", "tinyglobby": "^0.2.17" }, "bin": { @@ -5231,29 +5345,29 @@ } }, "node_modules/vitepress": { - "version": "2.0.0-alpha.20", - "resolved": "https://registry.npmjs.org/vitepress/-/vitepress-2.0.0-alpha.20.tgz", - "integrity": "sha512-uQWKmP9PaBkf9zxHn0iOml/ZPPDaGKqQXVMBHz3yjwyyd9Eg+BKLGxbqmOGlfOMCt6Fj8TLiAnE59qlKZ0A3xw==", + "version": "2.0.0-alpha.21", + "resolved": "https://registry.npmjs.org/vitepress/-/vitepress-2.0.0-alpha.21.tgz", + "integrity": "sha512-b2PFPIw2mVfxDi490FhSq4AlkFi17b9lofLCqWfH4uPKz/dF4oy2C9vBpP2r7l7hl2hc5BG7OTRPvRFfRzF7MA==", "dev": true, "license": "MIT", "dependencies": { - "@docsearch/css": "^4.7.0", - "@docsearch/js": "^4.7.0", - "@docsearch/sidepanel-js": "^4.7.0", - "@iconify-json/simple-icons": "^1.2.93", - "@shikijs/transformers": "^4.4.3", - "@types/markdown-it": "^14.1.2", - "@vitejs/plugin-vue": "^6.0.8", + "@docsearch/css": "^4.7.1", + "@docsearch/js": "^4.7.1", + "@docsearch/sidepanel-js": "^4.7.1", + "@iconify-json/simple-icons": "^1.2.99", + "@shikijs/transformers": "^4.5.0", + "@types/markdown-it": "^14.2.0", + "@vitejs/plugin-vue": "^6.0.9", "@vue/devtools-api": "^8.2.1", - "@vue/shared": "^3.5.41", - "@vueuse/core": "^14.4.0", - "@vueuse/integrations": "^14.4.0", - "focus-trap": "^8.2.2", + "@vue/shared": "^3.5.43", + "@vueuse/core": "^15.0.0", + "@vueuse/integrations": "^15.0.0", + "focus-trap": "^8.2.3", "mark.js": "8.11.1", "minisearch": "^7.2.0", - "shiki": "^4.4.3", - "vite": "^8.2.1", - "vue": "^3.5.41" + "shiki": "^4.5.0", + "vite": "^8.3.4", + "vue": "^3.5.43" }, "bin": { "vitepress": "bin/vitepress.js" @@ -5272,18 +5386,17 @@ } }, "node_modules/vue": { - "version": "3.5.43", - "resolved": "https://registry.npmjs.org/vue/-/vue-3.5.43.tgz", - "integrity": "sha512-o5qZoksdnjIKvW1srZ3ab7pcDNYAerBjRe54D0LBLfRdCYFrSgBHVXokMas35czQc0//lmx4/tuY4ZNQ+Rf2Ng==", + "version": "3.5.45", + "resolved": "https://registry.npmjs.org/vue/-/vue-3.5.45.tgz", + "integrity": "sha512-3cvsib8m9c0vB24+MDKsgcW4+Da4xaBl9Z/5Tbm2pmSIsRPxcil4cdXjXlVsmJ2g64XJo5h+IRd7rsdGT9pZaw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { - "@vue/compiler-dom": "3.5.43", - "@vue/compiler-sfc": "3.5.43", - "@vue/runtime-dom": "3.5.43", - "@vue/server-renderer": "3.5.43", - "@vue/shared": "3.5.43" + "@vue/compiler-dom": "3.5.45", + "@vue/compiler-sfc": "3.5.45", + "@vue/runtime-dom": "3.5.45", + "@vue/server-renderer": "3.5.45", + "@vue/shared": "3.5.45" }, "peerDependencies": { "typescript": "*" @@ -5348,7 +5461,6 @@ "integrity": "sha512-3NxN8+78OdzbT7C/WjGsyfPAtJaN3FNDsWxv7Y7mcDsT/oOmgW8BpyQQFFBnvZE3j9Y2Sdz1ULFLezL7Eb2yFw==", "dev": true, "license": "ISC", - "peer": true, "bin": { "yaml": "bin.mjs" }, @@ -5395,9 +5507,9 @@ } }, "node_modules/zod": { - "version": "4.6.6", - "resolved": "https://registry.npmjs.org/zod/-/zod-4.6.6.tgz", - "integrity": "sha512-4UmzQUF5fxvfcYHlbjBmejU+w+hbDnWFx4aS8kBx7nPBHcO2SqPbpAG8snbdg+Xse4pRefR98hgjFgIMCI/UhA==", + "version": "4.6.7", + "resolved": "https://registry.npmjs.org/zod/-/zod-4.6.7.tgz", + "integrity": "sha512-g8W2D2kU6a8untc053fX1uVBKzM7yqAxW/3zwk83+6RyF2+SKOuV+c0wBDhUwzV1PaGapmZH+rmcUzPf+3CGwg==", "license": "MIT", "funding": { "url": "https://github.com/sponsors/colinhacks" @@ -5455,20 +5567,10 @@ "@proanima/arkvory-extension-api": "0.13.0", "@proanima/arkvory-resolution": "0.0.0", "@proanima/arkvory-signing": "0.0.0", - "pg": "8.23.0", + "pg": "8.23.1", "yauzl": "3.4.0" } }, - "packages/proget-compat": { - "name": "@proanima/arkvory-proget-compat", - "version": "0.0.0", - "extraneous": true, - "license": "SEE LICENSE IN LICENSE.md", - "dependencies": { - "@proanima/arkvory-application": "0.0.0", - "@proanima/arkvory-domain": "0.0.0" - } - }, "packages/resolution": { "name": "@proanima/arkvory-resolution", "version": "0.0.0", diff --git a/package.json b/package.json index 4367fe83..525e838e 100644 --- a/package.json +++ b/package.json @@ -9,7 +9,7 @@ "packages/*" ], "engines": { - "node": ">=24.13.0 <25", + "node": ">=24.22.3 <25", "npm": ">=11 <12" }, "scripts": { @@ -51,25 +51,28 @@ }, "devDependencies": { "@eslint/js": "10.0.1", - "@types/node": "24.13.6", + "@types/node": "24.19.2", "@types/pg": "8.23.1", "@types/ssh2": "1.15.6", "@types/yauzl": "3.4.0", "ajv": "8.20.0", "ajv-formats": "3.0.1", - "dependency-cruiser": "18.4.0", + "dependency-cruiser": "18.7.2", "esbuild": "0.28.2", - "eslint": "10.11.0", + "eslint": "10.15.0", "minisearch": "7.2.0", - "playwright": "1.63.0", - "prettier": "3.9.8", - "typescript": "5.9.3", - "typescript-eslint": "8.70.1", - "vitepress": "2.0.0-alpha.20", + "playwright": "1.65.1", + "prettier": "3.10.1", + "typescript": "6.0.3", + "typescript-eslint": "8.72.2", + "vitepress": "2.0.0-alpha.21", "yaml": "2.9.1", "yazl": "3.3.1" }, "homepage": "https://github.com/ProAnima/Arkvory", + "overrides": { + "minimatch": "11.0.8" + }, "license": "SEE LICENSE IN LICENSE.md", "author": "Ian Panaev", "repository": { diff --git a/packages/infrastructure/package.json b/packages/infrastructure/package.json index 16280e88..702f76b0 100644 --- a/packages/infrastructure/package.json +++ b/packages/infrastructure/package.json @@ -20,7 +20,7 @@ "@proanima/arkvory-domain": "0.0.0", "@proanima/arkvory-extension-api": "0.13.0", "@proanima/arkvory-signing": "0.0.0", - "pg": "8.23.0", + "pg": "8.23.1", "yauzl": "3.4.0", "@proanima/arkvory-resolution": "0.0.0" } diff --git a/packages/infrastructure/src/webhook-egress.ts b/packages/infrastructure/src/webhook-egress.ts index 665156a7..51f74925 100644 --- a/packages/infrastructure/src/webhook-egress.ts +++ b/packages/infrastructure/src/webhook-egress.ts @@ -92,7 +92,7 @@ export function createEgressPolicy(allowed: readonly string[]): EgressPolicy { /** Every address of the name, in the order the system resolver returns them. */ const systemResolver: Resolver = async (hostname) => { - const records = await dnsLookup(hostname, { all: true, verbatim: true }); + const records = await dnsLookup(hostname, { all: true, order: 'verbatim' }); return records.flatMap((record) => record.family === 4 || record.family === 6 ? [{ address: record.address, family: record.family }] diff --git a/scripts/ci/image.mjs b/scripts/ci/image.mjs index 2d23abad..c1349f87 100644 --- a/scripts/ci/image.mjs +++ b/scripts/ci/image.mjs @@ -8,12 +8,12 @@ import { docker, exists } from './docker.mjs'; // GitHub ubuntu runners preinstall PowerShell 7; deployment gates parse the Windows installer // scripts with it on Linux too. Hash from the release asset digest and release notes. const powershell = [ - 'https://github.com/PowerShell/PowerShell/releases/download/v7.6.6/powershell-7.6.6-linux-x64.tar.gz', - 'ddbc4a2d113bbd46d283cfedcbcd117a70caefd7673f41f2b4e0000badf103bc', + 'https://github.com/PowerShell/PowerShell/releases/download/v7.6.10/powershell-7.6.10-linux-x64.tar.gz', + 'e261cabc91c78a9afe8d1e5f24731ab0d38204735ab2ec94b0af55102652e10d', ]; export const postgresImage = - 'postgres:18.4@sha256:a02db8cac496f15b094798a38254f14d6e00741f709360e5e00bb6668ea31636'; + 'postgres:18.7@sha256:2ea8630df176ad090ec92136dee850397c5af8781e4bcf2e4162593691c61bbc'; async function playwrightVersion(root) { const manifest = JSON.parse(await readFile(resolve(root, 'package.json'), 'utf8')); diff --git a/scripts/ci/linux.Dockerfile b/scripts/ci/linux.Dockerfile index eac4d8c6..cf1cec1f 100644 --- a/scripts/ci/linux.Dockerfile +++ b/scripts/ci/linux.Dockerfile @@ -2,7 +2,7 @@ # Docker Engine. It mirrors the GitHub ubuntu-24.04 lanes: Node.js from the same pinned archive that # release packages ship, rpm/postgresql for native packaging, Playwright Chromium for the browser # gate and systemd for the disposable service-install lane. Nothing here is a production image. -FROM ubuntu:24.04@sha256:008173c23f95b170204355c12626cb5a965d779a7e1283b09e9cffbb1bf33ca3 +FROM ubuntu:24.04@sha256:73b999393d07f2bf65a40373778a44dc9a6d54ad7718d29247d8ff9413c4d6a8 ARG NODE_SHA256 ARG POWERSHELL_SHA256 diff --git a/scripts/compose-install.mjs b/scripts/compose-install.mjs index 562f05f3..a5c283ed 100644 --- a/scripts/compose-install.mjs +++ b/scripts/compose-install.mjs @@ -5,7 +5,7 @@ import { join, resolve, isAbsolute, dirname } from 'node:path'; import { parseArgs } from 'node:util'; // One command for running a source checkout in Docker: compile, package the same release bundle -// that the gates verify, then install it in compose mode (API, worker and PostgreSQL 18.4). +// that the gates verify, then install it in compose mode (API, worker and PostgreSQL 18.7). const usage = 'Usage: npm run deploy:compose -- --root [--version 0.1.0] [--engine docker|podman]'; const { values } = parseArgs({ diff --git a/scripts/native-dependencies.mjs b/scripts/native-dependencies.mjs index 2f848eea..91d411fb 100644 --- a/scripts/native-dependencies.mjs +++ b/scripts/native-dependencies.mjs @@ -7,24 +7,24 @@ import { sha256 } from './release-files.mjs'; export const dependencies = { nodeWindows: [ - 'https://nodejs.org/dist/v24.21.0/node-v24.21.0-win-x64.zip', - '158f7685b44de51f6c0df1d153526cbcd3e1bc739a8dfc607721cef75de9e541', + 'https://nodejs.org/dist/v24.22.3/node-v24.22.3-win-x64.zip', + 'e612af99f626ab415ea225af6bce5c971feb448cb5cae250bb1c3fa50c5f7d9f', ], nodeLinux: [ - 'https://nodejs.org/dist/v24.21.0/node-v24.21.0-linux-x64.tar.xz', - 'fd8e59d5a511510f6a298afb548f18c7d2b1be404d8b4a27d94fbe49f56cb2d6', + 'https://nodejs.org/dist/v24.22.3/node-v24.22.3-linux-x64.tar.xz', + '4f2b175a6d53a5c617a80dba2676238a0688cef28c6da4eba35c7d844e66fcfb', ], postgres: [ - 'https://get.enterprisedb.com/postgresql/postgresql-18.4-1-windows-x64-binaries.zip', - '7effe34c0bf89027b3f171447d351cbc460f4566c8d0f643daec67f140787858', + 'https://get.enterprisedb.com/postgresql/postgresql-18.7-1-windows-x64-binaries.zip', + 'ead0bbc27fb678fa24dcf86b738981323042abd073c744103bf7f3aed23f9a33', ], winsw: [ 'https://github.com/winsw/winsw/releases/download/v2.12.0/WinSW-x64.exe', '05b82d46ad331cc16bdc00de5c6332c1ef818df8ceefcd49c726553209b3a0da', ], compiler: [ - 'https://github.com/jrsoftware/issrc/releases/download/is-6_7_3/innosetup-6.7.3.exe', - '9c73c3bae7ed48d44112a0f48e66742c00090bdb5bef71d9d3c056c66e97b732', + 'https://github.com/jrsoftware/issrc/releases/download/is-6_7_4/innosetup-6.7.4.exe', + 'a549929319f9120716677c685535ca4671e4b937b5fdc87e2585f32d8eb30e8c', ], visualCpp: [ 'https://download.visualstudio.microsoft.com/download/pr/bd1c8d9d-ba95-4eee-bc6e-df1fcc876373/CC0FF0EB1DC3F5188AE6300FAEF32BF5BEEBA4BDD6E8E445A9184072096B713B/VC_redist.x64.exe', diff --git a/scripts/package-native.mjs b/scripts/package-native.mjs index fd04ac0b..571c1f98 100644 --- a/scripts/package-native.mjs +++ b/scripts/package-native.mjs @@ -90,10 +90,10 @@ async function windowsPackage() { const nodeArchive = join(stage, 'node.zip'); await copyFile(await dependency('nodeWindows', cache), nodeArchive); await expand(nodeArchive, join(stage, 'node')); - await copyFile(join(stage, 'node/node-v24.21.0-win-x64/node.exe'), join(runtime, 'node.exe')); - await installerRuntimePins(join(stage, 'node/node-v24.21.0-win-x64')); + await copyFile(join(stage, 'node/node-v24.22.3-win-x64/node.exe'), join(runtime, 'node.exe')); + await installerRuntimePins(join(stage, 'node/node-v24.22.3-win-x64')); await copyFile( - join(stage, 'node/node-v24.21.0-win-x64/LICENSE'), + join(stage, 'node/node-v24.22.3-win-x64/LICENSE'), join(runtime, 'NODE-LICENSE.txt'), ); const pgArchive = join(stage, 'pg.zip'); diff --git a/scripts/wiki/check.mjs b/scripts/wiki/check.mjs index aa168567..adcc80ca 100644 --- a/scripts/wiki/check.mjs +++ b/scripts/wiki/check.mjs @@ -17,6 +17,16 @@ export const labels = (text) => [...text.matchAll(UI)].map((m) => m[1]).sort(); const fences = (text) => text.split(/\r?\n/).filter((line) => /^\s*(```|~~~)/.test(line)).length; const same = (a, b) => JSON.stringify(a) === JSON.stringify(b); +// These names are executable configuration, permissions, flags and wire identifiers. +// Unlike surrounding prose and example placeholders, translations must retain them. +const TECHNICAL = + /\bARKVORY_[A-Z0-9_*]+|--[a-z][a-z0-9-]*|\b[a-z][a-z0-9]*(?:_[a-z0-9]+)+\b|\b(?:artifact|repository|storage|backup|upload|package|account|site|audit|token)\.(?:[a-z](?:[A-Za-z0-9_.]*[A-Za-z0-9_])?|\*(?!\*))|\b(?:X-(?:[A-Za-z]+-)*[A-Za-z]+|Retry-After|If-Range|If-Match|If-None-Match|Content-Range|Content-Type|ETag)\b/g; + +export function missingTechnicalTerms(source, translation) { + const own = new Set(translation.match(TECHNICAL) ?? []); + return [...new Set(source.match(TECHNICAL) ?? [])].filter((name) => !own.has(name)).sort(); +} + /** Differences of a translated page from the English one; empty when it keeps what it must. */ export function comparePage(code, page) { const path = `${code}/${page}.md`; @@ -53,6 +63,9 @@ export function comparePage(code, page) { `${path}: ${String(fences(text) / 2)} code blocks, English has ${String(fences(english) / 2)}`, ); if (/\bSTUB\b/.test(text)) problems.push(`${path}: stub`); + const missing = missingTechnicalTerms(english, text); + if (missing.length) + problems.push(`${path}: technical identifiers missing — [${missing.join(', ')}]`); // A link to the site's root stays in the language: /guide/ is /de/guide/ in German. for (const match of text.matchAll(/\]\((\/[^)\s]*)\)|link:\s*(\/\S*)/g)) { const target = match[1] ?? match[2] ?? ''; diff --git a/scripts/wiki/headings.mjs b/scripts/wiki/headings.mjs index 07c8f355..5b96c0c5 100644 --- a/scripts/wiki/headings.mjs +++ b/scripts/wiki/headings.mjs @@ -2,7 +2,7 @@ // (`## Backups {#backups}`): a translation keeps the ids, so a link to a section works in every // language, and tests/wiki.test.mjs compares a page's ids with the English page's. -const FENCE = /^s*(```|~~~)/; +const FENCE = /^\s*(```|~~~)/; const HEADING = /^(#{2,3})\s+(.*?)\s*$/; const ID = /\s*\{#([A-Za-z0-9_-]+)\}$/; diff --git a/tests/deployment/client-install.mjs b/tests/deployment/client-install.mjs index 723dd504..611cdfeb 100644 --- a/tests/deployment/client-install.mjs +++ b/tests/deployment/client-install.mjs @@ -79,7 +79,7 @@ export async function exerciseClient(output, version) { path.split(';').filter((p) => p.trim().toLowerCase() === installation.toLowerCase()).length, 1, ); - // Inno 6.7.3 terminates its first phase before usPostUninstall runs in the clone. + // Inno 6.7.4 terminates its first phase before usPostUninstall runs in the clone. // Wait for the process tree, then assert real removal; a parent exit code is insufficient. run('powershell.exe', [ '-NoProfile', diff --git a/tests/deployment/stand-hosts.mjs b/tests/deployment/stand-hosts.mjs index c66454a9..5f4c230c 100644 --- a/tests/deployment/stand-hosts.mjs +++ b/tests/deployment/stand-hosts.mjs @@ -7,7 +7,7 @@ import { join } from 'node:path'; // The base of the local CI image, so the stand runs the distribution the packages target. All // package dependencies are installed here: the .deb then installs without network access. The // file servers (Samba, NFS) stay masked except on the host that plays the NAS. -const dockerfile = `FROM ubuntu:24.04@sha256:008173c23f95b170204355c12626cb5a965d779a7e1283b09e9cffbb1bf33ca3 +const dockerfile = `FROM ubuntu:24.04@sha256:73b999393d07f2bf65a40373778a44dc9a6d54ad7718d29247d8ff9413c4d6a8 ENV DEBIAN_FRONTEND=noninteractive container=docker RUN apt-get update \\ && apt-get install -y --no-install-recommends systemd systemd-sysv dbus postgresql python3 \\ diff --git a/tests/deployment/windows-protection.mjs b/tests/deployment/windows-protection.mjs index b40beac6..ccccbf28 100644 --- a/tests/deployment/windows-protection.mjs +++ b/tests/deployment/windows-protection.mjs @@ -156,7 +156,7 @@ export async function verifiedRuntime(base) { await writeFile(join(artifact, 'arkvory-release.json'), JSON.stringify(manifest)); const config = join(directory, 'native.json'); await writeFile(config, '{}'); - const current = join(root, 'runtime', 'node-v24.21.0-win-x64'); + const current = join(root, 'runtime', 'node-v24.22.3-win-x64'); await mkdir(current, { recursive: true }); await writeFile(join(current, 'node.exe'), 'not the pinned runtime'); // An extraction that an interrupted run left behind. diff --git a/tests/release-staging.test.mjs b/tests/release-staging.test.mjs index d0934a22..57bf8ce0 100644 --- a/tests/release-staging.test.mjs +++ b/tests/release-staging.test.mjs @@ -183,8 +183,12 @@ test('downloads that an interrupted operation left are removed, and nothing else await mkdir(target); await writeFile(join(target, 'kept'), 'kept'); await symlink(target, join(f.root, link), 'junction'); - t.after(() => unlink(join(f.root, link)).catch(() => undefined)); - await stage(f.root, f.source); - assert.deepEqual((await downloads(f.root)).sort(), [current, foreign, folder, link].sort()); - assert.equal(await readFile(join(target, 'kept'), 'utf8'), 'kept', 'links are not followed'); + try { + await stage(f.root, f.source); + assert.deepEqual((await downloads(f.root)).sort(), [current, foreign, folder, link].sort()); + assert.equal(await readFile(join(target, 'kept'), 'utf8'), 'kept', 'links are not followed'); + } finally { + // Remove the junction before fixture cleanup can remove its sibling target on Windows. + await unlink(join(f.root, link)); + } }); diff --git a/tests/wiki-download-example.test.mjs b/tests/wiki-download-example.test.mjs new file mode 100644 index 00000000..541de5c3 --- /dev/null +++ b/tests/wiki-download-example.test.mjs @@ -0,0 +1,70 @@ +import test from 'node:test'; +import assert from 'node:assert/strict'; +import { mkdtempSync, readFileSync, writeFileSync, rmSync } from 'node:fs'; +import { tmpdir } from 'node:os'; +import { join } from 'node:path'; +import { spawnSync } from 'node:child_process'; +import { LANGUAGES, prefix, wiki } from '../scripts/wiki/site.mjs'; + +const example = (code) => { + const source = readFileSync(join(wiki, `${prefix(code)}protocols/raw-files.md`), 'utf8'); + const block = /```bash\r?\n(etag=\$\(cat GameSetup\.etag\)[\s\S]*?)\r?\n```/.exec(source); + assert.ok(block, `${code}: the conditional resume example is present`); + return block[1]; +}; +const bash = + process.platform === 'win32' ? join(process.env.ProgramFiles, 'Git/bin/bash.exe') : 'bash'; + +test('all translations retain the safe conditional resume command', () => { + const source = example('en'); + for (const { code } of LANGUAGES) assert.equal(example(code), source, code); +}); + +for (const [name, status, exit, expected] of [ + ['the same representation returns 206', '206', '0', 'abcDEF'], + ['a changed representation returns 200', '200', '0', 'abc'], + ['the request fails after writing a partial response', '000', '22', 'abc'], +]) { + test(`the documented resume keeps existing bytes safe when ${name}`, (t) => { + const folder = mkdtempSync(join(tmpdir(), 'arkvory-wiki-resume-')); + t.after(() => rmSync(folder, { recursive: true, force: true })); + writeFileSync(join(folder, 'GameSetup.part'), 'abc'); + writeFileSync(join(folder, 'GameSetup.etag'), '"sha256:existing"\n'); + // A deterministic transport stands in for curl; the documented shell code runs unchanged. + const transport = String.raw` +curl() { + local destination='' saved_etag=0 saved_range=0 + while [ "$#" -gt 0 ]; do + case "$1" in + -o) destination="$2"; shift ;; + -H) + case "$2" in + 'If-Range: "sha256:existing"') saved_etag=1 ;; + 'Range: bytes=3-') saved_range=1 ;; + esac + shift ;; + esac + shift + done + [ "$saved_etag" = 1 ] && [ "$saved_range" = 1 ] || return 99 + printf '%s' DEF > "$destination" + printf '%s' "$MOCK_STATUS" + return "$MOCK_EXIT" +} +`; + const result = spawnSync(bash, ['--noprofile', '--norc', '-c', transport + example('en')], { + cwd: folder, + encoding: 'utf8', + windowsHide: true, + env: { + ...process.env, + MOCK_STATUS: status, + MOCK_EXIT: exit, + URL: 'https://example.invalid/file', + }, + }); + assert.ifError(result.error); + assert.equal(result.status, status === '206' && exit === '0' ? 0 : 1, result.stderr); + assert.equal(readFileSync(join(folder, 'GameSetup.part'), 'utf8'), expected); + }); +} diff --git a/tests/wiki-links.test.mjs b/tests/wiki-links.test.mjs new file mode 100644 index 00000000..84d09e5e --- /dev/null +++ b/tests/wiki-links.test.mjs @@ -0,0 +1,57 @@ +import test from 'node:test'; +import assert from 'node:assert/strict'; +import { readFileSync } from 'node:fs'; +import { join } from 'node:path'; +import { createMarkdownRenderer } from 'vitepress'; +import { apiFragments } from '../wiki/.vitepress/api-fragments.ts'; +import { operations } from '../scripts/wiki/reference.mjs'; +import { root, LANGUAGES, prefix } from '../scripts/wiki/site.mjs'; + +test('every API operation link reaches its case-sensitive heading in the built site', async () => { + const md = await createMarkdownRenderer(root, { config: apiFragments }, '/Arkvory/'); + for (const { id } of await operations()) { + const html = md.render(`[operation](/api/reference/system#${id})\n\n## Operation {#${id}}`); + assert.ok(html.includes(`href="/Arkvory/api/reference/system.html#${id}"`), id); + assert.ok(html.includes(`id="${id}"`), id); + } +}); + +test('API fragments retain path normalization, external attributes and ordinary heading slugs', async () => { + const md = await createMarkdownRenderer(root, { config: apiFragments }, '/Arkvory/'); + const html = md.render( + '[relative](../reference/system.md?view=full#getSystemLicense)\n\n' + + '[local](#getSystemLicense)\n\n' + + '[outside](https://example.com/docs#getSystemLicense)\n\n' + + '[ordinary](#Silent%20installation)', + ); + const relative = /relative/.exec(html)?.[1]; + assert.ok(relative); + assert.equal( + new URL(relative, 'https://docs.example/Arkvory/guide/example').href, + 'https://docs.example/Arkvory/reference/system.html?view=full#getSystemLicense', + ); + assert.ok(html.includes('href="#getSystemLicense"')); + assert.ok(html.includes('href="https://example.com/docs#getSystemLicense" target="_blank"')); + assert.ok(html.includes('href="#silent-installation"')); +}); + +test('quoted attribution links never include translated punctuation in the repository URL', async () => { + const md = await createMarkdownRenderer(root); + const repository = 'https://github.com/ProAnima/Arkvory'; + const paths = [ + 'README.md', + 'README.ru.md', + 'LICENSE.md', + 'LICENSE.ru.md', + ...LANGUAGES.map(({ code }) => `wiki/${prefix(code)}reference/faq.md`), + ]; + for (const path of paths) { + const html = md.render(readFileSync(join(root, path), 'utf8')); + const links = [...html.matchAll(/href="([^"]+)"/g)] + .map((match) => match[1]) + .filter((href) => href.startsWith(repository)); + assert.ok(links.includes(repository), path); + for (const href of links) + assert.ok(href === repository || href.startsWith(`${repository}/`), path); + } +}); diff --git a/tests/wiki-sdk.test.mjs b/tests/wiki-sdk.test.mjs new file mode 100644 index 00000000..9d04fd45 --- /dev/null +++ b/tests/wiki-sdk.test.mjs @@ -0,0 +1,109 @@ +import test from 'node:test'; +import assert from 'node:assert/strict'; +import { readFileSync } from 'node:fs'; +import { join, resolve } from 'node:path'; +import ts from 'typescript'; +import { root, wiki } from '../scripts/wiki/site.mjs'; +import { writtenPages } from '../scripts/wiki.mjs'; + +// Examples omit application-owned values such as files, credentials and persistence. +// Give those values real public types; the example's calls and results stay fully checked. +const CLIENT = "import('@proanima/arkvory-sdk').ArkvoryClient"; +const REPOSITORY = `ReturnType<${CLIENT}['inRepository']>`; +const CONTEXT = { + ArkvoryClient: `typeof import('@proanima/arkvory-sdk').ArkvoryClient`, + client: CLIENT, + root: CLIENT, + releases: REPOSITORY, + prod: REPOSITORY, + dev: REPOSITORY, + staging: REPOSITORY, + file: 'Blob', + uploaded: '{ readonly id: string }', + id: 'string', + artifactId: 'string', + groupId: 'string', + idempotencyKey: 'string', + sha256: 'string', + requestId: 'string', + url: 'string', + bindings: `Parameters<${CLIENT}['administration']['services']['create']>[1]`, + saveToSecretStore: '(secret: string) => Promise', + openAsBlob: "typeof import('node:fs').openAsBlob", + Writable: "typeof import('node:stream').Writable", + createWriteStream: "typeof import('node:fs').createWriteStream", + saved: 'string', + store: '(cursor: string) => Promise', + handle: '(event: unknown) => Promise', +}; + +/** Names supplied by the example itself, including imports and destructuring. */ +function declaredNames(text) { + const names = new Set(); + const binding = (node) => { + if (ts.isIdentifier(node)) names.add(node.text); + else if (ts.isObjectBindingPattern(node) || ts.isArrayBindingPattern(node)) + for (const element of node.elements) if (ts.isBindingElement(element)) binding(element.name); + }; + const visit = (node) => { + if (ts.isVariableDeclaration(node)) binding(node.name); + if (ts.isImportSpecifier(node) || ts.isNamespaceImport(node)) names.add(node.name.text); + if (ts.isImportClause(node) && node.name) names.add(node.name.text); + ts.forEachChild(node, visit); + }; + visit(ts.createSourceFile('example.mts', text, ts.ScriptTarget.Latest, true)); + return names; +} + +/** One virtual module per fenced example; no example code is executed. */ +function examples() { + const files = new Map(); + for (const page of writtenPages()) { + const text = readFileSync(join(wiki, `${page}.md`), 'utf8'); + for (const match of text.matchAll(/^```(?:typescript|ts)\r?\n([\s\S]*?)^```[ \t]*$/gm)) { + const code = match[1]; + const declared = declaredNames(code); + const prelude = Object.entries(CONTEXT) + .filter(([name]) => !declared.has(name)) + .map(([name, type]) => `declare const ${name}: ${type};`) + .join('\n'); + files.set(resolve(root, 'tests', `wiki-example-${files.size}.mts`), { + source: `export {};\n${prelude}\n${code}`, + page, + line: text.slice(0, match.index).split('\n').length, + }); + } + } + return files; +} + +test('every TypeScript wiki example uses the current public SDK', () => { + const files = examples(); + assert.ok(files.size > 0, 'the documentation contains SDK examples'); + const options = { + strict: true, + noEmit: true, + target: ts.ScriptTarget.ES2023, + module: ts.ModuleKind.NodeNext, + moduleResolution: ts.ModuleResolutionKind.NodeNext, + types: ['node'], + lib: ['lib.es2023.d.ts', 'lib.dom.d.ts', 'lib.dom.iterable.d.ts'], + }; + const host = ts.createCompilerHost(options); + const originalSource = host.getSourceFile.bind(host); + host.getSourceFile = (file, languageVersion, onError, fresh) => { + const example = files.get(resolve(file)); + return example + ? ts.createSourceFile(file, example.source, languageVersion, true) + : originalSource(file, languageVersion, onError, fresh); + }; + const program = ts.createProgram([...files.keys()], options, host); + const problems = ts.getPreEmitDiagnostics(program).map((diagnostic) => { + const example = diagnostic.file && files.get(resolve(diagnostic.file.fileName)); + const where = example + ? `wiki/${example.page}.md:${example.line}` + : (diagnostic.file?.fileName ?? 'compiler'); + return `${where}: ${ts.flattenDiagnosticMessageText(diagnostic.messageText, '\n')}`; + }); + assert.deepEqual(problems, []); +}); diff --git a/tests/wiki.test.mjs b/tests/wiki.test.mjs index f2431d6d..482bb4a2 100644 --- a/tests/wiki.test.mjs +++ b/tests/wiki.test.mjs @@ -14,7 +14,13 @@ import { } from '../scripts/wiki/site.mjs'; import { headings, slug, withIds } from '../scripts/wiki/headings.mjs'; import { operationText, operations } from '../scripts/wiki/reference.mjs'; -import { checkApi, comparePage, frontField as field, labels } from '../scripts/wiki/check.mjs'; +import { + checkApi, + comparePage, + frontField as field, + labels, + missingTechnicalTerms, +} from '../scripts/wiki/check.mjs'; import { rulesOf, sample, typeOf } from '../scripts/wiki/schema.mjs'; import { writtenPages } from '../scripts/wiki.mjs'; import { writeStubs } from '../scripts/wiki/stubs.mjs'; @@ -33,6 +39,39 @@ const leaves = (value, path = '') => const pages = writtenPages(); +test('translation checks find omitted permissions, proxy headers and queue options', () => { + const source = + '`artifact.delete` `storage.read` `ARKVORY_SITE_URL` `X-Forwarded-Host` ' + + '`Retry-After` `rate_limited` `--wait-limit MS` `artifact.*`'; + assert.deepEqual(missingTechnicalTerms(source, 'Только общие слова о настройке'), [ + '--wait-limit', + 'ARKVORY_SITE_URL', + 'Retry-After', + 'X-Forwarded-Host', + 'artifact.*', + 'artifact.delete', + 'rate_limited', + 'storage.read', + ]); +}); + +test('technical checks allow translated prose and placeholders without requiring repetition', () => { + const source = + 'Use `--root ` with `ARKVORY_MODULES_FILE`; `routes_unsupported` means failure. ' + + 'Repeat `ARKVORY_MODULES_FILE`. Send `Authorization: Bearer `. **Same storage.**'; + const translation = + 'Используйте `--root <корень>` и `ARKVORY_MODULES_FILE`; ошибка `routes_unsupported`. ' + + 'Заголовок `Authorization: Bearer <ключ>`.'; + assert.deepEqual(missingTechnicalTerms(source, translation), []); + assert.deepEqual( + missingTechnicalTerms('A failure is backup.request.failed.', 'backup.request.failed。'), + [], + ); + assert.deepEqual(missingTechnicalTerms('Allow artifact.read.', 'Нет разрешения'), [ + 'artifact.read', + ]); +}); + test('every English page is written: a title, one heading, no stub', () => { for (const page of pages) { const text = read(`${page}.md`); @@ -212,6 +251,15 @@ test('heading ids follow VitePress slugs and skip code blocks', () => { headings(withIds(page)).map((h) => h.id), ['a-b', 'a-b-2', 'own'], ); + const indented = '## Outside\n\n ~~~md\n## Example, not a section\n ~~~\n'; + assert.deepEqual( + headings(indented).map((h) => h.text), + ['Outside'], + ); + assert.equal( + withIds(indented), + '## Outside {#outside}\n\n ~~~md\n## Example, not a section\n ~~~\n', + ); }); test('schema rules read as words, sizes as decimal strings', () => { diff --git a/tests/windows-installation.test.mjs b/tests/windows-installation.test.mjs index 736bc34d..22570ba8 100644 --- a/tests/windows-installation.test.mjs +++ b/tests/windows-installation.test.mjs @@ -50,11 +50,11 @@ test('install.ps1 runs Node.js only after the runtime passed verification', asyn '& takeown.exe /F $Root /A', 'try { Set-ExactAccess $Root $grants }', "Protect-CodeDirectory $path @('S-1-5-19')", - "$nodeSha256 = 'BA4E6D110E8C1592A1ECD390F6B05F3DA124B13871A5BE62B341A07A853C6C32'", + "$nodeSha256 = '86FC4785327DB5F5C7558DC6156C543B433C313E813A222E088086222AB4AFA6'", 'return (Get-FileHash -LiteralPath $exe -Algorithm SHA256).Hash -eq $nodeSha256', '$node = Join-Path $current', 'if (-not (Test-NodeRuntime $current)) {', - "-ne '158F7685B44DE51F6C0DF1D153526CBCD3E1BC739A8DFC607721CEF75DE9E541'", + "-ne 'E612AF99F626AB415EA225AF6BCE5C971FEB448CB5CAE250BB1C3FA50C5F7D9F'", "[IO.Directory]::GetDirectories($runtime, 'fresh-*')", "$fresh = Join-Path $runtime ('fresh-'", 'try {', @@ -73,9 +73,9 @@ test('install.ps1 runs Node.js only after the runtime passed verification', asyn const nodeName = /\$nodeName = '(node-v[0-9.]+-win-x64)'/.exec(install)?.[1]; assert.match( install, - /Invoke-WebRequest "https:\/\/nodejs\.org\/dist\/v24\.21\.0\/\$nodeName\.zip"/, + /Invoke-WebRequest "https:\/\/nodejs\.org\/dist\/v24\.22\.3\/\$nodeName\.zip"/, ); - assert.equal(`https://nodejs.org/dist/v24.21.0/${nodeName}.zip`, url); + assert.equal(`https://nodejs.org/dist/v24.22.3/${nodeName}.zip`, url); assert.ok(install.includes(`-ne '${archiveSha256.toUpperCase()}'`), 'archive SHA-256'); assert.ok( (await read('scripts/package-native.mjs')).includes( diff --git a/wiki/.vitepress/api-fragments.ts b/wiki/.vitepress/api-fragments.ts new file mode 100644 index 00000000..deaee26e --- /dev/null +++ b/wiki/.vitepress/api-fragments.ts @@ -0,0 +1,17 @@ +import type { MarkdownRenderer } from 'vitepress'; + +/** VitePress slugifies link fragments, but public operation IDs are case sensitive. */ +export function apiFragments(md: MarkdownRenderer) { + const previous = md.renderer.rules.link_open; + md.renderer.rules.link_open = (tokens, index, options, env, self) => { + const token = tokens[index]; + const href = token.attrGet('href') ?? ''; + const fragment = /#[a-z][A-Za-z0-9]*[A-Z][A-Za-z0-9]*$/.exec(href)?.[0]; + const rendered = previous + ? previous(tokens, index, options, env, self) + : self.renderToken(tokens, index, options); + if (!fragment) return rendered; + token.attrSet('href', (token.attrGet('href') ?? href).replace(/#.*$/, fragment)); + return self.renderToken(tokens, index, options); + }; +} diff --git a/wiki/.vitepress/config.mts b/wiki/.vitepress/config.mts index d5d79033..0b6838b1 100644 --- a/wiki/.vitepress/config.mts +++ b/wiki/.vitepress/config.mts @@ -9,6 +9,7 @@ import { siteText } from './site-text.ts'; import { tokenize } from './tokenize.ts'; import { uiLabels } from './ui-labels.ts'; import { vueSafe } from './vue-safe.ts'; +import { apiFragments } from './api-fragments.ts'; import { dictionaries } from './console-labels.ts'; // The search index in words as each script has them: Chinese and Japanese have no spaces @@ -190,9 +191,12 @@ export default defineConfig({ }, }, markdown: { + // Shiki has no bundled Caddyfile grammar; keep the correct label without build warnings. + languageAlias: { caddyfile: 'text' }, // An untranslated page includes the English one; its links stay relative to the page shown. include: { rebaseRelativeUrls: false }, config: (md) => { + apiFragments(md); uiLabels(md, dictionaries(), languageOf); vueSafe(md); }, diff --git a/wiki/.vitepress/structure.ts b/wiki/.vitepress/structure.ts index cc1f7563..946622d0 100644 --- a/wiki/.vitepress/structure.ts +++ b/wiki/.vitepress/structure.ts @@ -84,7 +84,19 @@ export const API_PAGES = [ * (a stub that includes it, with a notice) until someone translates it; `npm run wiki -- stubs` * writes the stubs and `npm run wiki -- check ` lists what is left. */ -export const COMPLETE: readonly string[] = ['en', 'ru', 'es', 'de', 'zh', 'hi', 'ko', 'fr', 'pt']; +export const COMPLETE: readonly string[] = [ + 'en', + 'ru', + 'es', + 'de', + 'zh', + 'hi', + 'ko', + 'fr', + 'pt', + 'ja', + 'ar', +]; /** Pages written by the generator before a build; not in git. */ export const GENERATED = ['api/errors', ...API_PAGES.map((page) => `api/reference/${page}`)]; diff --git a/wiki/api/authentication.md b/wiki/api/authentication.md index e0448d60..f364d172 100644 --- a/wiki/api/authentication.md +++ b/wiki/api/authentication.md @@ -266,17 +266,17 @@ Two other kinds of permission are not repository actions. The seven administrati ## Sign-in limits {#sign-in-limits} -The server slows down password guessing before it checks any password. The counters live in the memory of each API process and start again after a restart. They apply per client address, with an IPv6 address counted by its /64 prefix. Behind a reverse proxy, set `ARKVORY_TRUSTED_PROXIES`, or every client appears as the proxy. +The server slows down password guessing before it checks any password. The address counters and the server-wide registration counter live in the memory of each API process and start again after a restart. The address limits apply per client address, with an IPv6 address counted by its /64 prefix. The per-account password debt and lockout state are stored in PostgreSQL, shared by all API processes and preserved across restarts. Behind a reverse proxy, set `ARKVORY_TRUSTED_PROXIES`, or every client appears as the proxy. -| Limit | Value | -| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Sign-in attempts per address | A burst of 10, then one more every 15 seconds. A successful sign-in does not use an attempt. | -| Failed passwords per account | Each wrong password adds 1 to a debt that falls by 1 every 6 seconds. Above 20, the account refuses tries for 1 second, doubling with each further failure up to 2 minutes; during that time even the right password gets `429`. A successful sign-in or a reset clears the debt. | -| Registrations per address | 3, then one more every 20 minutes. | -| Registrations per server | 20, then one more every 3 minutes. | -| Sign-in requests in progress | 16 per API process, and the body has 10 seconds to arrive. More returns `503` with the code `busy`. | +| Limit | Value | +| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Sign-in attempts per address | A burst of 10, then one more every 15 seconds. A successful sign-in does not use an attempt. | +| Failed passwords per account | Each wrong password adds 1 to a debt that falls by 1 every 6 seconds. Above 20, the account refuses tries for 1 second, doubling with each further failure up to 2 minutes; during that time even the right password gets `429`. A successful sign-in, a successful change of your own password or an administrator’s password reset clears the debt. | +| Registrations per address | 3, then one more every 20 minutes. | +| Registrations per server | 20, then one more every 3 minutes. | +| Sign-in requests in progress | 16 per API process, and the body has 10 seconds to arrive. More returns `503` with the code `busy`. | -A refused attempt returns `429` with the code `rate_limited`, the reason `login_attempts`, `registration_attempts` or `password_attempts`, and `Retry-After` in seconds. Wait that long; do not retry in a loop. Changing or resetting a password has its own gate and the reason `password_attempts`. All sign-ins, registrations, password changes and token changes are written to the security audit (`GET /api/v1/security/audit`, administrators only), which keeps 365 days. +A refused attempt returns `429` with the code `rate_limited`, the reason `login_attempts`, `registration_attempts` or `password_attempts`, and `Retry-After` in seconds. Wait that long; do not retry in a loop. Outside a temporary lockout, a wrong current password when changing your own password adds to the same per-account debt and returns `401` with the reason `current_password_invalid`. During a temporary lockout, a password change returns `429` with the reason `password_attempts`. An administrator’s password reset clears the debt. The per-address budget is independent of the account debt. All sign-ins, registrations, password changes and token changes are written to the security audit (`GET /api/v1/security/audit`, administrators only), which keeps 365 days. ## Related pages {#related} diff --git a/wiki/api/index.md b/wiki/api/index.md index 888760ce..dee7a8e2 100644 --- a/wiki/api/index.md +++ b/wiki/api/index.md @@ -25,7 +25,7 @@ The largest object is 10,000 GiB (10 737 418 240 000 bytes) unless the administr ## Authentication {#authentication} -Every operation except sign-in, the public health checks and the sign-in options needs a credential in the header `Authorization: Bearer `. The credential is a console session, a personal access token, a service key or the recovery key. What a credential may do depends on its kind and on the **access rule** of each operation. Read [Authentication](./authentication) before you design the integration, and give automation a service key with only the actions it needs. +Every operation except sign-in, self-registration, the public health checks and the sign-in options needs a credential in the header `Authorization: Bearer `. Self-registration (`POST /api/v1/auth/register`, `registerAccount`) needs no credential and can succeed only when the administrator sets `ARKVORY_ALLOW_REGISTRATION=true`; otherwise it returns `403` with the reason `registration_disabled`. The credential is a console session, a personal access token, a service key or the recovery key. What a credential may do depends on its kind and on the **access rule** of each operation. Read [Authentication](./authentication) before you design the integration, and give automation a service key with only the actions it needs. ## Discovery {#discovery} diff --git a/wiki/ar/api/authentication.md b/wiki/ar/api/authentication.md index cc7268ef..a3821a6d 100644 --- a/wiki/ar/api/authentication.md +++ b/wiki/ar/api/authentication.md @@ -1,12 +1,288 @@ --- -title: 'Authentication' -description: 'Every way to authenticate to the Arkvory HTTP API, what each credential may do, and how access rules and repository actions work.' +title: 'المصادقة' +description: 'جميع طرق المصادقة إلى HTTP API في Arkvory، وما تتيحه كل بيانات اعتماد، وكيف تعمل قواعد الوصول وإجراءات المستودعات.' --- - +# المصادقة -::: warning -لم تُترجم هذه الصفحة بعد، وهي معروضة بالإنجليزية. -::: +يحتاج كل استدعاء إلى `/api/v1` إلى بيانات اعتماد، باستثناء فحوص الصحة العامة وخيارات تسجيل الدخول وتسجيل الدخول والتسجيل. تسرد هذه الصفحة أنواع بيانات الاعتماد، وكيفية الحصول على كل منها وإرسالها، ومعنى قواعد الوصول في [مرجع API](./index#reference-pages). لقواعد الأشخاص الذين يديرون الوصول، انظر [الحسابات والوصول](../use/accounts). - +## نظرة سريعة على بيانات الاعتماد {#credentials} + +| بيانات الاعتماد | شكلها | كيفية الحصول عليها | مدة الصلاحية | الاستخدام | +| ---------------- | -------------------- | ----------------------------------------------------- | ------------------------------- | ------------------------------------------------- | +| جلسة وحدة التحكم | `dps_…` | تسجيل الدخول باسم وكلمة مرور | 12 ساعة | شخص في وحدة التحكم أو برنامج نصي يسجل الدخول | +| رمز وصول شخصي | `pat_…` | إنشاؤه من جلسة | 90 يوماً افتراضياً، و365 كحد أقصى | البرامج النصية والأدوات لشخص واحد | +| مفتاح خدمة | `arkvory_…` | إصداره لحساب خدمة ثم تفعيله | 90 يوماً افتراضياً، و365 كحد أقصى | ‏CI/CD ووكلاء النشر والأنظمة الأخرى | +| مفتاح الاسترداد | 64 رقماً سداسياً عشرياً | يكتبه برنامج التثبيت إلى `config/bootstrap-token.txt` | لا تنتهي صلاحيته | إنشاء المالك وإدارة حسابات الخدمة واسترداد الوصول | +| رابط تنزيل | `dtl_…` | إنشاؤه لمُخرَج واحد | من 60 ثانية إلى 24 ساعة | إعطاء مُخرَج واحد لشخص دون مفتاح | + +استخدم مفتاح خدمة للأتمتة ورمز وصول شخصياً لأدوات شخص. لا تستخدم مفتاح الاسترداد للعمل اليومي. + +## صيغ الترويسات {#headers} + +تقبل `/api/v1` بيانات اعتماد في ترويسة واحدة: + +```http +Authorization: Bearer +``` + +- يبلغ طول بيانات الاعتماد من 32 إلى 512 محرفاً. أي طول آخر يؤدي فوراً إلى `credential_invalid`. +- يقبل سجل الحاويات (`/v2`) وGit LFS ‏(`/lfs`) وسجل npm ‏(`/npm`) أيضاً HTTP Basic، لأن `docker login` وgit وnpm ترسل بيانات الاعتماد بهذه الطريقة. لا يُفحص اسم المستخدم؛ كلمة المرور هي بيانات الاعتماد. انظر [العملاء والبروتوكولات](../protocols/index#credentials). +- يوضع رابط التنزيل في سلسلة الاستعلام بصيغة `?token=dtl_…`، ويعمل فقط على مسار محتوى مُخرَج واحد. انظر [روابط التنزيل](#download-links). تتقدم ترويسة `Authorization` دائماً على الاستعلام. +- يتلقى الطلب الذي لا يحمل بيانات اعتماد صالحة الاستجابة `401` مع `WWW-Authenticate: Bearer` وسبب: `credential_missing` أو `credential_invalid` أو `session_expired` أو `token_expired`. لا يعرف أن بيانات الاعتماد انتهت صلاحيتها إلا حامل سرها المطابق تماماً. +- **بلا ملفات تعريف ارتباط.** لا يضبط Arkvory أياً منها ولا يقرأ أياً منها، لذلك لا يرفق المتصفح بيانات اعتماد تلقائياً أبداً، ولا يوجد تزوير طلبات عبر المواقع يلزم التصدي له. يرسل البرنامج النصي الترويسة في كل استدعاء. تحتفظ وحدة التحكم برمز جلستها في ذاكرة علامة تبويب المتصفح وتنساه عند إغلاقها. +- **الأصول الأخرى.** لا تحتاج صفحة على عنوان Arkvory نفسه إلى شيء. تُرفض صفحة على عنوان آخر بالاستجابة `403` والسبب `origin_not_allowed` ما لم يُدرج المسؤول أصلها في `ARKVORY_CORS_ORIGINS`، حتى مع بيانات اعتماد صالحة. استخدم HTTPS: يمكن قراءة بيانات الاعتماد المرسلة عبر HTTP غير المشفر على الشبكة. انظر [HTTPS](../install/https). + +تحقق من هوية بيانات الاعتماد وما تتيحه: + +```bash +curl -fsS -H "Authorization: Bearer $ARKVORY_KEY" "$ARKVORY_URL/api/v1/auth/me" +curl -fsS -H "Authorization: Bearer $ARKVORY_KEY" "$ARKVORY_URL/api/v1/auth/permissions" +``` + +## جلسات تسجيل الدخول إلى وحدة التحكم {#sessions} + +يسجل الشخص الدخول باسم وكلمة مرور ويتلقى جلسة. تفعل وحدة التحكم ذلك نيابة عنك؛ ويمكن لبرنامج نصي فعل الشيء نفسه. + +1. ضع الاسم وكلمة المرور في ملف خاص `login.json` كي لا يظهرا أبداً في سطر أوامر أو قائمة عمليات: + + ```json + { "name": "alice", "password": "a long password of 12 to 128 characters" } + ``` + +2. استدعِ `login`: + + ```bash + curl -fsS -X POST "$ARKVORY_URL/api/v1/auth/login" \ + -H "Content-Type: application/json" -d @login.json + ``` + +3. تحتوي الاستجابة على رمز الجلسة ووقت انتهائها: + + ```json + { + "token": "dps_…", + "expiresAt": "2026-10-05T21:30:00.000Z", + "account": { "id": "…", "name": "alice", "administrator": false, "enabled": true } + } + ``` + +4. أرسل الرمز بصيغة `Authorization: Bearer dps_…`. + +قواعد الجلسة: + +- تدوم 12 ساعة ولا تتمدد. بعد ذلك، يعيد كل استدعاء الاستجابة `401` بالسبب `session_expired`. سجّل الدخول مجدداً. +- للحساب 32 جلسة كحد أقصى. ينهي تسجيل دخول جديد أقدم الجلسات التي تتجاوز ذلك العدد. +- تنهي `POST /api/v1/auth/logout` الجلسة. يؤدي تغيير كلمة مرورك أو إعادة تعيينها بواسطة مسؤول إلى إنهاء جميع جلسات الحساب ورموزه الشخصية. ويوقفها تعطيل الحساب. +- تحمل الجلسة كامل صلاحيات الحساب، بما فيها علم المسؤول. الجلسة وحدها تستطيع إنشاء الرموز الشخصية وإبطالها وتغيير كلمة مرور الحساب نفسه. +- تُقارن الأسماء دون مراعاة حالة الأحرف. يعطي الاسم الخاطئ وكلمة المرور الخاطئة والحساب المعطّل الاستجابة `401` نفسها بالسبب `invalid_credentials`. +- لا تسجل بوابة القراءة دخول أي شخص؛ استخدم الكاتب. + +### التسجيل الذاتي {#self-registration} + +نقطة النهاية `GET /api/v1/auth/options` عامة وتخبرك بما إذا كان يجوز للأشخاص إنشاء حساباتهم. التسجيل الذاتي معطّل ما لم يضبط المسؤول `ARKVORY_ALLOW_REGISTRATION=true`؛ عندئذٍ تنشئ `POST /api/v1/auth/register` بالجسم نفسه المستخدم لتسجيل الدخول حساباً عادياً (ليس مسؤولاً، ودون وصول إلى أي مستودع)، وتعيد جلسة بالاستجابة `201`. وإلا تجيب بـ`403` والسبب `registration_disabled`. يتوقف التسجيل الذاتي عند 900 حساب، كي يظل بإمكان المسؤولين إنشاء حسابات حتى حد 1,000. + +## رموز الوصول الشخصية {#personal-tokens} + +يتيح رمز الوصول الشخصي لبرنامج نصي العمل بهويتك دون كلمة مرورك. لا تستطيع إنشاءه إلا جلسة مسجّل دخولها. + +```bash +curl -fsS -X POST "$ARKVORY_URL/api/v1/auth/tokens" \ + -H "Authorization: Bearer $SESSION" -H "Content-Type: application/json" \ + -d '{"name":"laptop-cli","scope":"read-write","expiresAt":"2026-12-31T00:00:00Z"}' +``` + +في وحدة التحكم، افتح [[ui:personalAccessTokens]] في بطاقة [[ui:connection]]، وأدخل [[ui:tokenName]]، واختر [[ui:tokenScope]] و[[ui:tokenExpiry]]، ثم اختر [[ui:generateToken]]. + +| الحقل | القاعدة | +| ----------- | ---------------------------------------------------------------------------------------------------------------- | +| `name` | من 1 إلى 64 محرفاً. | +| `scope` | ‏`read` أو `read-write`. تستخدم واجهة API ‏`read-write` عند حذفه؛ وتقترح وحدة التحكم [[ui:tokenScopeRead]] أولاً. | +| `expiresAt` | وقت مستقبلي وفق RFC 3339، لا يبعد أكثر من 365 يوماً. الافتراضي 90 يوماً. لا توجد رموز بلا نهاية. | + +تتضمن استجابة `201` الرمز مرة واحدة باسم `token`. احفظه حينها: يحتفظ الخادم بالتجزئة فقط، وتعرض القائمة بادئة قصيرة. وبعد ذلك: + +- يملك الرمز وصول حسابه إلى المستودعات ولا شيء إضافياً. لا يحمل علم المسؤول أبداً، فلا يستطيع إدارة الحسابات أو المجموعات أو التحديثات أو النسخ الاحتياطية. +- لا يستطيع رمز `read` إلا القراءة. يُرفض أي طلب يغيّر شيئاً، باستثناء `logout`، بالاستجابة `403` والسبب `read_only_token` قبل تشغيل العملية. +- لا يستطيع الرمز إنشاء رموز أو تغيير كلمة مرور؛ يتطلب ذلك جلسة. +- للحساب 50 رمزاً نشطاً كحد أقصى. تسردها `GET /api/v1/auth/tokens` مع بادئتها ونطاقها ونهايتها وآخر استخدام لها. تبطل `DELETE /api/v1/auth/tokens/{id}` أحدها فوراً ([[ui:revokeToken]] في وحدة التحكم). يستطيع المسؤول سرد رموز أي حساب وإبطالها. +- يعيد الرمز المنتهي الصلاحية الاستجابة `401` بالسبب `token_expired`. + +## حسابات الخدمة والمفاتيح {#service-accounts} + +**حساب الخدمة** هوية لأداة، مثل وكيل بناء. له **سياسة**: قائمة **روابط**، يسمي كل منها مستودعاً واحداً و**الإجراءات** المحددة المسموح بها فيه (انظر [إجراءات المستودع](#repository-actions)). للسياسة 64 ربطاً كحد أقصى. يملك الحساب عمليات الرفع والمهام التي تبدأها مفاتيحه، لذلك لا يُفقد شيء عند تدوير مفتاح. للخادم 1,000 حساب خدمة كحد أقصى. + +لا ينشئ حساب الخدمة إلا [مفتاح الاسترداد](#recovery-key). ويغيّر الحسابات الموجودة هو أو مشغّل لديه [تفويض](#delegation). في وحدة التحكم، استخدم [[ui:services]]: ‏[[ui:serviceCreate]] ثم اضبط [[ui:servicePolicy]]. يملأ [[ui:bindingRead]] إجراءات القراءة السبعة، ويضيف [[ui:bindingPublish]] الإجراءات اللازمة لرفع الحزم وتسجيلها. + +```bash +curl -fsS -X POST "$ARKVORY_URL/api/v1/service-accounts" \ + -H "Authorization: Bearer $RECOVERY_KEY" -H "Content-Type: application/json" \ + -d '{"name":"ci-release","bindings":[{"resource":{"kind":"repository","id":"releases"}, + "actions":["repository.read","artifact.read","upload.create","upload.read","upload.write", + "upload.complete","upload.cancel","job.read","package.publish"]}]}' +``` + +تستخدم الأسماء من 3 إلى 64 محرفاً من الأحرف والأرقام و`_` و`.` و`-`. لتغيير السياسة، أرسل `PUT /api/v1/service-accounts/{id}/policy` مع `expectedRevision` التي قرأتها ([المقارنة والاستبدال](./index#revisions)). لتعطيل الحساب، أرسل `PATCH /api/v1/service-accounts/{id}` مع `{"expectedRevision": n, "enabled": false}`؛ تتوقف جميع مفاتيحه عن العمل حتى تعيد تمكينه. + +### مفاتيح الخدمة {#service-keys} + +المفتاح هو السر الذي يسجل حساب الخدمة دخوله به. شكله `arkvory_.`. يمر المفتاح بثلاث حالات: `pending` و`active` و`revoked`. + +1. **الإصدار.** أرسل `POST /api/v1/service-accounts/{id}/keys` مع `Idempotency-Key` و`name` و`bindings` المسموح للمفتاح استخدامها، ومع `expiresAt` إن أردت (بتوقيت UTC، خلال 365 يوماً؛ والافتراضي 90). يجب أن تقع روابط المفتاح ضمن سياسة الحساب. تتضمن الاستجابة `201` بيانات تعريف المفتاح و`secret` الخاص به، لهذه المرة فقط. يعيد التكرار بمفتاح منع التكرار نفسه الاستجابة `200` مع بيانات التعريف ودون السر. +2. **التفعيل.** يكون المفتاح الجديد `pending` وغير قابل للاستخدام إلا لاستدعاء واحد هو `POST /api/v1/auth/activate-key`، مع السر الجديد بصفته بيانات الاعتماد. الاستجابة `204`. افعل ذلك خلال 15 دقيقة؛ وبعدها تنتهي صلاحية المفتاح دون استخدامه. في وحدة التحكم، انسخ السر، واختر [[ui:keySaved]] ثم [[ui:keyActivate]]. لا يسبب التفعيل مجدداً ضرراً. +3. **الاستخدام.** يعمل المفتاح حتى `expiresAt` أو حتى إبطاله أو تعطيل حسابه. + +```bash +curl -fsS -X POST "$ARKVORY_URL/api/v1/service-accounts/$ACCOUNT/keys" \ + -H "Authorization: Bearer $RECOVERY_KEY" -H "Idempotency-Key: ci-release-2026-10" \ + -H "Content-Type: application/json" \ + -d '{"name":"ci-release-2026-10","bindings":[{"resource":{"kind":"repository","id":"releases"}, + "actions":["upload.create","upload.read","upload.write","upload.complete","job.read"]}]}' +curl -fsS -X POST "$ARKVORY_URL/api/v1/auth/activate-key" -H "Authorization: Bearer $NEW_SECRET" +``` + +الحدود: للحساب 3 مفاتيح نشطة و2 معلّقان كحد أقصى في الوقت نفسه (`507` بالسبب `key_limit`). + +**التدوير.** تصدر `POST /api/v1/api-keys/{id}/rotate` مفتاحاً جديداً معلّقاً للحساب نفسه، بالجسم نفسه المستخدم للإصدار ومع `Idempotency-Key`. يجب أن تقع روابطه ضمن روابط المفتاح القديم. عند تفعيل المفتاح الجديد، تُقصّر نهاية صلاحية المفتاح القديم إلى 24 ساعة كحد أقصى من تلك اللحظة. انقل أدواتك إلى المفتاح الجديد، ثم أبطل القديم. في وحدة التحكم: [[ui:keyRotate]]. + +**الإبطال.** تنهي `POST /api/v1/api-keys/{id}/revoke` المفتاح نهائياً؛ ولا يسبب تكرارها ضرراً. في وحدة التحكم: [[ui:keyRevoke]]. لا يوقف إبطال مفتاح عملية نقل بدأت بالفعل. هل فقدت سر مفتاح معلّق؟ أبطله وأصدر آخر بمفتاح منع تكرار جديد. + +### التفويض {#delegation} + +يمكن لمفتاح الاسترداد تسليم جزء من الإدارة إلى **مشغّل**: حساب خدمة يجوز لمفتاحه إدارة حسابات خدمة أخرى. يسمي **التفويض** مفتاح المشغّل والحساب الهدف و**الإجراءات الإدارية** التي يجوز له استخدامها عليه و**سقف الصلاحيات**، أي إجراءات المستودع التي يجوز له منحها. الإجراءات الإدارية السبعة هي: + +| الإجراء | ما يسمح به | +| ------------------------ | ------------------------------------- | +| `service-account.read` | رؤية الحساب في القوائم وقراءة بطاقته. | +| `service-account.manage` | تمكين الحساب أو تعطيله. | +| `policy.read` | قراءة سياسة الحساب. | +| `policy.manage` | استبدال سياسة الحساب. | +| `credential.read` | سرد مفاتيح الحساب وقراءة مفتاح. | +| `credential.manage` | إصدار المفاتيح وتدويرها وإبطالها. | +| `service-audit.read` | قراءة محفوظات مفاتيح الحساب. | + +القواعد: يجب أن يكون مفتاح المشغّل صادراً من مفتاح الاسترداد؛ ولا يدير المشغّل حسابه الخاص أبداً؛ ولا يستطيع منح شيء خارج سقف صلاحياته أو يتجاوز سياسة الحساب؛ ولا يجوز أن تدوم صلاحية مفتاح يصدره أكثر من مفتاحه؛ ولا يؤدي إنهاء تفويض إلى إبطال مفاتيح فُعّلت بالفعل. لا ينشئ الحسابات ويضبط التفويضات إلا مفتاح الاسترداد (`PUT` و`DELETE /api/v1/api-keys/{id}/delegations/{accountId}`). يمكن لمفتاح مشغّل واحد امتلاك حتى 64 تفويضاً. في وحدة التحكم، استخدم [[ui:delegations]]. يتلقى المشغّل الذي يحتاج إلى شيء خارج تفويضه الاستجابة `404` لحساب لا يديره، أو `403`. + +## مفتاح الاسترداد {#recovery-key} + +ينشئ برنامج التثبيت **مفتاح الاسترداد** مرة واحدة ويكتبه إلى `config/bootstrap-token.txt` في [جذر التثبيت](../install/index#installation-directory). لا يستطيع قراءة الملف إلا مجموعة المسؤولين على Windows أو root على Linux. توجد تجزئته في ملف مفاتيح الخادم (`ARKVORY_KEYS_FILE`) تحت الاسم `bootstrap-owner`. ينشئ برنامج التثبيت أيضاً `config/health-token.txt`، وهو مفتاح ثانٍ بلا أي حقوق على المستودعات، يستطيع استدعاء فحوص الصحة التي تتطلب المصادقة والمقاييس. + +ما يستطيع مفتاح الاسترداد فعله: + +- إنشاء الحساب الأول وكل حساب بعده، وإعادة تعيين كلمات المرور، وتعطيل الحسابات، وإدارة المجموعات ومنح وصولها إلى المستودعات. +- قراءة التدقيق الأمني وإبطال الرموز الشخصية لأي حساب. +- إنشاء حسابات الخدمة وضبط سياساتها وإصدار مفاتيحها وإبطالها وضبط التفويضات. +- قراءة النسخ الاحتياطية والتحديثات وطلبها، وتنزيل سجل الخادم للملاحظات. +- قراءة المستودع `releases` والكتابة إليه كعضو في مجموعة بوصول [[ui:write]]. + +ما لا يستطيع فعله: لا يملك وصولاً إلى مستودعات غير `releases`، ولا يستطيع حذف المُخرَجات أو إدارة سياسات التخزين (فهذه الإجراءات موجودة لمفاتيح الخدمة فقط)، وليس جلسة، فلا يستطيع إنشاء رموز شخصية أو تغيير كلمة مرور. احتفظ به على الخادم. تقرؤه أدوات التثبيت هناك. لا تضعه في CI ولا تلصقه في الأدوات؛ أنشئ مفتاح خدمة بدلاً من ذلك. لاستبداله، انظر [الإعدادات](../install/configuration). + +يستخدم نموذج [[ui:welcomeOwner]] في وحدة التحكم (تحت [[ui:navStart]]) مفتاح الاسترداد لإنشاء المالك الأول. ولا يعمل إلا ما دام لا يوجد أي حساب. لإعادة تعيين كلمة مرور حساب موجود دون جلسة، اعثر على معرّفه باستخدام `GET /api/v1/users`، وضع كلمة المرور الجديدة (من 12 إلى 128 محرفاً) في ملف خاص وأرسلها بمفتاح الاسترداد. تنهي إعادة التعيين جميع جلسات ذلك الحساب ورموزه. + +```bash +echo '{"password": "a new password of 12 to 128 characters"}' > reset.json +curl -fsS -X PATCH "$ARKVORY_URL/api/v1/users/$USER_ID" \ + -H "Authorization: Bearer $RECOVERY_KEY" -H "Content-Type: application/json" -d @reset.json +rm reset.json +``` + +يمكن للمسؤول إضافة مفاتيح ملفات أخرى في ملف المفاتيح. لكل إدخال `id` و`sha256` للسر و`repositories` و`permissions` ‏(`read` و`write`) التي يحصل عليها، واختيارياً العلمان `administrator` و`serviceAdministrator`. يُقرأ الملف عند بدء التشغيل، لذا أعد تشغيل واجهة API والعامل بعد أي تغيير. + +## روابط التنزيل {#download-links} + +تعيد `POST /api/v1/repositories/{repository}/artifacts/{id}/links` رمز `token` ‏(`dtl_…`) ورابط `url` لمُخرَج واحد. اطلب مدة صلاحية باستخدام `ttlSeconds`: من 60 إلى 86,400، و3,600 افتراضياً. يحتاج المستدعي إلى `content.read`. + +لا يعمل الرابط إلا بطلب `GET` أو `HEAD` إلى `/api/v1/repositories/{repository}/artifacts/{id}/content?token=…`، لذلك المُخرَج في ذلك المستودع، وللقراءة فقط. إنه سر. لا يستطيع الخادم إبطاله قبل انتهاء صلاحيته، ولا يظهر في السجلات. أنشئ الروابط بأقصر مدة تحتاج إليها. + +## معنى قاعدة الوصول {#access-rules} + +لكل عملية في المرجع سطر **الوصول**. هذه أنواع القواعد: + +| القاعدة في المرجع | ما تتطلبه | +| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| أي شخص دون مفتاح | لا شيء. حيوية العملية وحالة الجاهزية وخيارات تسجيل الدخول وتسجيل الدخول والتسجيل. | +| أي مفتاح أو جلسة صالحين | أي بيانات اعتماد صالحة. أمثلة: الإمكانات وقائمة العمليات وهويتك وتفاصيل الجاهزية والمقاييس. | +| جلسة حساب مسجّل دخوله (وليست مفتاحاً) | جلسة شخص. تُرفض الرموز الشخصية والمفاتيح (`session_required`). أمثلة: إنشاء رموزك وإبطالها وتغيير كلمة مرورك. | +| مسؤول | جلسة حساب مسؤول أو مفتاح ملف بعلم المسؤول، مثل مفتاح الاسترداد. تُرفض الرموز الشخصية ومفاتيح الخدمة (`administrator_required`). أمثلة: الحسابات والمجموعات والتدقيق الأمني والتحديثات. | +| مفتاح التهيئة (مفتاح استرداد التثبيت) | مفتاح ملف بعلم إدارة الخدمات. يملكه مفتاح الاسترداد. أمثلة: إنشاء حسابات الخدمة وضبط التفويضات. | +| مفتاح التهيئة أو المفتاح نفسه | مفتاح الاسترداد أو المفتاح الذي تُسرد تفويضاته. | +| المفتاح الصادر قبل التفعيل أو بعده | العملية الوحيدة التي تقبل مفتاحاً معلّقاً: التفعيل. | +| المستودعات التي يجوز للمستدعي رؤيتها | الإجراء `repository.read` على ذلك المستودع، أو أي وصول إليه لجلسة أو مفتاح ملف. يُستبعد المستودع الذي لا يستطيع المستدعي رؤيته من القوائم ويجيب بالاستجابة `404`. | +| إذن النظام `backup.read` أو `backup.manage` | تملكه جلسات المسؤولين ومفاتيح الملفات ذات علم المسؤول. ولا تملكه مفاتيح الخدمة والرموز الشخصية أبداً. يتضمن `backup.manage` الإذن `backup.read`. | +| إذن إدارة الخدمات | أحد [الإجراءات الإدارية](#delegation) السبعة على الحساب الهدف من تفويض، أو مفتاح الاسترداد. | +| إذن المستودع | **كل** إجراءات المستودع المدرجة على المستودع المسمى في المسار. تضيف عدة قواعد وصول شروطاً: يجب أن تكون عملية الرفع أو المهمة أو المرجع ملكاً للمستدعي. | + +الجزء الثاني من سطر المستودع، مثل «مفاتيح الملفات: `read` و`write`»، هو المنحة العامة التي يحتاج إليها الأشخاص ومفاتيح الملفات بدلاً من الإجراءات المحددة. انظر [منح المجموعات](#group-grants). + +إلى جانب قاعدة الوصول، يرفض الخادم أيضاً التغيير في مستودع مرآة (`409` و`mirror_read_only`)، وترفض بوابة القراءة كل تغيير (`405` و`read_only`). + +## أذونات المستودعات {#repository-permissions} + +### منح المجموعات {#group-grants} + +يحصل الأشخاص على وصول إلى المستودعات عبر **المجموعات**. يمنح المسؤول مجموعة `read` أو `write` (يُعرض بوصفه «قراءة وكتابة») على مستودع ويضيف الحسابات إلى المجموعة. في وحدة التحكم: [[ui:administration]] ثم [[ui:manageGrants]] و[[ui:saveGrant]]. استدعاءات API هي `PUT /api/v1/access-groups/{id}/grants/{repository}` مع `{"access": "read"}` أو `{"access": "write"}`، و`PUT /api/v1/access-groups/{id}/members/{userId}`. تُعاد حساب الحقوق في كل طلب، فيسري التغيير فوراً. + +تمنح `read` الإجراءات التالية: `repository.read` و`artifact.read` و`artifact.list` و`content.read` و`package.read` و`asset.read` و`annotation.read`. وتضيف `write` الإجراءات `upload.create` و`upload.read` و`upload.write` و`upload.complete` و`upload.cancel` و`job.read` و`package.publish` و`asset.write` و`asset.restore` و`annotation.write` و`reference.write` و`artifact.promote` و`audit.read`. لا يمكن الحصول على الإجراءات `artifact.delete` و`storage.read` و`storage.manage` و`diagnostics.read` من مجموعة: لا يملكها إلا مفتاح خدمة. + +### إجراءات المستودع {#repository-actions} + +يحمل مفتاح الخدمة إجراءات محددة، لكل مستودع على حدة. عددها 24: + +| الإجراء | ما يسمح به | +| ------------------ | ------------------------------------------------------------------------------------------------------ | +| `repository.read` | رؤية المستودع وحالة مرآته. | +| `artifact.read` | قراءة تفاصيل المُخرَج ومراحله وترقياته. ويلزم أيضاً مع كل تغيير على مُخرَج. | +| `artifact.list` | سرد المُخرَجات والبحث فيها، وسرد المُخرَجات ذات المراحل، وقراءة سجل الترقية وتدفق التغييرات. | +| `artifact.promote` | تعيين المراحل وإزالتها، والترقية (بالنسخ أو النقل) إلى مستودع آخر. | +| `artifact.delete` | حذف المُخرَجات، ومعاينة الاحتفاظ وتطبيقه، وإزالة صور الحاويات، وإلغاء قفل ملفات Git LFS قسرياً. | +| `content.read` | تنزيل البايتات حسب المعرّف أو الحزمة أو المسار، وإنشاء روابط تنزيل. | +| `upload.create` | إنشاء جلسات رفع. يستخدمه الدفع إلى السجلات وGit LFS. | +| `upload.read` | قراءة جلسات الرفع الخاصة بك وأجزائها. | +| `upload.write` | إرسال الأجزاء أو المحتوى الكامل لعملية رفعك. | +| `upload.complete` | إكمال عملية رفعك أو وضع إكمالها في الطابور. | +| `upload.cancel` | إلغاء عملية رفعك المعلّقة. | +| `job.read` | قراءة مهام الإكمال الخاصة بك. | +| `package.read` | سرد الحزم وتحديد الإصدارات وتنزيل الحزم. | +| `package.publish` | تسجيل أرشيف UPack كحزمة. | +| `asset.read` | سرد الملفات حسب المسار وقراءة مؤشراتها ومحفوظاتها ومراجعاتها. يحتاج تنزيل البايتات إلى `content.read`. | +| `asset.write` | توجيه مسار إلى مُخرَج أو تخزين ملف خام. | +| `asset.restore` | استعادة مراجعة سابقة لمسار. | +| `annotation.read` | قراءة التسميات وبيانات التعريف والتجميعات والمرفقات. | +| `annotation.write` | استبدال التسميات وبيانات التعريف والتجميعات والمرفقات. | +| `reference.write` | إضافة المراجع التي تحمي مُخرَجاً وإزالتها. | +| `audit.read` | قراءة تدقيق فهرس المستودع. | +| `storage.read` | قراءة الحصة والاستخدام وسياسة التخزين وإعدادات التنظيف. | +| `storage.manage` | تغيير سياسة التخزين وإعدادات التنظيف وتشغيل التنظيف. | +| `diagnostics.read` | قراءة أحداث التخزين. | + +ترد المجموعة الدقيقة التي تحتاج إليها العملية في سطرها في المرجع، مثل `upload.write` و`upload.complete` للعملية `putUploadContent`. يحتاج تغيير مستودع إلى إجراء `read` الموافق أيضاً، مثل `artifact.read` مع `annotation.write`. + +تنطبق شروط المالك على عمليات الرفع والمهام: لا تتعامل إلا مع جلسات الرفع ومهام الإكمال التي أنشأها حسابك. تُعد جميع مفاتيح حساب خدمة واحد وجميع جلسات ورموز شخص واحد المالك نفسه. لذلك تُفصل الخدمات المتعددة في مستودع واحد بالحسابات والمستودعات، وليس ببادئات المسار. + +### أذونات الإدارة والنظام {#administration-permissions} + +يوجد نوعان آخران من الأذونات ليسا إجراءات مستودع. تُسرد الإجراءات الإدارية السبعة تحت [التفويض](#delegation). ولا يملك إذني النظام `backup.read` و`backup.manage` إلا المسؤولون ومفتاح الاسترداد. + +## حدود تسجيل الدخول {#sign-in-limits} + +يبطئ الخادم تخمين كلمات المرور قبل فحص أي كلمة مرور. تُحفظ العدّادات الخاصة بالعناوين وعدّاد التسجيلات الإجمالي للخادم في ذاكرة كل عملية API وتبدأ مجدداً بعد إعادة التشغيل. تنطبق الحدود الخاصة بالعناوين لكل عنوان عميل، ويُحتسب عنوان IPv6 بحسب بادئته /64. يُخزَّن رصيد كلمات المرور الخاطئة وحالة القفل لكل حساب في PostgreSQL، وتتشاطرهما جميع عمليات API ويستمران بعد إعادة التشغيل. خلف وكيل عكسي، اضبط `ARKVORY_TRUSTED_PROXIES`، وإلا يظهر كل عميل بوصفه الوكيل. + +| الحد | القيمة | +| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| محاولات تسجيل الدخول لكل عنوان | دفعة من 10، ثم محاولة إضافية كل 15 ثانية. لا يستهلك تسجيل الدخول الناجح محاولة. | +| كلمات المرور الفاشلة لكل حساب | تضيف كل كلمة مرور خاطئة 1 إلى رصيد ينخفض بمقدار 1 كل 6 ثوانٍ. فوق 20، يرفض الحساب المحاولات لمدة 1 ثانية، تتضاعف مع كل فشل إضافي حتى 2 دقيقة؛ وخلال ذلك تتلقى حتى كلمة المرور الصحيحة `429`. يُمسح الرصيد عند نجاح تسجيل الدخول أو نجاح المستخدم في تغيير كلمة مروره أو إعادة تعيين كلمة المرور بواسطة المسؤول. | +| التسجيلات لكل عنوان | ‏3، ثم تسجيل إضافي كل 20 دقيقة. | +| التسجيلات لكل خادم | ‏20، ثم تسجيل إضافي كل 3 دقائق. | +| طلبات تسجيل الدخول الجارية | ‏16 لكل عملية API، وللجسم 10 ثوانٍ للوصول. يعيد التجاوز `503` بالرمز `busy`. | + +تعيد المحاولة المرفوضة الاستجابة `429` بالرمز `rate_limited` والسبب `login_attempts` أو `registration_attempts` أو `password_attempts`، و`Retry-After` بالثواني. انتظر تلك المدة؛ ولا تكرر في حلقة. خارج فترة القفل المؤقت، يؤدي إدخال كلمة المرور الحالية بشكل خاطئ عند تغيير المستخدم كلمة مروره إلى زيادة الرصيد نفسه الخاص بالحساب، ويعيد `401` بالسبب `current_password_invalid`. أثناء القفل المؤقت، يعيد تغيير كلمة المرور `429` بالسبب `password_attempts`. تُصفّر إعادة تعيين كلمة المرور بواسطة المسؤول هذا الرصيد. ميزانية المحاولات لكل عنوان مستقلة عن رصيد الحساب. تُكتب جميع عمليات تسجيل الدخول والتسجيل وتغيير كلمات المرور وتغيير الرموز في التدقيق الأمني (`GET /api/v1/security/audit`، للمسؤولين فقط)، الذي يحتفظ بـ365 يوماً. + +## صفحات ذات صلة {#related} + +- [نظرة عامة على HTTP API](./index) +- [الأخطاء](./errors) +- [الحسابات والوصول](../use/accounts) +- [الأمان](../operate/security) +- [العملاء والبروتوكولات](../protocols/index) +- المرجع: [الحسابات وتسجيل الدخول](./reference/accounts)، و[حسابات الخدمة والمفاتيح](./reference/services) diff --git a/wiki/ar/api/index.md b/wiki/ar/api/index.md index a0d0ce2b..40a11a7f 100644 --- a/wiki/ar/api/index.md +++ b/wiki/ar/api/index.md @@ -1,12 +1,219 @@ --- -title: 'HTTP API overview' -description: 'The rules every integration with the Arkvory HTTP API needs: JSON and sizes, discovery, pagination, revisions, idempotency, retries, ranges, errors and limits.' +title: 'نظرة عامة على HTTP API' +description: 'القواعد اللازمة لكل تكامل مع HTTP API في Arkvory: ‏JSON والأحجام والاكتشاف وترقيم الصفحات والمراجعات ومنع التكرار وإعادة المحاولة والنطاقات والأخطاء والحدود.' --- - +# نظرة عامة على HTTP API -::: warning -لم تُترجم هذه الصفحة بعد، وهي معروضة بالإنجليزية. -::: +واجهة HTTP API هي الواجهة التي تستخدمها وحدة تحكم الويب وعميل سطر الأوامر وحزمة SDK. يمكن لتكاملك تنفيذ كل ما تنفذه بأي لغة. تشرح هذه الصفحة القواعد التي تسري على كل عملية. تسرد الصفحات ضمن [صفحات المرجع](#reference-pages) كل عملية مع قاعدة الوصول إليها وقاعدة إعادة المحاولة ومعلماتها واستجاباتها، وتُولّد من العقد الذي يفرضه الخادم. - +## الأساسيات {#basics} + +- **المسار الأساسي.** تقع كل عملية تحت `/api/v1`، مثل `https://arkvory.example/api/v1/repositories`. الاستثناء الوحيد هو فحوص الصحة تحت `/health`. +- **الصيغة.** الطلبات والاستجابات بصيغة JSON ‏(`application/json`). يقتصر جسم JSON على 64 KiB، ويتلقى الطلب الذي يرسل نوع محتوى آخر لعملية JSON الاستجابة `415`. تُرسل بايتات الملفات بصيغة `application/octet-stream`. +- **الحقول المجهولة.** ترفض معظم العمليات طلباً يحتوي على حقل لا تعرّفه (`400`، مع الحقل في `details`). في الاستجابات، تجاهل الحقول التي لا تعرفها. +- **الأوقات** طوابع زمنية وفق RFC 3339 بتوقيت UTC. **معرّفات** المُخرَجات وعمليات الرفع والمهام والحسابات والمفاتيح من نوع UUID. +- **الأسماء.** يطابق اسم المستودع النمط `[a-z0-9][a-z0-9_-]{0,63}`. يتكون اسم الملف (اسم المُخرَج) من 240 محرفاً كحد أقصى ولا يتضمن `/` أو `\`. يصل المسار في المستودع إلى 1,024 محرفاً. +- **التخزين المؤقت.** تحمل الاستجابات `Cache-Control: private, no-store`. +- **البروتوكولات الأخرى.** تتبع المسارات `/v2` (الحاويات) و`/lfs` ‏(Git LFS) و`/npm` مواصفات عملائها وتستخدم صيغ أخطاء خاصة بها. وليست جزءاً من مستند OpenAPI. انظر [العملاء والبروتوكولات](../protocols/index). + +### الأحجام والأعداد {#sizes} + +لا يستطيع رقم JSON تمثيل كل قيمة من 64 بت. لذلك يرسل Arkvory **الأحجام وعدّادات البايتات كسلاسل نصية عشرية**: `"size": "1048576"`. وينطبق الأمر نفسه على الحجم الذي تعلنه عند إنشاء عملية رفع. ليس للحجم إشارة أو أصفار بادئة، ولا يتجاوز 16 رقماً. الأعداد والمراجعات والحدود وفهارس الأجزاء أعداد صحيحة عادية في JSON. + +أكبر كائن هو 10,000 GiB ‏(10 737 418 240 000 بايت)، ما لم يضبط المسؤول قيمة أقل لـ`ARKVORY_MAX_OBJECT_BYTES`. يُرفض الحجم المعلن الأكبر بالاستجابة `400`. + +## المصادقة {#authentication} + +تحتاج كل عملية، باستثناء تسجيل الدخول والتسجيل الذاتي وفحوص الصحة العامة وخيارات تسجيل الدخول، إلى بيانات اعتماد في الترويسة `Authorization: Bearer `. لا يحتاج التسجيل الذاتي (`POST /api/v1/auth/register`، `registerAccount`) إلى بيانات اعتماد، ولا يمكن أن ينجح إلا عندما يضبط المسؤول `ARKVORY_ALLOW_REGISTRATION=true`؛ وإذا كان معطّلاً فإنه يعيد `403` والسبب `registration_disabled`. قد تكون بيانات الاعتماد جلسة وحدة تحكم أو رمز وصول شخصياً أو مفتاح خدمة أو مفتاح الاسترداد. يعتمد ما تستطيع فعله على نوعها وعلى **قاعدة الوصول** لكل عملية. اقرأ [المصادقة](./authentication) قبل تصميم التكامل، وامنح الأتمتة مفتاح خدمة بالإجراءات التي تحتاج إليها فقط. + +## الاكتشاف {#discovery} + +يمكن للعميل سؤال الخادم عما يدعمه بدلاً من التخمين. تتطلب جميع الطلبات التالية بيانات اعتماد. + +| الطلب | الاستجابة | +| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `GET /api/v1/capabilities` | إصدارات API ‏(`v1`)، ودور البوابة (`api` أو `reader`)، وأعلام الميزات وحدود هذا الخادم: `maxObjectBytes` و`partBytes` (أصغر جزء، 8 MiB) و`maxPartBytes` ‏(1 GiB) و`maxParts` ‏(10,000) و`maxPageSize` ‏(100). | +| `GET /api/v1/operations` | العمليات التي يُرجح أن بيانات الاعتماد هذه تستطيع استدعاءها، ولكل منها `operationId` والطريقة والمسار و`surface` وفئة `retry` والإجراءات المطلوبة والشروط المتبقية. رشّح باستخدام `repository` و`surface` و`after` و`limit` (من 1 إلى 100، و50 افتراضياً). القائمة استرشادية: الطلب الفعلي وحده هو الحاسم. | +| `GET /api/v1/openapi.json` | مستند OpenAPI 3.0.3 لواجهة API الكاتبة. أضف `?surface=` للحصول على مجال واحد فقط. | +| `GET /api/v1/auth/permissions` | إجراءات بيانات الاعتماد المستدعية لكل مستودع. | +| `GET /api/v1/auth/me` | هوية بيانات الاعتماد ونوعها ومنحها العامة `read`/`write`. | +| `GET /api/v1/repositories` | المستودعات التي يجوز لبيانات الاعتماد رؤيتها. | + +استخدم `capabilities` لقراءة الحدود بدلاً من تثبيتها في التعليمات البرمجية. عامل علم الميزة الذي لا تعرفه بوصفه `false`. + +### المجالات {#surfaces} + +تُجمع العمليات في ستة **مجالات**. هي تسميات في العقد وليست خدمات منفصلة؛ ولا تتغير عناوين URL. + +| المجال | ما يشمله | +| ---------------- | ------------------------------------------------------------------------------------ | +| `discovery` | الإمكانات وفهرس العمليات وOpenAPI والمستودعات | +| `identity` | تسجيل الدخول وهوية المستدعي نفسه والرموز وتفعيل المفاتيح | +| `catalog` | المُخرَجات والتعليقات الوصفية والحزم والملفات حسب المسار والمراحل والترقية والمرفقات | +| `transfers` | جلسات الرفع والأجزاء ومهام الإكمال والتنزيلات | +| `administration` | الحسابات والمجموعات وحسابات الخدمة والمفاتيح والتفويضات والتحديثات والنسخ الاحتياطية | +| `operations` | حيوية العملية والجاهزية والمقاييس والملاحظات | + +فحوص الصحة هي `GET /health/live` (العملية تعمل) و`GET /health/status` (عام؛ `{"status":"ready"}` أو `unavailable`) دون بيانات اعتماد، و`GET /health/ready` و`GET /health/metrics` مع بيانات اعتماد. لا تستخدم ميزانية الطلبات، لذلك لا يجعل الحمل موازن الأحمال يستبعد الخادم. + +## ترقيم الصفحات {#pagination} + +تُعاد القائمة صفحة تلو الأخرى. تحتوي الاستجابة على `items` و`next`. عندما لا تكون `next` بقيمة `null`، أعد إرسالها دون تغيير في معلمة الاستعلام `after` لقراءة الصفحة التالية؛ وعندما تكون `null`، تكون القائمة مكتملة. عامل المؤشر كسلسلة نصية معتمة ولا تبنِ مؤشراً بنفسك. + +يضبط `limit` حجم الصفحة، من 1 إلى 100. تعيد معظم القوائم 50 عنصراً عند حذفه. الصفحات ليست لقطة ثابتة: قد تظهر العناصر التي تصل أثناء القراءة وقد لا تظهر. يجب إبقاء المرشحات وترتيب الفرز كما هما أثناء تتبع `next`. + +## المراجعات والمقارنة والاستبدال {#revisions} + +للأشياء التي يحررها الأشخاص **مراجعة** يبدأ ترقيمها من 1: تسميات المُخرَج وبيانات تعريفه وتجميعاته، ومرفقات نسخة البناء، ومسار الملف، وسياسة التخزين، وخطة النسخ الاحتياطي، وإعدادات حساب الخدمة. يحدد التغيير المراجعة التي يتوقعها في جسم الطلب باسم `expectedRevision`: + +```json +{ "expectedRevision": 3, "value": { "labels": ["tested"], "metadata": {}, "collections": [] } } +``` + +إذا لم تكن المراجعة الحالية 3، لا يتغير شيء ويجيب الخادم بالاستجابة `409` والسبب `revision_mismatch`. هذه هي **المقارنة والاستبدال**. اقرأ الحالة مجدداً، وطبّق تغييرك عليها، وأرسل المراجعة الجديدة. لا تكرر المحاولة أبداً برقم أكبر لفرض الكتابة. استخدم `0` لشيء لم يوجد بعد، مثل مسار جديد. لا تستخدم واجهة API الترويسة `If-Match`. + +**للمُخرَج المنزّل** مدقق مختلف هو `ETag`. انظر [تنزيلات النطاق وETag](#range-downloads). + +## مفاتيح منع التكرار {#idempotency} + +تجعل الترويسة `Idempotency-Key` الطلب المكرر يُحدث أثره مرة واحدة. استخدم قيمة من 1 إلى 128 محرفاً من الأحرف والأرقام و`_ . : -`، واحفظها مع حالة المهمة قبل الطلب الأول، كي تكرر المهمة المعاد تشغيلها المفتاح نفسه. تتطلب عمليات الكتابة التالية مفتاحاً: + +| العملية | التكرار بالمفتاح نفسه والجسم نفسه | +| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | +| `createUpload` | يعيد جلسة الرفع نفسها. | +| `issueServiceKey` و`rotateServiceKey` | يعيد بيانات تعريف المفتاح بالاستجابة `200` دون السر. أبطل المفتاح وأصدر آخر إذا فقدت السر. | +| `requestBackupRun` و`requestBackupVerify` و`requestBackupRetention` | يعيد الطلب نفسه بدلاً من إضافة طلب آخر إلى الطابور. | + +يُرفض المفتاح نفسه مع جسم مختلف بالاستجابة `409` والسبب `idempotency_mismatch`. نطاق المفتاح هو المستدعي والهدف، لذلك يمكن لمستدعيين استخدام القيمة نفسها. + +يمكن تكرار عمليات الكتابة الأخرى بأمان لسبب آخر: فهي تضبط حالة (تعيين مرحلة أو تسجيل حزمة أو إبطال مفتاح)، أو تستخدم المقارنة والاستبدال. يوضح القسم التالي ذلك لكل فئة. + +## قواعد إعادة المحاولة {#retry-rules} + +لكل عملية **فئة إعادة محاولة**. تحدد الفئة ما يجب على العميل فعله إذا لم يتلق الاستجابة. يعرضها المرجع باسم «إعادة المحاولة» لكل عملية. + +| الفئة | المعنى | الإجراء | +| ------------------ | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- | +| `read` | لا تغيّر القراءة شيئاً. | كرر مع تأخير متزايد. | +| `idempotent` | للطلب نفسه الأثر نفسه. | كرر. قد تختلف الاستجابة في التفاصيل: قد يُبلغ الحذف للمرة الثانية بأن الكائن لم يعد موجوداً. | +| `idempotency-key` | آمنة فقط مع مفتاح. | كرر باستخدام `Idempotency-Key` نفسه والجسم نفسه. | +| `compare-and-swap` | تغيير يعتمد على مراجعة. | اقرأ الحالة، واتخذ القرار مجدداً، وكرر بالمراجعة التي قرأتها. لا ترفع `expectedRevision` أبداً لتجاوز `409`. | +| `reconcile-upload` | خطوة من جلسة رفع. | اقرأ عملية الرفع وأجزاءها أولاً (`getUpload` و`listUploadParts`)، ثم أرسل المفقود. لا يمكن متابعة `PUT` لملف كامل من منتصفه: يبدأ مجدداً من البايت صفر. | +| `reconcile-job` | وضع مهمة إكمال في الطابور. | اقرأ المهمة (`getCompletionJob`) أولاً. يمكن إعادة وضع مهمة فاشلة في الطابور. | +| `never-automatic` | قد ينفّذ التكرار الإجراء مرتين. | لا تكرر تلقائياً. افحص النتيجة ثم قرر. أمثلة: إنشاء حساب أو رمز أو رابط تنزيل، أو تشغيل سياسة تخزين، أو إرسال ملاحظات. | + +عطل الشبكة والحالات `408` و`429` و`502` و`503` و`504` مؤقتة: كرر وفق الفئة، وانتظر مدة لا تقل عما تحدده `Retry-After`، وأضف تأخيراً أُسّياً متزايداً مع حد لعدد المحاولات. لا تكرر `401` و`403` واستجابات `4xx` الأخرى دون تغيير الطلب. لا تكرر `500` عشوائياً؛ أعطِ معرّف الطلب للدعم. بعد `503` على تغيير، تكون النتيجة مجهولة، لذا استخدم الفئة لمعرفة ما حدث. تطبق حزمة SDK وعميل سطر الأوامر هذه القواعد. + +## تنزيلات النطاق وETag {#range-downloads} + +تعيد `GET` و`HEAD` للمسار `…/artifacts/{id}/content` البايتات الأصلية مع `ETag` قوي بالصيغة `"sha256:"` و`Accept-Ranges: bytes`. ينطبق الأمر نفسه على التنزيل حسب الحزمة (`…/packages/content`) وحسب مسار الملف (`…/asset/content` و`…/raw/{path}`). تبحث هذه الطلبات عن المُخرَج الحالي في كل مرة؛ ويسمي `packages/content` و`raw` المُخرَج المختار في `X-Arkvory-Artifact-Id`، كي تستطيع تثبيته للاستئناف. + +- تعيد `Range: bytes=0-1023` و`bytes=1024-` و`bytes=-1024` الاستجابة `206` مع `Content-Range`. يقدم الخادم نطاقاً واحداً؛ ويجيب عن قائمة نطاقات بالملف الكامل. +- تعيد بداية تتجاوز نهاية الملف الاستجابة `416` والرمز `invalid_input` والسبب `range_not_satisfiable` و`Content-Range: bytes */`. +- للاستئناف، أرسل `Range` مع `If-Range: ""`. إذا تغيّر المحتوى خلف الاسم، تختلف `ETag` وتتلقى الملف الجديد كاملاً بدلاً من ملف مختلط. +- تعيد `If-None-Match` مع `ETag` الاستجابة `304` دون جسم. +- تحقق من SHA-256 لما حفظته. تحمله ETag. + +يعمل رابط التنزيل (`?token=`) على مسار محتوى مُخرَج واحد. انظر [المصادقة](./authentication#download-links). + +## الأخطاء {#errors} + +لكل فشل غلاف JSON نفسه: `code` و`message` و`requestId`، وعندما تتوفر تفاصيل إضافية، `reason` و`details` و`retryAfterSeconds`. اتخذ القرار بناءً على `code` و`reason`، وليس `message` أبداً. تُعامل الأسباب المجهولة كأنها غائبة، ويُعالج `code` المجهول وفق حالة HTTP. انظر [الأخطاء](./errors). + +## حدود المعدل والخوادم المشغولة {#rate-limits} + +لا يحتسب Arkvory استدعاءات API لكل دقيقة. بل يحدّ مقدار ما ينفذه في الوقت نفسه، ويحدّ محاولات تخمين كلمة المرور: + +- **الانشغال.** يقبل الخادم عدداً ثابتاً من الطلبات وعمليات النقل في الوقت نفسه (`ARKVORY_MAX_REQUESTS`، افتراضياً 128؛ و2 رفع و16 تنزيلاً افتراضياً). قد تنتظر عملية النقل في طابور محدود حتى 20 ثانية. عند عدم وجود موضع، تكون الاستجابة `503` بالرمز `busy`. كرر بعد `Retry-After`. +- **السعة.** يعيد استنفاد احتياطي القرص أو بلوغ حصة أو حد لعدد الكائنات الاستجابة `507`، ولا يتحسن ذلك بالانتظار. +- **المحاولات.** يعيد تكرار محاولات تسجيل الدخول أو التسجيل أو كلمات المرور أو الملاحظات أكثر من المسموح الاستجابة `429` بالرمز `rate_limited`. انظر [المصادقة](./authentication#sign-in-limits). + +تحمل كل من `429` و`503` الترويسة `Retry-After` بالثواني (2 عندما لا يملك الخادم تقديراً)، والعدد نفسه في `retryAfterSeconds`. إذا مر الطلب عبر وكيل، فقد يضيف الوكيل حدوده الخاصة. + +## معرّفات الطلبات {#request-ids} + +لكل استجابة ترويسة `X-Request-Id`، ويحمل كل خطأ القيمة نفسها في `requestId`. سجّلها مع مهمتك واذكرها للدعم. لا يُستخدم معرّف الطلب الذي ترسله إلا إذا وصل عبر وكيل مُدرج في `ARKVORY_TRUSTED_PROXIES` وتكوّن من 8 إلى 128 محرفاً آمناً؛ وإلا ينشئ الخادم معرّفاً جديداً. لا تُسجل ترويسة W3C ‏`traceparent` إلا في سجل وصول الخادم. + +## المتصفحات وCORS {#cors} + +تعمل صفحة الويب على عنوان Arkvory نفسه دون أي إعداد. ولا تعمل صفحة على عنوان آخر إلا إذا أدرج المسؤول أصلها المطابق تماماً في `ARKVORY_CORS_ORIGINS` (حتى 16، باستخدام HTTPS أو HTTP للحلقة المحلية). يتلقى أصل آخر الاستجابة `403` بالسبب `origin_not_allowed`، حتى عندما يكون المفتاح صالحاً. لا تستخدم الطلبات ملفات تعريف الارتباط أبداً: أرسل المفتاح في الترويسة `Authorization` واحتفظ به في الذاكرة. انظر [متغيرات البيئة](../reference/environment). + +## ضمان التوافق {#evolution} + +لا تتغير `/api/v1` إلا بالإضافة: عمليات جديدة، وحقول طلب اختيارية جديدة، وحقول استجابة جديدة، وأسباب أخطاء جديدة، وأعلام ميزات جديدة. يحصل التغيير الذي سيكسر توافق العميل، مثل معنى مختلف أو حقل إلزامي جديد أو حالة مختلفة أو ترقيم صفحات مختلف، على إصدار API جديد وفترة يعمل فيها الإصداران معاً. في المقابل، يجب أن يفعل عميلك ما يلي: + +- تجاهل حقول الاستجابة التي لا يعرفها؛ +- معاملة `reason` المجهول كأنه غائب، ومعالجة `code` المجهول وفق حالة HTTP؛ +- أخذ الحدود من `capabilities`؛ +- إرسال الحقول التي تعرّفها العملية فقط. + +قيم `operationId` أسماء ثابتة. استخدمها عند ربط العمليات بتعليماتك البرمجية. + +## مثال: رفع ملف واحد وتنزيله {#example} + +يرفع هذا التسلسل ملفاً في طلب واحد. للملفات الأكبر من بضعة غيغابايت أو الروابط غير الموثوقة، استخدم [`arkvoryctl`](../protocols/cli) أو [حزمة SDK](../protocols/sdk): يرسلان الأجزاء ويتابعان بعد الفشل. يستخدم المثال `jq` لقراءة JSON. + +أولاً، اضبط العنوان والمفتاح، واحسب حجم الملف وSHA-256 الخاص به: + +```bash +export ARKVORY_URL=https://arkvory.example +export ARKVORY_KEY="$(cat ~/.arkvory/key)" +FILE=./Setup.exe +SIZE=$(stat -c %s "$FILE") +SHA=$(sha256sum "$FILE" | cut -d ' ' -f 1) +``` + +**الخطوة 1. حجز الرفع.** يعيد `Idempotency-Key` نفسه الجلسة نفسها، لذلك يمكنك تكرار هذا الاستدعاء بأمان. + +```bash +ID=$(curl -fsS -X POST "$ARKVORY_URL/api/v1/repositories/releases/uploads" \ + -H "Authorization: Bearer $ARKVORY_KEY" \ + -H "Idempotency-Key: build-1042-setup" \ + -H "Content-Type: application/json" \ + -d "{\"name\":\"Setup.exe\",\"size\":\"$SIZE\",\"sha256\":\"$SHA\",\"labels\":[\"nightly\"]}" \ + | jq -r .id) +``` + +**الخطوة 2. إرسال البايتات.** ينشر الخادم المُخرَج عندما يتطابق الحجم وSHA-256. + +```bash +curl -fsS -X PUT "$ARKVORY_URL/api/v1/repositories/releases/uploads/$ID/content" \ + -H "Authorization: Bearer $ARKVORY_KEY" \ + -H "Content-Type: application/octet-stream" \ + -T "$FILE" | jq '{id, status}' +``` + +**الخطوة 3. تنزيله.** معرّف المُخرَج هو معرّف الرفع. + +```bash +curl -fL -o Setup-copy.exe \ + -H "Authorization: Bearer $ARKVORY_KEY" \ + "$ARKVORY_URL/api/v1/repositories/releases/artifacts/$ID/content" +sha256sum Setup-copy.exe +``` + +تجيب الخطوة 2 بـ`{"id": "…", "status": "available"}`. إذا انقطع الاتصال أثناء الخطوة 2، فاقرأ عملية الرفع باستخدام `GET …/uploads/$ID`: ما دامت حالتها `pending`، أرسل الملف مجدداً من البداية. تعيش جلسة الرفع 7 أيام. يحتاج المفتاح إلى الإجراءات `upload.create` و`upload.write` و`upload.complete` و`content.read` على `releases`. انظر [الرفع](./reference/uploads) و[عمليات النقل](../use/transfers). + +## صفحات المرجع {#reference-pages} + +تسرد كل صفحة عمليات مجموعة واحدة مع قاعدة الوصول وفئة إعادة المحاولة والمعلمات والاستجابات. + +- [النظام والصحة](./reference/system): حيوية العملية والجاهزية والمقاييس وOpenAPI والإمكانات +- [المستودعات](./reference/repositories) +- [الرفع](./reference/uploads) +- [المُخرَجات والفهرس](./reference/artifacts) +- [الحزم](./reference/packages) +- [الملفات حسب المسار](./reference/files) +- [المراحل والترقية](./reference/promotion) +- [سياسات التخزين والاحتفاظ](./reference/storage) +- [المرايا](./reference/mirrors) +- [روابط التنزيل](./reference/links) +- [مرفقات نسخ البناء](./reference/attachments) +- [الحسابات وتسجيل الدخول](./reference/accounts) +- [حسابات الخدمة والمفاتيح](./reference/services) +- [النسخ الاحتياطية](./reference/backups) +- [التحديثات](./reference/updates) +- [الملاحظات](./reference/feedback) + +صفحات ذات صلة: [المصادقة](./authentication)، و[الأخطاء](./errors)، و[حزمة TypeScript SDK](../protocols/sdk). diff --git a/wiki/ar/guide/agents.md b/wiki/ar/guide/agents.md index a2146ad6..d899fa89 100644 --- a/wiki/ar/guide/agents.md +++ b/wiki/ar/guide/agents.md @@ -1,12 +1,84 @@ --- -title: 'AI agents' -description: 'Let an AI agent such as Claude Code find, download, publish and promote artifacts through arkvoryctl mcp and the Arkvory agent skill.' +title: وكلاء الذكاء الاصطناعي +description: 'استخدم arkvoryctl mcp ومهارة وكيل Arkvory لتمكين وكيل ذكاء اصطناعي مثل Claude Code من البحث عن المُخرَجات وتنزيلها ونشرها وترقيتها.' --- - +# وكلاء الذكاء الاصطناعي -::: warning -لم تُترجم هذه الصفحة بعد، وهي معروضة بالإنجليزية. -::: +يمكن لعميل وكيل ذكاء اصطناعي يدعم بروتوكول سياق النموذج (MCP)، مثل Claude Code، العمل مع Arkvory من خلال `arkvoryctl mcp`. يشغّل العميل الأمر ويتواصل معه عبر الإدخال والإخراج القياسيين، دون فتح منفذ شبكة. وتعلّم مهارة الوكيل كيفية تنفيذ مسارات العمل بأمان باستخدامه. - +## قبل البدء {#before} + +1. ثبّت [عميل سطر الأوامر](../protocols/cli) على الجهاز الذي يعمل عليه الوكيل. +2. أنشئ للوكيل مفتاح خدمة لا يتيح الوصول إلا إلى المستودعات والإجراءات اللازمة. احفظه في ملف لا يستطيع قراءته سواك. +3. أضف ملف تعريف يشير إلى ملف المفتاح وتحقّق منه: + +```bash +arkvoryctl profile add agent --server https://arkvory.example --token-file ~/.config/arkvory/agent.key --repository builds +arkvoryctl doctor --profile agent +``` + +لا تلصق المفتاح في المحادثة أو في وسيطة أمر أو ملف مشروع. لا يرى الوكيل المفتاح، إذ لا تتضمنه النتائج أو الأخطاء. + +## توصيل خادم MCP {#connect} + +```bash +claude mcp add arkvory -- arkvoryctl mcp --profile agent --root ~/work +``` + +من دون `--write`، يعمل الخادم للقراءة فقط: يستطيع الوكيل سرد المستودعات والبحث فيها جميعًا، وقراءة المُخرَجات والحزم والملفات حسب المسار وتدفّق التغييرات وحالة التثبيت، وتنزيل المُخرَجات. لا تُعرض الأدوات التي لا يسمح المفتاح باستخدامها. يجب أن يدعم العميل MCP 2025-06-18 أو أحدث. + +## السماح بالكتابة {#write} + +للكتابة إعداد منفصل. حدّد المستودعات التي يجوز للوكيل الكتابة إليها: + +```bash +claude mcp add arkvory-publish -- arkvoryctl mcp --profile agent --root ~/work --write --write-repositories builds +``` + +| الأداة | وظيفتها | +| ------------------------- | ------------------------------------------------------------------------------------- | +| `arkvory_upload` | ترفع ملفًا كمُخرَج جديد أو كمراجعة تالية لمسار ملف | +| `arkvory_publish_package` | ترفع UPack وتسجّله كإصدار حزمة | +| `arkvory_promote` | تضيف مرحلة؛ وعند تحديد `sha256`، لا تطبّقها إلا على المُخرَج المطابق لتلك البايتات تمامًا | +| `arkvory_stage_remove` | تزيل مرحلة مع الإبقاء على المُخرَج | +| `arkvory_annotate` | تستبدل التسميات وبيانات التعريف عند المراجعة التي قرأها الوكيل | + +- تُرفض الكتابة إلى مستودع غير مدرج في `--write-repositories` قبل إرسال أي شيء (`repository_not_allowed`). ويتحقّق الخادم أيضًا من أذونات المفتاح. +- لا يمكن حذف أي شيء أو استعادته، ولا تُنشأ روابط تنزيل. تظل هذه مهامًا ينفّذها شخص في وحدة التحكم. +- يوجّه الخادم الوكيل إلى وصف كل عملية كتابة وانتظار تأكيدك. وقد يطلب عميل MCP التأكيد قبل كل استدعاء أيضًا. +- يمكن استئناف الرفع: بعد فشل العملية، يكرّر الوكيل الاستدعاء نفسه، فيُعاد المُخرَج نفسه بدل إنشاء مُخرَج ثانٍ. تتضمن النتيجة SHA-256 للملف الذي جرت قراءته. + +## الملفات والحدود {#files} + +- يقرأ الوكيل الملفات المحلية ويكتبها فقط داخل `--root`، الذي يكون افتراضيًا الدليل الحالي. يُرفض أي مسار يؤدي إلى خارجه، بما في ذلك عبر رابط (`path_outside_root`). +- لا يظهر الملف المنزّل إلا بعد التحقّق من حجمه ومن SHA-256. ولا يُستبدل ملف موجود إلا إذا طلب الوكيل ذلك. +- لا يُرفع ملف يحتوي على المفتاح مطلقًا (`source_contains_credential`). كما لا تُقرأ ملفات arkvoryctl الخاصة ولا تُستبدل، حتى داخل `--root`، ومنها ملفات التعريف وملفات المفاتيح ونقاط استئناف الرفع (`private_path`). +- لا تتجاوز النتيجة الواحدة `--max-output-bytes`، وقيمته الافتراضية 64 KiB وحدّه الأقصى 1 MiB، ولا تتجاوز 100 عنصر. لطلب المزيد، يمرّر الوكيل قيمة `next` في `after`. + +## تثبيت المهارة {#skill} + +المهارة مجموعة تعليمات للوكيل تشرح كيفية البحث والتحقّق من التنزيلات والنشر والترقية وقراءة رموز الأخطاء، وما يجب عليه ألا يفعله مطلقًا. وهي مرفقة بالعميل: + +```bash +arkvoryctl skill install +``` + +تُثبَّت المهارة في `~/.claude/skills/arkvory`. استخدم `--target DIR` لتثبيتها داخل مشروع، مثل `.claude/skills/arkvory`. يؤدي تكرار الأمر إلى تحديث الملفات التي لم تعدّلها. أما الملفات التي عدّلتها فتبقى محفوظة: يتوقف الأمر دون تغيير أي شيء ما لم تضف `--force`. + +## الأمان {#safety} + +- يكتب أشخاص آخرون الأسماء والتسميات وبيانات التعريف والتعليقات التي تظهر في النتائج. يعاملها الوكيل كبيانات ولا يتبع أي تعليمات واردة فيها. +- افصل إعداد القراءة فقط عن إعداد الكتابة، ولا تسمح بالكتابة إلا إلى المستودعات التي تتطلبها المهمة. +- استخدم مفتاحًا مخصصًا بصلاحيات محدودة، وأبطله من وحدة التحكم عندما لا يعود الوكيل بحاجة إليه. + +## استكشاف الأخطاء وإصلاحها {#troubleshooting} + +| الخطأ | السبب والحل | +| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| لا توجد أدوات كتابة | شُغّل الخادم دون `--write`، أو أن المفتاح يفتقر إلى الإذن. | +| `repository_not_allowed` | المستودع غير مدرج في `--write-repositories`. عدّل إعداد MCP. | +| `forbidden` | المفتاح يفتقر إلى الإذن. شغّل `arkvoryctl doctor` لعرض الأذونات. | +| `path_outside_root` | الملف خارج `--root` أو ليس ملفًا عاديًا. | +| `state_locked` | لا تزال عملية الرفع نفسها تعمل في استدعاء آخر. بعد تعطل العملية، تأكّد من عدم وجود `arkvoryctl mcp` يرفع ذلك الملف، ثم احذف ملف `.lock` من `mcp-uploads` داخل دليل CLI، وهو `~/.config/arkvory`. | +| `skill_modified` | عدّلت ملفًا من ملفات المهارة. احتفظ بنسختك أو أعد تشغيل `arkvoryctl skill install` مع `--force`. | diff --git a/wiki/ar/guide/concepts.md b/wiki/ar/guide/concepts.md index 709af9e1..d534c890 100644 --- a/wiki/ar/guide/concepts.md +++ b/wiki/ar/guide/concepts.md @@ -1,12 +1,128 @@ --- -title: 'Concepts' -description: 'The ideas the rest of the documentation uses, from installation and repositories to access, retention, backups and mirrors.' +title: المفاهيم +description: المفاهيم المستخدمة في بقية الوثائق، من التثبيت والمستودعات إلى الوصول والاحتفاظ والنسخ الاحتياطية والمرايا. --- - +# المفاهيم -::: warning -لم تُترجم هذه الصفحة بعد، وهي معروضة بالإنجليزية. -::: +تشرح هذه الصفحة المصطلحات المستخدمة في الصفحات الأخرى. يقدم كل قسم شرحًا قصيرًا ورابطًا إلى الصفحة التي تتناول الموضوع بالتفصيل. وللاطلاع على تعريفات موجزة، راجع [مسرد المصطلحات](../reference/glossary). - +## التثبيت وخدماته {#installation} + +يعمل التثبيت القياسي على خادم واحد. ويشغّل ثلاث خدمات Arkvory إلى جانب قاعدة بيانات PostgreSQL واحدة: + +| المكوّن | وظيفته | +| -------------------- | --------------------------------------------------------------------------------------------------------------------------------- | +| API | خادم HTTP: واجهة HTTP API و[وحدة التحكم عبر الويب](./console) وسجلات الحاويات وGit LFS وnpm. وينفّذ أيضًا الاحتفاظ والتنظيف الفعلي. | +| العامل | مهام الخلفية: إكمال عمليات الرفع الكبيرة ومزامنة المرايا. | +| وكيل النسخ الاحتياطي | إنشاء نسخ احتياطية مجدولة في مخزن النسخ الاحتياطية. | +| PostgreSQL | الفهرس: المُخرَجات والحزم والمراجعات والحسابات والمفاتيح والمهام. | + +تُحفظ محتويات الملفات في دليل محلي على الخادم، وليس في قاعدة البيانات. وتوجد جميع المكوّنات داخل **جذر التثبيت**، وهو `C:\ProgramData\ProAnima\Arkvory` على Windows و`/opt/proanima-arkvory` على Linux. تبدأ الخدمات دون تسجيل دخول مستخدم، وتُعاد بعد التعطل أو التوقف عن الاستجابة ([التعافي الذاتي](../operate/self-healing)). + +التثبيت على خادم واحد ليس إعدادًا عالي التوافر. إذا توقف الخادم، ينتظر العملاء ثم يستأنفون عمليات النقل. راجع [اختيار طريقة التثبيت](../install/index). ويمكن لخادمين أو ثلاثة على Linux تشكيل [عنقود عالي التوافر](../operate/cluster). + +## المستودعات {#repositories} + +**المستودع** مساحة محتوى ذات اسم. له قواعد وصول وسياسة تخزين خاصتان به، تشملان الحصة والاحتفاظ، ويمكن أن يكون له مصدر مرآة. يتكون الاسم من 1 إلى 64 محرفًا: أحرف لاتينية صغيرة وأرقام و`-` و`_`، ويبدأ بحرف أو رقم. + +لا تنشئ مستودعًا بأمر منفصل. يصبح المستودع موجودًا بمجرد منح مجموعة صلاحية الوصول إلى اسمه أو إدراج اسمه في سياسة حساب خدمة. يتضمن التثبيت الجديد مكانًا للمستودع الأول باسم `releases`. راجع [المستودعات](../use/repositories). + +## المُخرَجات {#artifacts} + +**المُخرَج** ملف واحد مخزّن. وهو **غير قابل للتغيير**: لا تتغير بايتاته مطلقًا. له UUID واسم لا يتجاوز 240 محرفًا ولا يتضمن `/` أو `\`، وحجم ومجموع تحقق SHA-256. ينشئ المحتوى الجديد مُخرَجًا جديدًا ولا يستبدل القديم. + +لا يظهر المُخرَج إلا بعد أن يتحقّق الخادم من تطابق البايتات مع الحجم وSHA-256 المعلنين. يعيد التنزيل البايتات نفسها، ويستخدم مجموع التحقق كقيمة `ETag` قوية. تعتمد بقية عناصر Arkvory على المُخرَجات: إصدار الحزمة ومراجعة المسار وطبقة الحاوية وكائن Git LFS كلها مُخرَجات. + +## عمليات الرفع {#uploads} + +تحجز **عملية الرفع** مُخرَجًا سيُنشأ لاحقًا. تنشئ **جلسة رفع** باسم الملف وحجمه وSHA-256، مع `Idempotency-Key` يجعل تكرار الطلب آمنًا. ثم ترسل البايتات: + +- في طلب واحد للملفات الصغيرة والمتوسطة؛ أو +- في **أجزاء** للملفات الكبيرة. يختار الخادم حجم الجزء، بحد أدنى 8 MiB، ويضاعفه للملفات الضخمة كي لا يتجاوز الرفع 10,000 جزء. لا يتجاوز الجزء 1 GiB. ولكل جزء SHA-256 خاص به، ولا يسبب تكرار الجزء ضررًا. + +بعد ذلك **تُكمل** عملية الرفع. يتحقّق الخادم من الملف كله وينشره. للملفات الكبيرة، ينفّذ العامل **مهمة إكمال** يتابعها العميل؛ ويختار SDK وعميل سطر الأوامر هذا المسار للملفات بحجم 16 GiB أو أكثر. تبقى جلسة الرفع صالحة 7 أيام. ويستأنف الرفع المنقطع اعتمادًا على الأجزاء الموجودة لدى الخادم. أكبر كائن هو 10,000 GiB ما لم يضع المسؤول حدًا أقل عبر `ARKVORY_MAX_OBJECT_BYTES`. + +ينفّذ [عميل سطر الأوامر](../protocols/cli) و[SDK](../protocols/sdk) هذه الخطوات نيابةً عنك. راجع [عمليات النقل](../use/transfers) و[مرجع عمليات الرفع](../api/reference/uploads). + +## الحزم {#packages} + +**الحزمة** أرشيف UPack سجّله Arkvory. تتكون هويتها من **مجموعة** و**اسم** و**إصدار SemVer**، مثل `acme` / `game-server` / `1.4.2`. المجموعة جزء من الهوية: الحزمتان ذواتا الاسم نفسه في مجموعتين مختلفتين حزمتان مختلفتان. لا يتغير الإصدار المنشور، ويُرفض نشر الإصدار نفسه بمحتوى آخر. + +يطلب وكيل النشر الحزمة بإصدار دقيق، أو **نطاق إصدارات** مثل `^1.4`، أو أحدث إصدار في **مرحلة** معينة. لا تدخل الإصدارات التمهيدية في النتائج إلا عند طلبها. راجع [الحزم](../use/packages). + +## الملفات حسب المسار {#files-by-path} + +**الملف حسب المسار** له عنوان مثل `builds/game/1.4/Setup.exe` يشير إلى مُخرَج. عندما تخزّن بايتات جديدة في المسار، يحصل على **مراجعة** جديدة، مثل 1 و2 و3. تبقى المراجعات السابقة في **المحفوظات** ويمكن **استعادة** إحداها؛ وتضيف الاستعادة مراجعة جديدة بالمحتوى القديم. أما تخزين البايتات نفسها مرة أخرى فلا يضيف شيئًا. + +لا يتجاوز المسار 1,024 محرفًا، ويستخدم `/` فاصلًا، ولا يتضمن مقاطع فارغة أو `.` أو `..` أو المحرف `:`. يحدّد كل تغيير المراجعة المتوقعة؛ وإذا سبقه تغيير آخر، يعيد الخادم `409`. استخدم `0` لمسار غير موجود بعد. راجع [الملفات والمسارات](../use/files) و[الملفات الخام](../protocols/raw-files). + +## التسميات وبيانات التعريف والتجميعات والمرفقات {#annotations} + +يمكن وصف المُخرَج دون تغيير بايتاته: + +| العنصر | القاعدة | +| -------------- | --------------------------------------------------------------------------------------------------------- | +| التسميات | حتى 32 وسمًا قصيرًا مثل `nightly` أو `tested`. | +| بيانات التعريف | حتى 32 حقلًا نصيًا؛ طول المفتاح حتى 64 محرفًا، والقيمة حتى 1,024 محرفًا. | +| التجميعات | مجموعات ذات أسماء تجمع المُخرَجات. | +| المرفقات | حتى 32 رابطًا من نسخة بناء إلى مُخرَجات أخرى في المستودع نفسه: بيان أو SBOM أو توقيع أو تقرير أو أي ملف آخر. | + +تتغير التسميات وبيانات التعريف والتجميعات كمجموعة واحدة لها مراجعات. أما المرفقات فلها مراجعات ومحفوظات منفصلة. + +## المراحل والترقية {#stages-and-promotion} + +**المرحلة** علامة خاضعة للتحكم تُضاف إلى نسخة بناء، مثل `qa` أو `release` أو `prod`. يستخدم اسم المرحلة الأحرف الصغيرة والأرقام و`.` و`_` و`-`، ولا يتجاوز 32 محرفًا. ويمكن للمُخرَج حمل 16 مرحلة بحد أقصى. يتطلب تغيير المرحلة إذنًا مستقلًا هو `artifact.promote`، ويُسجّل كل تغيير مع صاحبه ووقته وتعليقه. + +تنشر **الترقية** نسخة بناء في مستودع آخر دون إعادة إرسال البايتات. تُبقي `copy` المصدر، بينما تزيل `move` نسخة البناء من مستودع المصدر أيضًا. يعيد تكرار الترقية النسخة الموجودة. وتحدّد عملية **resolve** نسخة البناء التي تشير إليها مرحلة ونطاق إصدارات. راجع [الترقية](../use/promotion). + +## الحسابات والمجموعات والأذونات {#access} + +يستخدم الأشخاص **حسابات**. للحساب اسم من 3 إلى 64 محرفًا وكلمة مرور من 12 إلى 128 محرفًا. يدير حساب **المسؤول** الحسابات والمجموعات. تنتمي الحسابات إلى **مجموعات**، وتُمنح المجموعة وصول `read` أو `write`، أي القراءة والكتابة، إلى مستودع. تُعاد حسابات الحقوق في كل طلب، فيسري التغيير فورًا. + +تستخدم الأتمتة **حساب خدمة** بدلًا من ذلك. تسرد **سياسته** **الإجراءات** الدقيقة لكل مستودع، مثل `upload.create` أو `content.read`، ولا تستطيع مفاتيحه إلا تضييق تلك السياسة. يتحقّق الخادم من كل إجراء؛ إخفاء زر في وحدة التحكم ليس وسيلة حماية. راجع [الحسابات والوصول](../use/accounts) و[المصادقة](../api/authentication). + +## المفاتيح والرموز {#keys-and-tokens} + +يحمل كل طلب بيانات اعتماد. توجد أربعة أنواع تنشئها، ونوع مدمج: + +| بيانات الاعتماد | الغرض | مدة الصلاحية | +| -------------------- | ----------------------------------- | --------------------------------------------- | +| **جلسة** وحدة التحكم | شخص سجّل الدخول باسم وكلمة مرور | 12 ساعة | +| **رمز وصول شخصي** | أدوات شخص واحد ونصوصه البرمجية | 90 يومًا افتراضيًا، وحتى 365 يومًا | +| **مفتاح خدمة** | CI/CD ووكلاء النشر | 90 يومًا افتراضيًا، وحتى 365 يومًا | +| **رابط تنزيل** | تسليم مُخرَج واحد لشخص لا يملك مفتاحًا | من 60 ثانية إلى 24 ساعة، وساعة واحدة افتراضيًا | +| **مفتاح الاسترداد** | التثبيت نفسه | لا تنتهي صلاحيته | + +يُصدر مفتاح الخدمة ويُعرض مرة واحدة، ولا يصبح قابلًا للاستخدام إلا بعد **تفعيله**. يمكنك **تدويره**، بإصدار مفتاح جديد ثم إيقاف القديم، أو **إبطاله** نهائيًا. راجع [المصادقة](../api/authentication). + +## المالك ومفتاح الاسترداد {#owner-and-recovery-key} + +**المالك** هو الحساب الأول. وهو مسؤول وعضو في مجموعة `arkvory-owners` التي تملك وصول `write` إلى `releases`. ينشئه مثبّت Windows الرسومي `Arkvory-Setup-x64.exe`؛ أما مع سكربت Windows PowerShell أو Linux أو Docker فتنشئه في وحدة التحكم باستخدام مفتاح الاسترداد. + +**مفتاح الاسترداد** سر يكتبه المثبّت في `config/bootstrap-token.txt` داخل جذر التثبيت. يستطيع إنشاء المالك الأول والحسابات، وإدارة حسابات الخدمة وتفويضاتها، وتشغيل النسخ الاحتياطية وطلب التحديثات. تقرؤه أدوات التثبيت على الخادم. ليس مخصصًا لـ CI أو للعمل اليومي: أبقه على الخادم ولا تنسخه. راجع [اختيار طريقة التثبيت](../install/index#recovery-key) و[الأمان](../operate/security). + +## الاحتفاظ والحصص والتنظيف {#retention} + +تخص **سياسة التخزين** مستودعًا بعينه. ويمكنها الاحتفاظ بآخر N نسخة بناء لكل حزمة، أو لكل حزمة وقناة، وحماية التسميات والمراحل من الإزالة، واشتراط حد أدنى للعمر قبل الإزالة، وتحديد **حصة** بعتبتي تحذير وحالة حرجة. تظل معطّلة حتى يفعّلها المسؤول. تبدأ إزالة المُخرَج بالحذف المنطقي: تبقى البايتات على القرص خلال **فترة سماح** مدتها الافتراضية 24 ساعة، ثم يحرّر **التنظيف الفعلي** المساحة في الخلفية على دفعات صغيرة ودون إيقاف الخادم. + +يحتفظ الخادم أيضًا بمساحة قرص حرة احتياطية لا تستخدمها عمليات الرفع، وحجمها الافتراضي 1 GiB. راجع [التخزين](../operate/storage). + +## النسخ الاحتياطية {#backups} + +ينسخ **وكيل النسخ الاحتياطي** قاعدة البيانات وجميع المحتويات المنشورة إلى **مخزن النسخ الاحتياطية**، وهو مجلد على قرص آخر أو مشاركة شبكة. وتُسمّى النسخة الكاملة الواحدة **نقطة استعادة**. يتحقّق الوكيل من كل نقطة ويطبّق عليها قواعد الاحتفاظ، افتراضيًا 7 يومية و4 أسبوعية و6 شهرية، ويمكنك **تثبيت** نقطة كي تبقيها قواعد الاحتفاظ. يظل الجدول اليومي معطّلًا حتى يفعّله المسؤول في [[ui:backupPlan]]. + +تُنفّذ الاستعادة بأمر على الخادم، يكتب إلى قاعدة بيانات فارغة ودليل تخزين فارغ. راجع [النسخ الاحتياطية](../operate/backups). + +## المرايا وبوابات القراءة {#mirrors-and-gateways} + +**المرآة** نسخة للقراءة فقط من مستودع، يحتفظ بها تثبيت ثانٍ عبر متابعة التثبيت الأول، أي **المصدر**. ترفض التغييرات وتقدّم التنزيلات. إذا فُقد المصدر، يفصل المشغّل المرآة فتصبح مستودعًا عاديًا؛ التحويل يدوي وليس تجاوز فشل تلقائيًا. راجع [المرايا](../operate/mirrors). + +**بوابة القراءة** عملية API إضافية تستخدم التخزين نفسه ولا تجيب إلا عن `GET` و`HEAD`. يتشارك الكاتب والبوابات ميزانية واحدة لعرض نطاق التنزيل. راجع [بوابات القراءة](../operate/read-gateways). + +## الخطوة التالية {#next} + +1. [البدء السريع](./quick-start): ثبّت Arkvory وارفع ملفك الأول. +2. [الحسابات والوصول](../use/accounts): الأشخاص والمجموعات والرموز ومفاتيح الخدمة. +3. [نظرة عامة على HTTP API](../api/index): القواعد اللازمة لكل تكامل. +4. [مسرد المصطلحات](../reference/glossary): تعريفات قصيرة لجميع المصطلحات. diff --git a/wiki/ar/guide/console.md b/wiki/ar/guide/console.md index 0570ea53..78661d34 100644 --- a/wiki/ar/guide/console.md +++ b/wiki/ar/guide/console.md @@ -24,13 +24,13 @@ title: وحدة التحكم على الويب تظهر بعض الأقسام لبعض المستخدمين فقط: -| القسم | من يراه | -| --------------------- | ----------------------------------------------------- | -| [[ui:administration]] | المسؤولون | -| [[ui:repositories]] | كل من سجّل الدخول | +| القسم | من يراه | +| --------------------- | -------------------------------------------------- | +| [[ui:administration]] | المسؤولون | +| [[ui:repositories]] | كل من سجّل الدخول | | [[ui:services]] | مفتاح الاسترداد، ومفاتيح المشغّل ذات الحقوق المفوَّضة | -| [[ui:updates]] | المسؤولون | -| [[ui:backups]] | المسؤولون ومفتاح الاسترداد | +| [[ui:updates]] | المسؤولون | +| [[ui:backups]] | المسؤولون ومفتاح الاسترداد | ## تسجيل الدخول {#signing-in} @@ -48,7 +48,7 @@ title: وحدة التحكم على الويب ### المالك الأول {#the-first-owner} -لا توجد حسابات في التثبيت الجديد. على Windows ينشئ برنامج التثبيت المالك. وفي التثبيتات الأخرى، أنشئ المالك في وحدة التحكم: +لا توجد حسابات في التثبيت الجديد. ينشئ مثبّت Windows الرسومي `Arkvory-Setup-x64.exe` المالك. أما مع سكربت Windows PowerShell أو Linux أو Docker، فأنشئ المالك في وحدة التحكم: 1. افتح [[ui:navStart]] ووسّع [[ui:welcomeOwner]]. 2. الصق مفتاح الاسترداد من `config/bootstrap-token.txt` في دليل التثبيت. @@ -81,7 +81,7 @@ title: وحدة التحكم على الويب - [[ui:assetTitle]]: يجعل [[ui:assign]] هذا المُخرَج المحتوى الحالي لمسار ملف. - [[ui:promotionTitle]]: يعلّم [[ui:stageAdd]] المُخرَج بمرحلة، مثل `qa` أو `release`. وينشره [[ui:promoteSubmit]] في مستودع آخر. راجع [الترقية](../use/promotion). - [[ui:attachmentsTitle]]: يربط [[ui:attachmentAdd]] ملف بيان أو SBOM أو توقيعًا أو تقريرًا أو ملفًا آخر بنسخة البناء هذه. ويعرض [[ui:attachmentHistory]] المجموعات السابقة. -- [[ui:deletionTitle]]: يعرض [[ui:deletionInspect]] ما لا يزال يستخدم المُخرَج. وللحذف، الصق معرّف المُخرَج واختر [[ui:deletionSubmit]]. +- [[ui:deletionTitle]]: يعرض [[ui:deletionInspect]] ما لا يزال يستخدم المُخرَج. وللحذف، الصق معرّف المُخرَج واختر [[ui:deletionSubmit]]. يتطلب الحذف مفتاح خدمة يملك الإجراء `artifact.delete`؛ ولا يتيح تسجيل الدخول بكلمة مرور أو الرمز الشخصي أو مفتاح الاسترداد الحذف. ## النقل {#transfers} @@ -111,6 +111,8 @@ title: وحدة التحكم على الويب يعرض [[ui:repositories]] المستودعات التي يمكنك رؤيتها، مع [[ui:repositoryRights]]. لكل بطاقة [[ui:repositoryOpen]] و[[ui:repositoryStorage]] (حصة التخزين والتنظيف التلقائي والتنظيف الفعلي)، و[[ui:repositoryAccess]] للمسؤولين. ويعرض المستودع المنسوخ بمرآة الشارة [[ui:mirrorBadge]]. راجع [المستودعات](../use/repositories) و[التخزين](../operate/storage). +تتطلب لوحة التخزين مفتاح خدمة يملك الإجراء `storage.read` أو `storage.manage`. + ### وصول الخدمات {#service-access} هنا تنشئ حسابات للأدوات وأنظمة CI. ولرؤية هذا القسم، اتصل بمفتاح الاسترداد أو بمفتاح مشغّل. اختر [[ui:serviceCreate]] ثم اضبط [[ui:servicePolicy]]. ويملأ [[ui:bindingRead]] و[[ui:bindingPublish]] مجموعات الأذونات المعتادة. diff --git a/wiki/ar/guide/index.md b/wiki/ar/guide/index.md index 8d99f3e2..d4b52aab 100644 --- a/wiki/ar/guide/index.md +++ b/wiki/ar/guide/index.md @@ -20,14 +20,14 @@ Arkvory مجاني للجميع، بمن فيهم الشركات. شيفرته يُحفظ كل شيء في **مستودعات**. ويمكن أن يحتوي المستودع الواحد على عدة أنواع من المحتوى في الوقت نفسه: -| المحتوى | طريقة العمل معه | -| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | +| المحتوى | طريقة العمل معه | +| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | المُخرَجات (أي ملف) | الرفع عبر وحدة التحكم أو [عميل سطر الأوامر](../protocols/cli) أو [SDK](../protocols/sdk) أو HTTP API | -| حزم UPack | حزم ذات إصدارات لها مجموعة واسم وإصدار SemVer. راجع [الحزم](../use/packages). | -| ملفات حسب المسار | مسار مثل `builds/game/1.4/Setup.exe` يحتفظ بكل إصداراته السابقة. راجع [الملفات والمسارات](../use/files) و[الملفات الخام](../protocols/raw-files). | -| صور الحاويات | سجل OCI لـ Docker وPodman وHelm وORAS. راجع [صور الحاويات](../protocols/containers). | -| كائنات Git LFS | خادم Git LFS مع قفل الملفات. راجع [Git LFS](../protocols/git-lfs). | -| حزم npm وUnity | سجل npm يمكن لمدير حزم Unity استخدامه. راجع [Unity وnpm](../protocols/unity-npm). | +| حزم UPack | حزم ذات إصدارات لها مجموعة واسم وإصدار SemVer. راجع [الحزم](../use/packages). | +| ملفات حسب المسار | مسار مثل `builds/game/1.4/Setup.exe` يحتفظ بكل إصداراته السابقة. راجع [الملفات والمسارات](../use/files) و[الملفات الخام](../protocols/raw-files). | +| صور الحاويات | سجل OCI لـ Docker وPodman وHelm وORAS. راجع [صور الحاويات](../protocols/containers). | +| كائنات Git LFS | خادم Git LFS مع قفل الملفات. راجع [Git LFS](../protocols/git-lfs). | +| حزم npm وUnity | سجل npm يمكن لمدير حزم Unity استخدامه. راجع [Unity وnpm](../protocols/unity-npm). | كل ملف مخزَّن هو **مُخرَج** (artifact) غير قابل للتغيير، له مجموع اختباري SHA-256. لا يحلّ المحتوى الجديد محل البايتات القديمة، بل ينشئ مُخرَجًا جديدًا. راجع [المفاهيم](./concepts). @@ -38,7 +38,7 @@ Arkvory مجاني للجميع، بمن فيهم الشركات. شيفرته - **المراحل والترقية.** علّم نسخة البناء بـ `qa` أو `release` أو `prod`، أو انشرها في مستودع آخر دون رفع جديد. ويمكن لوكيل النشر أن يطلب «أحدث نسخة بناء بمرحلة `release` ضمن النطاق `^1.4`». - **بيانات التعريف.** التسميات وبيانات التعريف النصية والتجميعات والملفات المرفقة، مثل ملفات البيان (manifest) وSBOM والتواقيع. - **الاحتفاظ.** احتفظ بآخر N من نسخ البناء لكل حزمة، وحدّد حصص التخزين، واحذف المحتوى القديم في الخلفية. -- **النسخ الاحتياطية.** ينسخ وكيل النسخ الاحتياطي قاعدة البيانات وكل المحتوى إلى مخزن النسخ الاحتياطية على قرص آخر أو NAS وفق جدول يومي، ويتحقق من النسخ. +- **النسخ الاحتياطية.** ينسخ وكيل النسخ الاحتياطي قاعدة البيانات وكل المحتوى إلى مخزن النسخ الاحتياطية على قرص آخر أو NAS وفق جدول يومي يفعّله المسؤول، ويتحقق من النسخ. - **المرايا.** يمكن لتثبيت ثانٍ أن يحتفظ بنسخة للقراءة فقط من مستودع ويخدمها عندما يتعذر الوصول إلى الخادم الرئيسي. - **بوابات القراءة.** عمليات تنزيل إضافية على التخزين المشترك نفسه تتقاسم ميزانية تنزيل واحدة. - **الإصلاح الذاتي.** تعيد الخدمات تشغيل نفسها بعد التعطل أو التجمّد. ويمكن لعمليات النقل الطويلة أن تتابع بعد إعادة التشغيل. @@ -49,23 +49,23 @@ Arkvory مجاني للجميع، بمن فيهم الشركات. شيفرته يعمل Arkvory على خادم واحد. يستخدم PostgreSQL للفهرس ودليلًا محليًا للمحتوى. وتعمل ثلاث خدمات معًا: -| الخدمة | الغرض | -| -------------------- | ----------------------------------------------------------------------------------------------- | +| الخدمة | الغرض | +| -------------------- | --------------------------------------------------------------------------------------------- | | API | خادم HTTP: واجهة API ووحدة التحكم والسجلات (registries). ويشغّل أيضًا الاحتفاظ والتنظيف الفعلي. | -| العامل (worker) | مهام الخلفية: إنهاء عمليات الرفع الكبيرة ومزامنة المرايا | -| وكيل النسخ الاحتياطي | نسخ احتياطية مجدولة إلى المخزن | +| العامل (worker) | مهام الخلفية: إنهاء عمليات الرفع الكبيرة ومزامنة المرايا | +| وكيل النسخ الاحتياطي | نسخ احتياطية مجدولة إلى المخزن | يمكنك التثبيت بثلاث طرق: -| المنصة | برنامج التثبيت | التفاصيل | -| ----------------------------- | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | +| المنصة | برنامج التثبيت | التفاصيل | +| ----------------------------- | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | Windows 10/11 وWindows Server | `Arkvory-Setup-x64.exe` | معالج تثبيت. يتضمن Node.js وPostgreSQL ويعمل دون إنترنت. وتعمل الخدمات دون مستخدم مسجّل الدخول. راجع [Windows](../install/windows). | -| Linux | `Arkvory-amd64.deb` و`Arkvory-x86_64.rpm` | حزم لـ apt وdnf، مع خدمات systemd. راجع [Linux](../install/linux). | -| Docker | Docker Compose | API والعامل ووكيل النسخ الاحتياطي وPostgreSQL في حاويات. راجع [Docker](../install/docker). | +| Linux | `Arkvory-amd64.deb` و`Arkvory-x86_64.rpm` | حزم لـ apt وdnf، مع خدمات systemd. راجع [Linux](../install/linux). | +| Docker | Docker Compose | API والعامل ووكيل النسخ الاحتياطي وPostgreSQL في حاويات. راجع [Docker](../install/docker). | يستمع الخادم افتراضيًا إلى `127.0.0.1:8080` فقط. وقبل أن تتصل أجهزة أخرى، أعدّ [HTTPS](../install/https). -التثبيت الواحد خادم واحد: إذا توقف، ينتظر العملاء حتى يعود. وعلى Linux، يتولى [عنقود توافر عالٍ](../operate/cluster) من خادمين أو ثلاثة العمل عند تعطل أحدها. استخدم [النسخ الاحتياطية](../operate/backups)، وعند الحاجة [المرايا](../operate/mirrors) في موقع ثانٍ. +يتكوّن التثبيت القياسي من خادم واحد: إذا توقف، ينتظر العملاء حتى يعود. وعلى Linux، يتولى [عنقود توافر عالٍ](../operate/cluster) من خادمين أو ثلاثة العمل عند تعطل أحدها. استخدم [النسخ الاحتياطية](../operate/backups)، وعند الحاجة [المرايا](../operate/mirrors) في موقع ثانٍ. ## إلى أين تذهب بعد ذلك {#where-to-go-next} diff --git a/wiki/ar/guide/quick-start.md b/wiki/ar/guide/quick-start.md index cd61a0ad..a44cf4de 100644 --- a/wiki/ar/guide/quick-start.md +++ b/wiki/ar/guide/quick-start.md @@ -73,9 +73,9 @@ ssh -L 8080:127.0.0.1:8080 admin@arkvory.example ## الخطوة 3. أنشئ المالك {#step-3-create-the-owner} -تخطَّ هذه الخطوة على Windows: فقد أنشأ برنامج التثبيت المالك بالفعل. +تخطَّ هذه الخطوة إذا ثبّتَّ باستخدام `Arkvory-Setup-x64.exe`: فقد أنشأ برنامج التثبيت المالك بالفعل. -على Linux وDocker يُنشأ الحساب الأول باستخدام **مفتاح الاسترداد**. يكتبه برنامج التثبيت في `config/bootstrap-token.txt` ضمن جذر التثبيت. ولا يستطيع قراءة الملف إلا المسؤول. +عند التثبيت بنص PowerShell البرمجي على Windows، أو على Linux، أو باستخدام Docker، أنشئ الحساب الأول باستخدام **مفتاح الاسترداد**. يكتبه برنامج التثبيت في `config/bootstrap-token.txt` ضمن جذر التثبيت. ولا يستطيع قراءة الملف إلا المسؤول. ```bash sudo cat /opt/proanima-arkvory/config/bootstrap-token.txt diff --git a/wiki/ar/install/configuration.md b/wiki/ar/install/configuration.md index 7f75cc90..ef05499d 100644 --- a/wiki/ar/install/configuration.md +++ b/wiki/ar/install/configuration.md @@ -1,12 +1,231 @@ --- -title: 'Configuration' -description: 'Where the Arkvory configuration lives, which lifecycle commands change it, the main settings by task, and how to apply a change.' +title: الإعدادات +description: مواقع إعدادات Arkvory، وأوامر دورة الحياة التي تغيّرها، والإعدادات الرئيسية حسب المهمة، وكيفية تطبيق التغييرات. --- - +# الإعدادات -::: warning -لم تُترجم هذه الصفحة بعد، وهي معروضة بالإنجليزية. -::: +يحتوي Arkvory على نوعين من الإعدادات: - +- **إعدادات الخادم** هي متغيرات `ARKVORY_*` في ملف `config/runtime.json`. تضبط العنوان والحدود والتخزين وما شابه ذلك. تقرؤها API والعامل ووكيل النسخ الاحتياطي عند بدء التشغيل. +- **سياسة التثبيت** تشمل سياسة التحديث وملفات HTTPS ومخزن النسخ الاحتياطية والمرايا. تغيّرها بأمر `arkvory configure`. يتحقق الأمر من التغيير ويعيد تشغيل ما يلزم ويستعيد الحالة القديمة إذا لم تبدأ الخدمات. + +توضح هذه الصفحة مواقع الملفات والأوامر المتاحة وكيفية عمل الإعدادات الرئيسية. توجد القائمة الكاملة للمتغيرات، مع القيم الافتراضية والنطاقات، في [متغيرات البيئة](../reference/environment). + +## موقع الإعدادات {#where-it-lives} + +يحتوي جذر التثبيت على كل شيء. وهو `C:\ProgramData\ProAnima\Arkvory` على Windows و`/opt/proanima-arkvory` على Linux. يستخدم تثبيت Compose الجذر نفسه على المضيف. المسارات أدناه نسبية إلى الجذر. + +| الملف | المحتوى | كيفية تغييره | +| ------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | +| `config/runtime.json` | إعدادات الخادم. تبدأ المفاتيح بـ`ARKVORY_`، وكل قيمة سلسلة نصية. يحتوي على كلمة مرور قاعدة البيانات | يدويًا أو باستخدام `configure` | +| `config/keys.json` | تجزئات SHA-256 لمفتاح الاسترداد ومفتاح الجاهزية. لا يحتوي على مفتاح أبدًا | فقط عند [استبدال مفتاح الاسترداد](#replace-recovery-key) | +| `config/bootstrap-token.txt` | مفتاح الاسترداد | فقط لاستبداله | +| `config/health-token.txt` | المفتاح الذي تستخدمه أدوات التثبيت لفحص الجاهزية | لا تغيّره | +| `config/hub.json` | عنوان المركز وقناة التحديث وإعداد الإحصاءات | باستخدام `configure` | +| `config/install-id` | معرّف تثبيت عشوائي، لا يُرسل إلى المركز إلا عند تفعيل الإحصاءات | لا تغيّره | +| `config/mirrors/` | قائمة المرايا والمفاتيح التي يستخدمها العامل للمصادر | باستخدام `configure --mirror` | +| `config/webhooks/` | قائمة الاشتراكات وأسرار التوقيع وشهادات جهات الإصدار الموثوقة للمستقبِلين التي يستخدمها العامل | باستخدام `configure --webhook` | +| `installation.json` | النمط والمحرّك وإعداد التحديث التلقائي وتثبيت الإصدار والإصدار المثبّت | بالأوامر فقط | +| `github-token.txt` | رمز GitHub اختياري لتنزيل الإصدارات. راجع [التحديثات](./updates#hub-unreachable) | يدويًا | +| `config/compose.env`، `config/compose.vault.yml`، `config/compose.mirrors.yml` | في Compose فقط: الصورة وتركيب مخزن النسخ الاحتياطية وتركيب المرايا | بالأوامر فقط | + +في تثبيت Linux الأصلي، تكون ملكية `runtime.json` و`keys.json` هي `root:arkvory` ووضعهما `0640`، ولا يستطيع قراءة ملفات بيانات الاعتماد في `config/` إلا `root`. يستخدم تثبيت Compose الوضع `0644` للملفات التي تقرؤها الحاويات: راجع [Docker Compose](./docker#owners). احتفظ بالمالكين وأوضاع الأذونات التي ضبطها برنامج التثبيت. + +## أوامر دورة الحياة {#lifecycle-commands} + +لأوامر إدارة تثبيت موجود، حدّد جذر التثبيت باستخدام `--root`. يتطلب تغيير الخدمات الأصلية صلاحيات المسؤول. مع Compose، استخدم حسابًا يملك الوصول إلى جذر التثبيت ومحرّك الحاويات. تُشرح استثناءات `help` و`volume-init` أدناه. + +| التثبيت | كيفية تشغيل أمر | +| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| حزمة Linux | `sudo arkvory --root /opt/proanima-arkvory` | +| Windows، برنامج التثبيت الرسومي | في PowerShell بحقوق مرتفعة: `& 'C:\Program Files\ProAnima\Arkvory\arkvory.ps1' --root C:\ProgramData\ProAnima\Arkvory` | +| التثبيت بنص برمجي، Compose | `sudo /runtime/node-v24.22.3-linux-x64/bin/node /manage.mjs --root `. على Windows استخدم `runtime\node-v24.22.3-win-x64\node.exe` | + +يسرد `arkvory help` الأوامر من دون حقوق خاصة. تستخدم أمثلة هذا الموقع الصيغة المختصرة `arkvory `. + +| الأمر | الاستخدام | +| ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------- | +| `status` | يعرض نمط التثبيت والمحرّك وإعداد التحديث التلقائي والتثبيت والإصدار المثبّت | +| `configure` | يغيّر سياسة. راجع [أمر configure](#configure-command) | +| `update` | يثبّت إصدارًا مستقرًا أحدث الآن. راجع [التحديثات](./updates) | +| `upgrade` | يثبّت إصدارًا يغيّر مخطط قاعدة البيانات مع سجل نسخة احتياطية أعددته بنفسك. راجع [التحديثات](./updates#manual-upgrade) | +| `recover` | يُكمل تحديثًا انقطع. راجع [التحديثات](./updates#recover-update) | +| `finish-install` | يتابع تثبيتًا أول انقطع | +| `updates-connect` | يربط وحدة التحكم بمؤقّت التحديث، ويسجّل الخدمات التي يفتقر إليها تثبيت قديم | +| `updates-poll`، `updates-reset`، `changes-reset` | يستخدمها مؤقّت التحديث وتُستخدم للاسترداد. راجع [التحديثات](./updates#recover-update) | +| `volume-init` | يضع علامة على دليل فارغ بوصفه وحدة تخزين جديدة. لا يحتاج إلى `--root`. راجع [وحدات تخزين متعددة](../operate/storage#volumes) | + +يعمل أمر واحد فقط في كل مرة. يتوقف الأمر الثاني بالرسالة `Installation is locked`. لا تضع مفتاحًا أو كلمة مرور في خيار أمر أبدًا: استخدم الملفات. + +### أمر configure {#configure-command} + +يغيّر كل استدعاء نوعًا واحدًا من الإعدادات. لا يمكن مزج الأنواع الستة في استدعاء واحد. + +| النوع | الخيارات | الأثر | +| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | +| HTTPS | `--tls-cert FILE --tls-key FILE [--listen-host ADDRESS]`، أو `--tls-off [--listen-host ADDRESS]` | يفعّل HTTPS المدمج أو يوقفه. يعيد تشغيل الخدمات ويتحقق من الجاهزية. راجع [HTTPS](./https) | +| مخزن النسخ الاحتياطية | `--backup-vault DIRECTORY [--vault-key-file FILE \| --init-vault --vault-no-encryption]`، أو `--backup-vault-off` | يصل المخزن أو يفصله. يعيد تشغيل وكيل النسخ الاحتياطي فقط. راجع [النسخ الاحتياطي](../operate/backups) | +| المرايا | `--mirror REPOSITORY --mirror-upstream URL --mirror-token-file FILE [--mirror-source REPOSITORY] [--mirror-stages LIST] [--mirror-ca-file FILE]`، أو `--mirror REPOSITORY --mirror-token-file FILE` لمفتاح جديد، أو `--mirror-detach REPOSITORY[,REPOSITORY…]` أو `--mirror-detach all` | يجعل المستودع مرآة أو هدف استيراد، أو يعيده إلى مستودع عادي. راجع [المرايا](../operate/mirrors) | +| خطافات الويب | `--webhook ID --webhook-repository REPOSITORY --webhook-url URL --webhook-secret-file FILE [--webhook-next-secret-file FILE] [--webhook-actions LIST] [--webhook-allow-private LIST] [--webhook-ca-file FILE]`، أو `--webhook-detach ID` | يضيف اشتراك خطاف ويب أو يستبدله أو يزيله. يعيد تشغيل الخدمات ويتحقق من الجاهزية. راجع [خطافات الويب](../protocols/webhooks) | +| العنقود | `--cluster ha-2` أو `ha-3` `[--cluster-resource NAME]` | على العقدة الأساسية لوحدة تخزين منسوخة: يفعّل نمط العنقود. راجع [عنقود التوافر العالي](../operate/cluster#build) | +| التحديثات | `--enable-updates`، `--disable-updates`، `--pin [--version X.Y.Z]`، `--unpin`، `--update-channel stable` أو `beta`، `--statistics on` أو `off`، `--hub-url URL`، `--hub-off` | يغيّر سياسة التحديث. راجع [التحديثات](./updates) | + +تعيد تغييرات HTTPS والمخزن والمرايا تشغيل الخدمات وتستعيد الإعدادات السابقة عندما لا يعمل التغيير. تكتفي خيارات التحديث بإعادة كتابة `installation.json` و`hub.json`؛ ولا تعيد تشغيل شيء. مسارات الملفات مطلقة. + +## الإعدادات حسب المهمة {#settings-by-task} + +### العنوان والمنفذ {#address-and-port} + +| المتغير | القيمة الافتراضية | المعنى | +| -------------- | ----------------- | --------------------------- | +| `ARKVORY_HOST` | `127.0.0.1` | العنوان الذي تستمع عليه API | +| `ARKVORY_PORT` | `8080` | منفذ TCP | + +بالإعداد الافتراضي، لا تستطيع الاتصال إلا البرامج على الخادم. لقبول حواسيب أخرى، اختر إحدى طريقتين: + +- **HTTPS المدمج.** `arkvory configure --tls-cert … --tls-key … --listen-host 0.0.0.0`. راجع [HTTPS](./https#built-in-tls). +- **وكيل عكسي على حاسوب آخر.** اضبط `ARKVORY_HOST` على عنوان واجهة الشبكة الخاصة بالوكيل، وأدرج الوكيل في `ARKVORY_TRUSTED_PROXIES`. عدّل `runtime.json` أو شغّل `arkvory configure --tls-off --listen-host
`. اقصر الوصول إلى المنفذ على الوكيل باستخدام جدار ناري. + +يُرفض `--listen-host` وحده: استخدمه مع ملفات TLS أو مع `--tls-off`. بعد `--tls-off`، أضف `--listen-host 127.0.0.1` للعودة إلى عنوان الاسترجاع المحلي، وإلا فستواصل API الاستماع على العنوان المضبوط. + +عندما تستمع API على عنوان غير عنوان الاسترجاع المحلي، ومن دون TLS ووكيل موثوق، تسجّل التحذير `http.plaintext_exposed` عند البدء. لا ترسل المفاتيح عبر HTTP غير مشفّر بين الحواسيب أبدًا. + +على Linux، تعمل الخدمات بحساب بلا امتيازات، ولا يمكنه عادةً الاستماع على منفذ أقل من 1024. تستمر اختصارات وحدة التحكم (قائمة ابدأ وعنصر القائمة) في الإشارة إلى المنفذ 8080. تتبع أوامر دورة الحياة العنوان والمنفذ في `runtime.json`. في تثبيت Compose يكون العنوان والمنفذ ثابتين: راجع [Docker Compose](./docker#ports). + +### العنوان العام والترويسات الممرّرة {#public-address} + +لا يوجد إعداد لعنوان URL عام. يبني الخادم الروابط المطلقة، مثل الروابط في استجابات Git LFS وnpm، من الطلب: يكون المخطط `https` عندما يكون الاتصال عبر TLS أو عندما يرسل الوكيل `X-Forwarded-Proto: https`، ويُؤخذ المضيف من الترويسة `Host`. يستطيع الوكيل المدرج في `ARKVORY_TRUSTED_PROXIES` ضبط المضيف أيضًا بواسطة `X-Forwarded-Host`. لذلك يجب أن يمرّر وكيلك الاسم العام. راجع [HTTPS](./https#reverse-proxy). + +يقبل `ARKVORY_TRUSTED_PROXIES` حتى 32 عنوانًا أو نطاق CIDR، مفصولة بفواصل. هذه الأطراف وحدها تستطيع تعيين عنوان العميل بواسطة `X-Forwarded-For` ومعرّف الطلب بواسطة `X-Request-Id`. من دون القائمة، يظهر كل عميل كأنه قادم من عنوان الوكيل، ويحسبهم حد تسجيل الدخول عميلًا واحدًا. + +### المتصفحات على عنوان آخر {#browsers} + +يسرد `ARKVORY_CORS_ORIGINS` ما يصل إلى 16 أصلًا لوحدة تحكم أو تطبيق ويب آخر يعمل على عنوان مختلف، مفصولة بفواصل. يتألف كل أصل من مخطط ومضيف ومنفذ اختياري، ومن دون مسار. يجب أن يستخدم HTTPS؛ ولا يُقبل HTTP غير المشفّر إلا مع `localhost` و`127.0.0.1` و`[::1]`. راجع [HTTPS](./https#console-api-address). يتيح `ARKVORY_ALLOW_REGISTRATION=true` للأشخاص إنشاء حساباتهم على صفحة تسجيل الدخول؛ وهو متوقف افتراضيًا. + +### قاعدة البيانات {#database} + +| المتغير | القيمة الافتراضية | المعنى | +| ---------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------- | +| `ARKVORY_DATABASE_URL` | يضبطه برنامج التثبيت | عنوان URL لاتصال PostgreSQL. تستمع قاعدة البيانات المُدارة على `127.0.0.1` على المنفذ الذي اختير أثناء التثبيت | +| `ARKVORY_DATABASE_POOL_SIZE` | `20` | حجم مجموعة اتصالات استعلامات API، من 4 إلى 200 | + +لا توجّه تثبيتًا إلى قاعدة بيانات أخرى. تنتمي الملفات المخزّنة والفهرس إلى مجموعة واحدة. الانتقال إلى قاعدة بيانات جديدة هو استعادة من نسخة احتياطية: راجع [النسخ الاحتياطي](../operate/backups). + +لخادم PostgreSQL خارجي، احسب `max_connections` بناءً على مجموع الحدود العليا لمجموعات الاتصالات في جميع العمليات. لكل عملية API، بما في ذلك كل بوابة قراءة، ثلاث مجموعات منفصلة: حتى `ARKVORY_DATABASE_POOL_SIZE` اتصالًا للاستعلامات (20 افتراضيًا)، و8 اتصالات للجلسات طويلة الأمد، وحتى `ARKVORY_MAX_UPLOADS` اتصالًا لأقفال كتابة عمليات الرفع (8 افتراضيًا). للعامل مجموعات منفصلة تضم 5 اتصالات للاستعلامات، و8 للجلسات، و`2 + min(N, 16)` لأقفال الكتابة، حيث N هو عدد المرايا المضبوطة. لوكيل النسخ الاحتياطي مجموعته الخاصة من 6 اتصالات، ويفتح مجموعة أخرى من 6 اتصالات أثناء التقاط نسخة احتياطية. هذه حدود عليا وليست اتصالات مشغولة باستمرار. اترك سعة إضافية لأدوات الترخيص والصيانة وإدارة قاعدة البيانات. + +### دليل التخزين والمساحة المتاحة {#storage} + +| المتغير | القيمة الافتراضية | المعنى | +| ------------------------------- | ----------------- | --------------------------------------------------------------------------- | +| `ARKVORY_DATA_DIR` | `/data` | موضع تخزين محتوى الملفات. يضبطه برنامج التثبيت. استخدم قرصًا محليًا | +| `ARKVORY_CAPACITY_BYTES` | 10 TiB | أقصى ما يمكن أن يستخدمه كل المحتوى المحجوز. هو حد للحجوزات وليس قياسًا للقرص | +| `ARKVORY_STORAGE_RESERVE_BYTES` | 1 GiB | مساحة متاحة لا تستخدمها عمليات الرفع أبدًا. يوقف `0` الاحتياطي | +| `ARKVORY_MAX_OBJECT_BYTES` | نحو 10 TiB | أكبر كائن منفرد. اضبط قيمة أقل لتقييد حجم الملف | + +أبقِ `ARKVORY_DATA_DIR` في الموضع الذي حدّده برنامج التثبيت. لا تستطيع وحدات Linux الكتابة إلا في `data/` و`logs/` و`updates/inbox/` ضمن الجذر، لذا يكون أي مسار آخر للقراءة فقط بالنسبة إليها. لاستخدام قرص أكبر، أوقف الخدمات وانسخ المحتوى إلى القرص الجديد، ثم ركّب القرص في `data/` مع المالك `arkvory`، وابدأ الخدمات. على Windows وLinux يمكنك أيضًا اختيار الجذر نفسه عند التثبيت بنص برمجي (`-Root` و`ARKVORY_INSTALL_ROOT`). راجع [التخزين](../operate/storage). + +### حدود النقل {#limits} + +تخص الحدود عملية API واحدة. المعدّل `0` يعني عدم وجود حد. + +| المتغير | القيمة الافتراضية | المعنى | +| ------------------------------------- | ------------------------------- | --------------------------------------------------------------------------------------------------------- | +| `ARKVORY_MAX_UPLOADS` | `8` | عمليات الرفع المتزامنة، من 1 إلى 32 | +| `ARKVORY_MAX_DOWNLOADS` | `16` | عمليات التنزيل المتزامنة، من 1 إلى 256 | +| `ARKVORY_MAX_UPLOADS_PER_PRINCIPAL` | `min(4, ARKVORY_MAX_UPLOADS)` | عمليات الرفع المتزامنة لحساب أو مفتاح واحد | +| `ARKVORY_MAX_DOWNLOADS_PER_PRINCIPAL` | `min(4, ARKVORY_MAX_DOWNLOADS)` | عمليات التنزيل المتزامنة لحساب أو مفتاح واحد | +| `ARKVORY_DOWNLOAD_STRATEGY` | `ordered` | ترتيب طابور التنزيل: `ordered` (فئات وأدوار)، أو `smallest-first`، أو `shared` (بلا طابور، كما في السابق) | +| `ARKVORY_UPLOAD_BYTES_PER_SECOND` | `0` | معدّل الرفع الإجمالي بالبايت في الثانية | +| `ARKVORY_DOWNLOAD_BYTES_PER_SECOND` | `0` | معدّل التنزيل الإجمالي بالبايت في الثانية | +| `ARKVORY_UPLOAD_DEADLINE_MS` | `1800000` | أطول مدة لطلب رفع واحد، 30 دقيقة | +| `ARKVORY_UPLOAD_IDLE_TIMEOUT_MS` | `30000` | يتوقف طلب الرفع إذا لم يرسل بيانات طوال هذه المدة | + +يجب أن يسمح الوكيل أمام API بطلب لا تقل مدته عن `ARKVORY_UPLOAD_DEADLINE_MS`. راجع [HTTPS](./https#reverse-proxy). توجد الحدود الأخرى، مثل طابور الانتظار ومعدّلات كل حساب، في [متغيرات البيئة](../reference/environment#transfers-and-bandwidth). + +يمكن تغيير قيم طابور التنزيل (الاستراتيجية وعدد التنزيلات المتزامنة والاحتياطي والأوزان وغيرها) أيضًا من دون إعادة تشغيل: [[ui:fleet]] ← [[ui:fleetThisSettings]]، أو `PUT /api/v1/system/downloads/settings`. تتقدم القيم المحفوظة على هذه المتغيرات في عملية الكتابة؛ راجع [المواقع](../operate/sites#site-settings). + +### النسخ الاحتياطي والمرايا {#backups-mirrors} + +استخدم `configure` لكليهما. يكتب `--backup-vault` المتغير `ARKVORY_BACKUP_VAULT`، ويمنح حساب الخدمة حق الوصول إلى الدليل، ويعيد تشغيل وكيل النسخ الاحتياطي وحده، ولا يحتفظ بالتغيير إلا عندما يبلّغ الوكيل بأن المخزن متاح. يجب أن يكون المخزن خارج جذر التثبيت وخارج التخزين. يكتب `--mirror` المتغير `ARKVORY_MIRRORS_FILE` وملفات المفاتيح، ويعيد تشغيل API والعامل، ويتحقق من المصدر باستخدام مفتاحك قبل تغيير أي شيء. + +### التحديثات والمركز {#updates-and-hub} + +توجد سياسة التحديث في `installation.json` و`config/hub.json`. توجد الخيارات في [أمر configure](#configure-command)، ومعانيها في [التحديثات](./updates). المتغير `ARKVORY_HUB_URL` في `runtime.json` منفصل: فهو يضبط وجهة إرسال ملاحظات وحدة التحكم. يغيّر `configure --hub-url` أو `--hub-off` الاثنين معًا، ويتغيّر عنوان الملاحظات بعد إعادة تشغيل الخدمات التالية. + +### السجلات وإيقاف التشغيل {#logs-and-shutdown} + +| المتغير | القيمة الافتراضية | المعنى | +| -------------------------- | ----------------- | -------------------------------------------------------------------------------------------- | +| `ARKVORY_LOG_LEVEL` | `info` | `debug` أو `info` أو `warning` أو `error`. يخفي المستويان `warning` و`error` سجل الوصول أيضًا | +| `ARKVORY_ACCESS_LOG` | `true` | سجل JSON واحد لكل طلب HTTP. لا تُكتب سلسلة الاستعلام أبدًا | +| `ARKVORY_DRAIN_TIMEOUT_MS` | `30000` | الوقت الممنوح للطلبات الجارية كي تنتهي بعد طلب التوقف | + +تمنح برامج الإشراف الخدمة 120 ثانية للتوقف. إذا ضبطت مهلة إنهاء الطلبات على أكثر من نحو 90 ثانية، فارفع أيضًا مهلة التوقف في مدير الخدمات: `TimeoutStopSec` في وحدات systemd، ومهلة توقف خدمات Windows، و`stop_grace_period` في Compose. راجع [المراقبة](../operate/monitoring). + +## تطبيق تغيير {#apply-change} + +يطبّق `configure` تغييره بنفسه. لكل تعديل تجريه في `config/runtime.json`: + +1. أنشئ نسخة من الملف، مثل `sudo cp -p /opt/proanima-arkvory/config/runtime.json /root/runtime.json.bak`. يحتوي على كلمة مرور قاعدة البيانات: أبقِ النسخة خاصة. +2. عدّل الملف في موضعه. حافظ على JSON صالح، وعلى أن تكون كل قيمة سلسلة نصية. +3. تحقق من المالك ووضع الأذونات. على Linux يجب أن يبقيا `root:arkvory` و`0640`. أصلحهما بواسطة `sudo chown root:arkvory runtime.json` و`sudo chmod 0640 runtime.json`. +4. أعد تشغيل الخدمات. لا تُقرأ الإعدادات إلا عند البدء. + + ```bash + sudo systemctl restart arkvory-api arkvory-worker arkvory-backup + ``` + + ```powershell + Restart-Service Arkvoryapi, Arkvoryworker, Arkvorybackup + ``` + + في تثبيت Compose، أوقف الحاويات وابدأها بأمر `compose` من [Docker Compose](./docker#manage): + + ```bash + "${compose[@]}" stop --timeout 120 backup worker api + "${compose[@]}" up -d --wait api worker + "${compose[@]}" up -d backup + ``` + +5. تحقق من النتيجة. توقف القيمة الخارجة عن نطاقها العملية عند البدء برسالة تذكر اسم المتغير، ولا تذكر قيمته أبدًا. على Linux، اقرأها بواسطة `journalctl -u arkvory-api -n 50`. لا يعود Arkvory إلى قيمة افتراضية في هذه الحالة. + +تقطع إعادة التشغيل عمليات النقل الجارية. يستأنفها العملاء. + +## استبدال مفتاح الاسترداد {#replace-recovery-key} + +استبدل مفتاح الاسترداد إذا اشتبهت في أن شخصًا قد قرأ `config/bootstrap-token.txt`. يُخزَّن المفتاح في موضعين يجب تغييرهما معًا: يحتوي ملف `bootstrap-token.txt` على المفتاح، ويحتوي الإدخال `bootstrap-owner` في `keys.json` على SHA-256 الخاص به. أبقِ الإدخال `deployment-health` كما هو. + +1. أنشئ نسخة من `config/keys.json`. +2. احفظ هذا النص البرمجي باسم `replace-recovery-key.mjs`: + + ```js + import { createHash, randomBytes } from 'node:crypto'; + import { readFileSync, writeFileSync } from 'node:fs'; + + const directory = process.argv[2]; + const token = randomBytes(32).toString('hex'); + const keys = JSON.parse(readFileSync(`${directory}/keys.json`, 'utf8')); + const owner = keys.find((key) => key.id === 'bootstrap-owner'); + if (!owner) throw new Error('No bootstrap-owner entry'); + owner.sha256 = createHash('sha256').update(token).digest('hex'); + writeFileSync(`${directory}/keys.json`, JSON.stringify(keys, null, 2)); + writeFileSync(`${directory}/bootstrap-token.txt`, token); + ``` + +3. شغّله بحساب `root` أو مسؤول باستخدام Node.js الخاص بالتثبيت. يكتب النص البرمجي في الملفات الموجودة، لذلك تبقى الملكية وقواعد الوصول كما هي. + + ```bash + sudo /opt/proanima-arkvory/runtime/node ./replace-recovery-key.mjs /opt/proanima-arkvory/config + ``` + + ```powershell + & 'C:\ProgramData\ProAnima\Arkvory\runtime\node.exe' .\replace-recovery-key.mjs 'C:\ProgramData\ProAnima\Arkvory\config' + ``` + + بعد التثبيت بنص برمجي، استخدم Node.js تحت `runtime\node-v24.22.3-…` بدلًا من ذلك. + +4. أعد تشغيل الخدمات كما هو موضح في [تطبيق تغيير](#apply-change). +5. اقرأ المفتاح الجديد من `config/bootstrap-token.txt`، واحذف النص البرمجي ونسخة `keys.json`. + +لا تتأثر الحسابات والرموز الشخصية ومفاتيح الخدمة. فهي موجودة في قاعدة البيانات. diff --git a/wiki/ar/install/docker.md b/wiki/ar/install/docker.md index fc8fe630..fee52450 100644 --- a/wiki/ar/install/docker.md +++ b/wiki/ar/install/docker.md @@ -1,12 +1,273 @@ --- -title: 'Docker Compose' -description: 'Run Arkvory as a Docker Compose project, with its containers, volumes, ports, updates, backup agent and removal.' +title: Docker Compose +description: شغّل Arkvory كمشروع Docker Compose، وتعرّف على حاوياته ووحدات تخزينه ومنافذه وتحديثاته ووكيل النسخ الاحتياطي وإزالته. --- - +# Docker Compose -::: warning -لم تُترجم هذه الصفحة بعد، وهي معروضة بالإنجليزية. -::: +يشغّل تثبيت Compose كلًا من API والعامل ووكيل النسخ الاحتياطي وPostgreSQL في حاويات على مضيف واحد. يبني برنامج التثبيت صورة Arkvory من الإصدار ويبدأ مشروع `proanima-arkvory`. استخدمه على مضيفي الحاويات. على Windows، يُستخدم Docker Desktop للتجربة فقط: راجع [Windows مع Docker Desktop](#docker-desktop). - +لا يتضمن Compose دعم HTTPS مدمجًا. ضع وكيلًا عكسيًا أمامه قبل اتصال العملاء من حواسيب أخرى: راجع [HTTPS والوكيل العكسي](./https). + +## المتطلبات {#requirements} + +| العنصر | المتطلب | +| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| المحرّك | Docker Engine مع إضافة Compose ‏(`docker compose`). يمكن استخدام Podman مع موفّر compose متوافق بواسطة `--engine podman`، لكنه لم يُختبر | +| الحساب | `root` أو مستخدم في مجموعة `docker` | +| البدء عند الإقلاع | يجب أن يبدأ محرّك الحاويات عند الإقلاع، وإلا فلن يعود Arkvory بعد إعادة التشغيل. تحقق باستخدام `systemctl is-enabled docker` | +| المضيف | تثبيت Arkvory واحد لكل مضيف حاويات. اسم المشروع والمنفذ ثابتان | +| المنفذ المتاح | 8080 على `127.0.0.1` | +| الحاويات | حاويات Linux فقط. حاويات Windows غير مدعومة | +| الإنترنت | `nodejs.org` (ينزّل برنامج التثبيت Node.js 24.22.3 ويتحقق من SHA-256 الخاص به)، ومركز التحديث أو GitHub (الإصدار)، وDocker Hub ‏(`node:24.22.3-bookworm-slim` و`postgres:18.7`) | + +لا يثبّت برنامج التثبيت محرّك الحاويات أو مراقب الأجهزة الافتراضية أو WSL ولا يغيّرها. + +## حزمة النشر {#bundle} + +يأخذ برنامج التثبيت إصدارًا تم التحقق منه ويفكّه في `releases//` ضمن جذر التثبيت. ملف Compose هو `releases//deploy/compose.yml` وملف البناء هو `releases//deploy/Dockerfile`. تُبنى الصورة `proanima-arkvory:` على مضيفك انطلاقًا من `node:24.22.3-bookworm-slim`. لا تُسحب أي صورة من سجل حاويات خاص بـArkvory. + +جذر التثبيت هو `/opt/proanima-arkvory` على Linux. يُشرح تنظيمه في [اختيار طريقة التثبيت](./#installation-directory). في تثبيت Compose لا تكون البيانات في `data/`، بل في وحدات التخزين الموضحة أدناه. + +## الحاويات {#containers} + +| الخدمة | الصورة | الدور | +| ------------- | ---------------------------- | ------------------------------------------------------------------------------------------------- | +| `database` | `postgres:18.7` | PostgreSQL. تبلغ عن الجاهزية باستخدام `pg_isready` كل 5 ثوانٍ | +| `api` | `proanima-arkvory:` | HTTP API ووحدة التحكم. منشورة على `127.0.0.1:8080`. فحص السلامة كل 10 ثوانٍ | +| `worker` | `proanima-arkvory:` | تُكمل عمليات الرفع وتنفّذ المهام الخلفية. تبدأ بعد اجتياز API فحص السلامة | +| `backup` | `proanima-arkvory:` | وكيل النسخ الاحتياطي. يقرأ وحدة تخزين الملفات للقراءة فقط. لا ينشر أي منفذ | +| `initialize` | `proanima-arkvory:` | تُنفّذ مرة واحدة بحساب root: تمنح المستخدم 1000 ملكية وحدة تخزين الملفات | +| `migrate` | `proanima-arkvory:` | تُنفّذ مرة واحدة: تنفّذ ترحيلات قاعدة البيانات | +| `vault-owner` | `proanima-arkvory:` | تُنفّذ مرة واحدة، ومع ملف التعريف `maintenance` فقط: تمنح المستخدم 1000 ملكية مخزن النسخ الاحتياطية | + +يُعاد تشغيل الخدمات طويلة التشغيل ما لم توقفها. تعمل حاويات Arkvory بحساب `node` (المستخدم 1000) في الصورة، مع نظام ملفات جذري للقراءة فقط، و`/tmp` في الذاكرة بسعة 64 MiB، وإسقاط جميع القدرات، و`no-new-privileges`، ومهلة توقف قدرها 120 ثانية. يحتفظ Docker بما يصل إلى خمسة ملفات سجل JSON بحجم 20 MiB لكل حاوية. + +## وحدات التخزين وربط أدلة المضيف {#volumes} + +### وحدات تخزين Docker {#docker-volumes} + +| وحدة التخزين | موضع التركيب | المحتوى | +| -------------------------- | ----------------------------------- | --------------------------------------------------------------------------- | +| `proanima-arkvory_storage` | `/var/lib/arkvory` | محتوى الملفات ومساحة الرفع المؤقتة. يركّبها وكيل النسخ الاحتياطي للقراءة فقط | +| `proanima-arkvory_catalog` | `/var/lib/postgresql` في `database` | بيانات PostgreSQL | + +تبقى وحدات التخزين بعد التحديثات و`docker compose down`. ولا يحذفها إلا `down --volumes`. + +### ربط أدلة من جذر التثبيت {#bind-mounts} + +| المسار على المضيف | داخل الحاوية | الوضع | الحاويات التي يركّب فيها | +| ------------------------- | ------------------------------- | ---------------- | ----------------------------------------------------- | +| `config/runtime.json` | `/run/arkvory/runtime.json` | للقراءة فقط | api، worker، backup | +| `config/keys.json` | `/run/arkvory/keys.json` | للقراءة فقط | api، worker | +| `config/health-token.txt` | `/run/arkvory/health-token.txt` | للقراءة فقط | api، worker | +| `config/postgres.env` | ملف بيئة | | database | +| `updates/status` | `/run/arkvory-updates/status` | للقراءة فقط | api، worker | +| `updates/inbox` | `/run/arkvory-updates/inbox` | للقراءة والكتابة | api، worker | +| مخزن النسخ الاحتياطية | `/srv/arkvory-vault` | للقراءة والكتابة | backup، `vault-owner` (فقط عند ضبط مخزن نسخ احتياطية) | +| `config/mirrors` | `/run/arkvory/mirrors` | للقراءة فقط | api، worker (فقط عندما يكون أحد المستودعات مرآة) | + +### المالكون وأوضاع الأذونات {#owners} + +| المسار | المالك ووضع الأذونات | السبب | +| ------------------------------------------------------ | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| جذر التثبيت | مستخدم التثبيت، `0700` | يحتوي الجذر على مفتاح الاسترداد وكلمة مرور قاعدة البيانات. لا يستطيع دخوله إلا مستخدم التثبيت | +| `config/runtime.json`، `keys.json`، `health-token.txt` | `0644` | يجب أن يستطيع المستخدم 1000 داخل الحاوية قراءتها. يحتوي `runtime.json` على كلمة مرور قاعدة البيانات؛ ويمنع وضع الجذر `0700` المستخدمين الآخرين من الوصول إلى هذه الملفات | +| `updates/inbox` | `0777` | الدليل الوحيد الذي تكتب فيه الحاوية على المضيف. قد يختلف معرّف مستخدم الحاوية عن معرّف محدّث المضيف | +| `updates/status` | `0755` | يكتب فيه محدّث المضيف؛ وتقرأه الحاوية فقط | +| وحدة تخزين الملفات | المستخدم 1000 | تضبطها `initialize` عند التثبيت والتحديث | +| مخزن النسخ الاحتياطية | المستخدم 1000 | تضبطه `vault-owner` عند توصيل المخزن. يصبح المخزن حينها ملكًا لمستخدم المضيف ذي المعرّف 1000 | + +## المنافذ {#ports} + +| المنفذ | الخدمة | الإتاحة | +| -------- | ---------------- | ------------------------------------------------- | +| 8080/TCP | API ووحدة التحكم | `127.0.0.1:8080` على المضيف. العنوان ثابت | +| 5432/TCP | PostgreSQL | غير منشور. يمكن الوصول إليه داخل شبكة Compose فقط | + +ينتمي ملف Compose إلى دليل الإصدار الذي تستبدله التحديثات، لذلك لا يمكنك تغيير العنوان المنشور فيه. للوصول إلى وحدة التحكم من حواسيب أخرى، ثبّت وكيلًا عكسيًا على المضيف يمرّر الطلبات إلى `127.0.0.1:8080`. + +## البيئة {#environment} + +لا يضبط ملف Compose أي إعدادات لـArkvory. تقرأ الخدمات `/run/arkvory/runtime.json`، وهو `config/runtime.json` على المضيف. يكتب برنامج التثبيت القيم التالية ويجب ألا تغيّرها: `ARKVORY_HOST` ‏(`0.0.0.0` داخل الحاوية)، و`ARKVORY_PORT` ‏(`8080`)، و`ARKVORY_DATABASE_URL` (حاوية `database` مع كلمة مرور مولّدة)، و`ARKVORY_DATA_DIR` ‏(`/var/lib/arkvory`)، و`ARKVORY_KEYS_FILE`، و`ARKVORY_UPDATE_CONTROL_DIR`. + +يمكنك إضافة إعدادات أخرى، مثل `ARKVORY_TRUSTED_PROXIES` أو الحدود أو `ARKVORY_LOG_LEVEL`. أضفها إلى `config/runtime.json`، ثم أوقف الخدمات وابدأها كما هو موضح في [إدارة المشروع](#manage). القائمة الكاملة في [متغيرات البيئة](../reference/environment). يحتوي `config/compose.env` على `ARKVORY_IMAGE`. يديره برنامج التثبيت؛ فلا تعدّله. + +## التثبيت على Linux {#install} + +1. نزّل `install.sh` من [إصدارات GitHub](https://github.com/ProAnima/Arkvory/releases) واقرأه. +2. شغّله بحساب `root`: + + ```bash + sudo bash ./install.sh --mode compose + ``` + + أضف `--automatic` لتفعيل التحديثات التلقائية، أو `--engine podman` لاستخدام Podman. مع `ARKVORY_RELEASE_VERSION=1.2.3` يثبّت النص البرمجي ذلك الإصدار المستقر. من دون اتصال إنترنت بـGitHub، فكّ `Arkvory-Linux.tar.gz` وشغّل `sudo env ARKVORY_ARTIFACT_DIR="$PWD" bash ./install.sh --mode compose` في الدليل المفكوك. يظل تنزيل Node.js مطلوبًا. + +3. انتظر انتهاء برنامج التثبيت. يتحقق من الإصدار ويفكّه ويبني الصورة ويشغّل قاعدة البيانات وينفّذ `initialize` و`migrate`، ثم يشغّل API والعامل وينتظر حتى تبلغ API عن الجاهزية ثلاث مرات متتالية، ثم يشغّل وكيل النسخ الاحتياطي ويسجّل مؤقّت التحديث. + +يمكن لمستخدم في مجموعة `docker` التثبيت من دون `root` في دليل يملكه: + +```bash +ARKVORY_INSTALL_ROOT="$HOME/arkvory" bash ./install.sh --mode compose +``` + +عندها لا يسجّل برنامج التثبيت مؤقّت تحديث. لا تستطيع وحدة التحكم طلب التحديثات حتى تجدول المحدّث بنفسك. راجع [التحديثات في Compose](#updates-compose). + +## التشغيل الأول والخطوات الأولى {#first-start} + +1. تحقق من تشغيل الحاويات. راجع [إدارة المشروع](#manage) لمعرفة أمر `compose`. + + ```bash + "${compose[@]}" ps + ``` + +2. اقرأ مفتاح الاسترداد: + + ```bash + sudo cat /opt/proanima-arkvory/config/bootstrap-token.txt + ``` + +3. افتح `http://127.0.0.1:8080/console/#onboarding` على الخادم. من حاسوبك، مرّر المنفذ: `ssh -L 8080:127.0.0.1:8080 admin@arkvory.example`. +4. في وحدة التحكم، افتح [[ui:navStart]] ووسّع [[ui:welcomeOwner]]. ألصق المفتاح في [[ui:welcomeRecovery]]، وأدخل اسم المالك وكلمة مرور لا تقل عن 12 حرفًا، واختر [[ui:welcomeCreate]]. + +احتفظ بمفتاح الاسترداد على الخادم. راجع [الأمان](../operate/security). + +## إدارة المشروع {#manage} + +افتح صدفة بحساب root ‏(`sudo -i`) وعرّف أمر `compose` مرة واحدة. يحتاج Compose إلى اسم المشروع ودليل المشروع وملف البيئة وجميع ملفات Compose الخاصة بالتثبيت: + +```bash +root=/opt/proanima-arkvory +node="$root/runtime/node-v24.22.3-linux-x64/bin/node" # linux-arm64 على arm64 +version=$("$node" -p "require('$root/installation.json').current.version") +compose=(docker compose --project-name proanima-arkvory --project-directory "$root" + --env-file "$root/config/compose.env" -f "$root/releases/$version/deploy/compose.yml") +for file in compose.vault.yml compose.mirrors.yml; do + if [[ -f "$root/config/$file" ]]; then compose+=(-f "$root/config/$file"); fi +done +``` + +إذا أغفلت ملفًا موجودًا، يعيد `up` إنشاء الحاوية من دون تركيب مخزن النسخ الاحتياطية أو المرآة. + +| المهمة | الأمر | +| ------------- | --------------------------------------------------------------------------- | +| عرض الحاويات | `"${compose[@]}" ps` | +| قراءة السجلات | `"${compose[@]}" logs --tail 100 api worker backup` | +| إيقاف Arkvory | `"${compose[@]}" stop --timeout 120 backup worker api` | +| بدء Arkvory | `"${compose[@]}" up -d --wait api worker` ثم `"${compose[@]}" up -d backup` | + +يبقي الإيقاف بواسطة `stop` الحاوية متوقفة بعد إعادة تشغيل المحرّك. ابدأها مجددًا بواسطة `up -d`. + +تعمل أوامر دورة الحياة باستخدام Node.js الذي وضعه برنامج التثبيت في الجذر: + +```bash +sudo "$node" "$root/manage.mjs" status --root "$root" +``` + +لا يُثبَّت `arkvory` على مضيف Compose، لذا استدعِ `manage.mjs` للأوامر `status` و`update` و`configure`. تُشرح الأوامر في [الإعدادات](./configuration). + +## السجلات {#logs} + +تكتب الحاويات في ملفات سجل JSON الخاصة بـDocker. اقرأها بواسطة `"${compose[@]}" logs`. تكتب API والعامل سجل JSON واحدًا في كل سطر. راجع [المراقبة](../operate/monitoring). تطبع أوامر دورة الحياة رسائلها في الطرفية، ويكتب مؤقّت التحديث في سجل النظام: `journalctl -u arkvory-update`. + +## التحديثات في Compose {#updates-compose} + +حدّث من وحدة التحكم أو من خلال نافذة التحديث التلقائي أو بالأمر: + +```bash +sudo "$node" "$root/manage.mjs" update --root "$root" +``` + +ينزّل التحديث الإصدار ويتحقق منه ويبني الصورة الجديدة، ثم يوقف `backup` و`worker` و`api` ويشغّلها بالصورة الجديدة. تستمر حاوية `database` في العمل. تبقى وحدات التخزين كما هي. لا يُثبَّت إصدار يغيّر مخطط قاعدة البيانات إلا بعد نسخة احتياطية تم التحقق منها. راجع [التحديثات](./updates). + +يعمل محدّث المضيف مرة كل دقيقة. عند التثبيت بحساب `root` على مضيف systemd، يسجّله برنامج التثبيت باسم `arkvory-update.timer`. من دون `root`، يطبع برنامج التثبيت تحذيرًا. جدْوِل هذا الأمر كل دقيقة بحساب المستخدم الذي يملك التثبيت ويستطيع الوصول إلى محرّك الحاويات، مثلًا باستخدام cron: + +```text +* * * * * /home/admin/arkvory/runtime/node-v24.22.3-linux-x64/bin/node /home/admin/arkvory/manage.mjs updates-poll --root /home/admin/arkvory +``` + +لا تمنح حاويات Arkvory مقبس Docker أبدًا. + +## وكيل النسخ الاحتياطي في Compose {#backup-agent} + +تعمل حاوية `backup` منذ البداية. من دون مخزن نسخ احتياطية، تستمر في العمل وتبلّغ بأنه لم يُضبط مخزن. المخزن دليل على المضيف، خارج جذر التثبيت، وعلى وحدة تخزين منفصلة. + +1. ركّب وحدة تخزين النسخ الاحتياطية وأنشئ دليلًا فارغًا، مثل `/mnt/backup/arkvory`. يجب أن يكون الدليل موجودًا: لا ينشئه Compose. +2. صِله: + + ```bash + sudo "$node" "$root/manage.mjs" configure --root "$root" --backup-vault /mnt/backup/arkvory --vault-key-file /root/arkvory-agent.key + ``` + + يتحقق الأمر من الدليل ويكتب `config/compose.vault.yml`، ويمنح المستخدم 1000 ملكية الدليل، ويمرّر ملف مفتاح الوكيل إلى حاوية النسخ الاحتياطي للقراءة فقط (`--vault-key-file`)، ويعيد تشغيل حاوية النسخ الاحتياطي وحدها. ينجح عندما يبلّغ الوكيل بأن المخزن متاح. وإلا فإنه يستعيد الإعدادات السابقة. + +3. لفصل المخزن، شغّل الأمر نفسه مع `--backup-vault-off`. لا يُمس المخزن نفسه. + +تُشرح الجداول الزمنية والاحتفاظ والاستعادة في [النسخ الاحتياطي](../operate/backups). + +## الإزالة {#remove} + +```bash +"${compose[@]}" down # يزيل الحاويات ويحتفظ بوحدات التخزين +"${compose[@]}" down --volumes # يحذف أيضًا الفهرس وجميع الملفات المخزّنة +``` + +يحذف `down --volumes` جميع البيانات. لا تنفّذه أبدًا على تثبيت يحتوي ملفات. أنشئ نسخة احتياطية أولًا واحتفظ بمخزن النسخ الاحتياطية. + +بعد `down`، يمكنك إزالة ما تبقّى: + +```bash +sudo systemctl disable --now arkvory-update.timer +sudo rm -f /etc/systemd/system/arkvory-update.service /etc/systemd/system/arkvory-update.timer +sudo systemctl daemon-reload +docker image rm "proanima-arkvory:$version" +sudo rm -rf /opt/proanima-arkvory +``` + +لا تحذف الجذر إلا بعد الاستغناء عن الإعدادات ومفتاح الاسترداد. تبقى صور الإصدارات السابقة على المضيف حتى تزيلها. + +## Windows مع Docker Desktop {#docker-desktop} + +استخدم Docker Desktop للتجربة على محطة عمل فقط. Docker Desktop تطبيق لمستخدم واحد: لا تعمل الحاويات إلا ما دام هذا المستخدم مسجّل الدخول وDocker Desktop يعمل. بعد إعادة تشغيل الحاسوب، يظل Arkvory غير متاح حتى يتحقق ذلك. فعّل **الإعدادات > عام > بدء Docker Desktop عند تسجيل الدخول**. يحذّر برنامج التثبيت وأمر `status` عندما يكون هذا الإعداد متوقفًا. للخادم، استخدم [خدمات Windows](./windows). + +1. شغّل Docker Desktop في نمط حاويات Linux. +2. نزّل `install.ps1` من الإصدار واقرأه. +3. افتح Windows PowerShell بحساب المستخدم الذي يشغّل Docker Desktop، **من دون** حقوق مسؤول، وشغّل: + + ```powershell + .\install.ps1 -Mode compose + ``` + + تُشرح المعاملات `-Root` و`-Version` و`-Engine` و`-Artifact` و`-AutomaticUpdates` و`-Pin` في [Windows](./windows#install-with-powershell-and-an-existing-postgresql). مرّر `-Root` و`-Artifact` كمسارات مطلقة. + +4. افتح `http://127.0.0.1:8080/console/#onboarding`، واقرأ مفتاح الاسترداد من `C:\ProgramData\ProAnima\Arkvory\config\bootstrap-token.txt`، وأنشئ المالك كما هو موضح في [التشغيل الأول والخطوات الأولى](#first-start). + +يمنح جذر التثبيت `C:\ProgramData\ProAnima\Arkvory` حق الوصول إلى SYSTEM وAdministrators ومستخدم التثبيت من دون توريث، لأن Docker Desktop يقرأ الأدلة المرتبطة باستخدام رمز وصول هذا المستخدم. لا تشغّل برنامج التثبيت بحقوق مرتفعة عند استخدام Compose. + +لا يسجّل برنامج التثبيت مهمة التحديث `ProAnimaArkvoryUpdate` إلا عند تشغيله كمسؤول. تناسب هذه المهمة محرّكًا يعمل على مستوى النظام، ولا تناسب Docker Desktop. عند استخدام Docker Desktop، سجّل المهمة بحساب مستخدم Docker Desktop. لا تعمل إلا ما دام هذا المستخدم مسجّل الدخول وDocker Desktop يعمل: + +```powershell +$root = 'C:\ProgramData\ProAnima\Arkvory' +$node = "$root\runtime\node-v24.22.3-win-x64\node.exe" +$action = New-ScheduledTaskAction -Execute $node -Argument "`"$root\manage.mjs`" updates-poll --root `"$root`"" -WorkingDirectory $root +$trigger = New-ScheduledTaskTrigger -Once -At (Get-Date).AddMinutes(1) -RepetitionInterval (New-TimeSpan -Minutes 1) +$settings = New-ScheduledTaskSettingsSet -StartWhenAvailable -MultipleInstances IgnoreNew -ExecutionTimeLimit (New-TimeSpan -Minutes 30) +Register-ScheduledTask -TaskName ProAnimaArkvoryUpdate -Action $action -Trigger $trigger -Settings $settings +``` + +أدِر المشروع في PowerShell باستخدام الوسائط نفسها: + +```powershell +$root = 'C:\ProgramData\ProAnima\Arkvory' +$version = (Get-Content "$root\installation.json" -Raw | ConvertFrom-Json).current.version +$compose = @('compose', '--project-name', 'proanima-arkvory', '--project-directory', $root, + '--env-file', "$root\config\compose.env", '-f', "$root\releases\$version\deploy\compose.yml") +foreach ($file in 'compose.vault.yml', 'compose.mirrors.yml') { + if (Test-Path "$root\config\$file") { $compose += @('-f', "$root\config\$file") } +} +docker @compose ps +& "$root\runtime\node-v24.22.3-win-x64\node.exe" "$root\manage.mjs" status --root $root +``` + +يجب أن يكون مخزن النسخ الاحتياطية على Windows وحدة تخزين محلية أو iSCSI. تُرفض مسارات UNC وSMB. لإزالة التثبيت، شغّل `docker @compose down --volumes`، وألغِ تسجيل المهمة بواسطة `Unregister-ScheduledTask -TaskName ProAnimaArkvoryUpdate -Confirm:$false`، واحذف الجذر. أنشئ نسخة احتياطية أولًا. diff --git a/wiki/ar/install/https.md b/wiki/ar/install/https.md index c1fe29ea..a73b3d08 100644 --- a/wiki/ar/install/https.md +++ b/wiki/ar/install/https.md @@ -1,12 +1,265 @@ --- -title: 'HTTPS and reverse proxy' -description: 'Make Arkvory reachable from other computers safely, with built-in TLS or a reverse proxy, and set up the console and CORS for another address.' +title: HTTPS والوكيل العكسي +description: أتِح الوصول إلى Arkvory بأمان من حواسيب أخرى باستخدام TLS المدمج أو وكيل عكسي، واضبط وحدة التحكم وCORS لعنوان آخر. --- - +# HTTPS والوكيل العكسي -::: warning -لم تُترجم هذه الصفحة بعد، وهي معروضة بالإنجليزية. -::: +يستمع التثبيت الجديد على `127.0.0.1:8080` عبر HTTP غير مشفّر. لا تستطيع الوصول إليه إلا البرامج على الخادم. قبل اتصال العملاء من حواسيب أخرى، ضع HTTPS أمامه. تنتقل المفاتيح وكلمات المرور وروابط التنزيل في الطلبات: لا ترسلها عبر HTTP غير مشفّر بين الحواسيب أبدًا. - +## اختيار طريقة {#choose} + +| | TLS المدمج | وكيل عكسي | +| --------------------- | ------------------------------------------------------ | ----------------------------------------------------- | +| التثبيتات | خدمات Windows وLinux (التثبيت الأصلي). لا يشمل Compose | جميعها، وهو الطريقة الوحيدة لـCompose | +| الإعداد | أمر `arkvory configure` واحد مع التراجع | إعداد الوكيل، مع `ARKVORY_TRUSTED_PROXIES` في Arkvory | +| المنفذ | منفذ API، وهو 8080 افتراضيًا | أي منفذ، مثل 443 | +| تجديد الشهادة | تقرأ API الملفات المجدّدة بنفسها | يتولاه الوكيل | +| شهادات العملاء (mTLS) | غير مدعومة | ممكنة في الوكيل | + +## قبل البدء {#before-you-start} + +- احصل على شهادة للاسم الذي يستخدمه العملاء من جهة يثق بها العملاء، مثلًا باستخدام certbot أو win-acme أو جهة إصدار الشهادات في مؤسستك. تحتاج إلى الشهادة مع سلسلتها وإلى المفتاح الخاص، كلاهما كملف PEM. يجب ألا يكون للمفتاح كلمة مرور. +- أنشئ اسم DNS يشير إلى الخادم. +- افتح منفذ HTTPS فقط في الجدار الناري، ولشبكات عملائك فقط. لا تفتح منفذ قاعدة البيانات (54329 أو 45329-45348) أبدًا. + +## TLS المدمج {#built-in-tls} + +### تجهيز الملفات {#tls-files} + +يجب أن تستوفي الملفات هذه القواعد. يتحقق الأمر منها جميعًا قبل تغيير أي شيء. + +- المسارات مطلقة. +- كل ملف هو ملف PEM لا يتجاوز حجمه 1 MiB. يحتوي ملف الشهادة على الشهادة ثم سلسلتها. +- المفتاح مفتاح خاص بصيغة PEM غير مشفّر ويطابق الشهادة. +- الشهادة غير منتهية الصلاحية. +- يستطيع حساب الخدمة قراءة الملفين: `arkvory` على Linux و`LocalService` على Windows. + +يشير Arkvory إلى الملفات ولا ينسخها. ضعها في موضع تبقى فيه عند تجديدها. على Linux، لا تضعها تحت `/home`: لا تستطيع الوحدات رؤيته. لا يستطيع قراءة أدلة بعض أدوات الشهادات إلا `root`؛ انسخ الملفات المجدّدة إلى دليل تستطيع مجموعة الخدمة قراءته، مثلًا باستخدام إجراء يُنفّذ عند التجديد. مثال على Linux: + +```bash +sudo install -d -m 0750 -o root -g arkvory /etc/arkvory/tls +sudo install -m 0644 -o root -g arkvory fullchain.pem /etc/arkvory/tls/fullchain.pem +sudo install -m 0640 -o root -g arkvory privkey.pem /etc/arkvory/tls/privkey.pem +``` + +على Windows، ضع الملفات في مجلد يستطيع `LocalService` قراءته، ولا تسمح بقراءة المفتاح إلا لـSYSTEM وAdministrators و`LocalService`. + +### تفعيل TLS المدمج {#tls-enable} + +1. شغّل الأمر مع المسارات وعنوان الاستماع. يستمع `0.0.0.0` على جميع واجهات IPv4، و`::` على جميع الواجهات، أو أدخل عنوان واجهة واحدة. + + ```bash + sudo arkvory configure --root /opt/proanima-arkvory \ + --tls-cert /etc/arkvory/tls/fullchain.pem \ + --tls-key /etc/arkvory/tls/privkey.pem \ + --listen-host 0.0.0.0 + ``` + + ```powershell + & 'C:\Program Files\ProAnima\Arkvory\arkvory.ps1' configure --root C:\ProgramData\ProAnima\Arkvory ` + --tls-cert C:\ProgramData\ProAnima\Arkvory\tls\fullchain.pem ` + --tls-key C:\ProgramData\ProAnima\Arkvory\tls\privkey.pem ` + --listen-host 0.0.0.0 + ``` + + يكتب الأمر `ARKVORY_TLS_CERT_FILE` و`ARKVORY_TLS_KEY_FILE` و`ARKVORY_HOST` في `config/runtime.json`، ويعيد تشغيل الخدمات وينتظر حتى تستجيب API لفحص الجاهزية عبر HTTPS. لا يقبل الفحص إلا الشهادة المضبوطة. عند النجاح، يطبع الأمر تاريخ انتهاء الشهادة. إذا فشل أي شيء، يستعيد `runtime.json` السابق ويعيد تشغيل الخدمات به ويبلّغ عن السبب. + +2. افتح منفذ API في الجدار الناري لشبكات عملائك. +3. اختبر من حاسوب عميل. يبقى المنفذ 8080 ما لم تغيّر `ARKVORY_PORT`: + + ```bash + curl https://arkvory.example.com:8080/health/status + ``` + + تكون الاستجابة بالحالة 200 مع `{"status":"ready"}`. توجد وحدة التحكم على `https://arkvory.example.com:8080/console/`. + +على Linux، لا يستطيع حساب الخدمة عادةً الاستماع على منفذ أقل من 1024. لتقديم HTTPS على المنفذ 443، استخدم [وكيلًا عكسيًا](#reverse-proxy). + +إذا كانت الشهادة غير صالحة عند البدء، تتوقف API مع خطأ. ولا تعود إلى HTTP غير مشفّر أبدًا. + +### الإعدادات {#tls-settings} + +يضبط `configure` الملفات والعنوان. يُضاف إعدادان آخران يدويًا إلى `runtime.json`. أعد تشغيل الخدمات بعد تغييرهما: راجع [تطبيق تغيير](./configuration#apply-change). + +| المتغير | القيمة الافتراضية | المعنى | +| ---------------------------- | ----------------- | ------------------------------------------------------------------------------------------ | +| `ARKVORY_TLS_MIN_VERSION` | `TLSv1.2` | `TLSv1.2` أو `TLSv1.3` | +| `ARKVORY_TLS_RELOAD_SECONDS` | `300` | تواتر إعادة قراءة API لملفات الشهادة: من 30 إلى 86400 ثانية، أو `0` لقراءتها عند البدء فقط | + +تحمل كل استجابة الترويسة `Strict-Transport-Security: max-age=31536000`. + +### تجديد الشهادة {#tls-renewal} + +اكتب الشهادة والمفتاح المجدّدين في المسارين نفسيهما. لا تحتاج إلى أمر أو إعادة تشغيل. + +- تقارن API الملفات كل `ARKVORY_TLS_RELOAD_SECONDS`. تستخدم الاتصالات الجديدة الشهادة الجديدة. وتحتفظ الاتصالات المفتوحة بالقديمة حتى تنتهي. +- لا يستبدل تجديد معيب (ملفات غير قابلة للقراءة أو مفتاح غير مطابق أو شهادة منتهية) الشهادة العاملة أبدًا. تسجّل API الحدث `tls.reload_failed` وتحاول مجددًا في الفترة التالية. +- خلال آخر 14 يومًا قبل انتهاء الصلاحية، تسجّل API الحدث `tls.expiring` مرة يوميًا. يصلح المقياس `arkvory_tls_certificate_expiry_timestamp_seconds` لإعداد تنبيه. راجع [المراقبة](../operate/monitoring). + +### إيقاف TLS المدمج {#tls-off} + +```bash +sudo arkvory configure --root /opt/proanima-arkvory --tls-off --listen-host 127.0.0.1 +``` + +يُبقي `--tls-off` وحده عنوان الاستماع كما هو. من دون `--listen-host 127.0.0.1`، ستقدّم API عندئذ HTTP غير مشفّر على كل واجهة فتحتها. + +## الوكيل العكسي {#reverse-proxy} + +يقبل الوكيل HTTPS من العملاء ويمرّر HTTP غير مشفّر إلى API. أبقِ API على `127.0.0.1:8080` وثبّت الوكيل على المضيف نفسه. ينشر تثبيت Compose دائمًا `127.0.0.1:8080` فقط، لذا يلائمه وكيل على المضيف مباشرةً. + +1. ثبّت الوكيل واحصل على شهادة له. +2. اضبط الوكيل كما هو موضح في [متطلبات الوكيل](#proxy-requirements). +3. أضف عنوان الوكيل إلى `ARKVORY_TRUSTED_PROXIES`. راجع [الوكلاء الموثوقون](#trusted-proxies). +4. تأكد من تعذّر الوصول إلى منفذ API من حواسيب أخرى. +5. اختبر: يُرجع `curl https://arkvory.example.com/health/status` القيمة `{"status":"ready"}`. + +### متطلبات الوكيل {#proxy-requirements} + +| المتطلب | السبب | +| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | +| قبول أجسام الطلبات بأي حجم (`client_max_body_size 0` في nginx) | يبلغ حجم الملفات عشرات الغيغابايت أو أكثر. ويمكن أن يصل حجم الجزء إلى 1 GiB | +| عدم تخزين أجسام الطلبات أو الاستجابات مؤقتًا (`proxy_request_buffering off`، `proxy_buffering off`) | تمر البايتات تدفقيًا. يملأ التخزين المؤقت قرص الوكيل ويؤخّر النقل | +| السماح بطلبات مدتها 1900 ثانية على الأقل (`proxy_read_timeout`، `proxy_send_timeout`) | قد يستغرق طلب رفع واحد حتى 30 دقيقة (`ARKVORY_UPLOAD_DEADLINE_MS`، افتراضيًا 1 800 000 مللي ثانية) | +| استخدام HTTP/1.1 مع API والإبقاء على الاتصال | ضروري للنقل التدفقي | +| تمرير الاسم العام في `Host` | يبني الخادم منه الروابط المطلقة، مثل الروابط في استجابات Git LFS وnpm | +| إرسال `X-Forwarded-For` و`X-Forwarded-Proto: https` | عنوان العميل للسجلات وحد تسجيل الدخول، ومخطط الروابط المطلقة | +| استبدال `X-Request-Id` بمعرّف من عنده | تحتفظ API بمعرّف الوكيل الموثوق. يجب ألا يختاره العميل | +| عدم كتابة سلسلة الاستعلام في سجل الوصول | تحمل روابط التنزيل سرًا في `?token=` | +| ضبط `Strict-Transport-Security` بنفسه إذا أردت استخدامه | لا ترسله API إلا من المستمع المدمج | + +### nginx {#nginx} + +ضع هذا في سياق `http` لخادم nginx موجود. استبدل الاسم ومسارات الشهادة. يكتب `log_format` المسار من دون سلسلة الاستعلام. + +```nginx +log_format arkvory_path '$remote_addr [$time_local] "$request_method $uri $server_protocol" ' + '$status $body_bytes_sent $request_time $request_id'; +server { + listen 443 ssl; + server_name arkvory.example.com; + ssl_certificate /etc/arkvory/tls/fullchain.pem; + ssl_certificate_key /etc/arkvory/tls/privkey.pem; + access_log /var/log/nginx/arkvory.access.log arkvory_path; + client_max_body_size 0; + client_body_timeout 60s; + location / { + proxy_pass http://127.0.0.1:8080; + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Forwarded-Proto https; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Request-Id $request_id; + proxy_set_header Connection ""; + proxy_request_buffering off; + proxy_buffering off; + proxy_read_timeout 1900s; + proxy_send_timeout 1900s; + } +} +``` + +مع هذه الإعدادات، أدرج الوكيل في `ARKVORY_TRUSTED_PROXIES`، مثل `127.0.0.1`. يجب إبقاء التوجيه `proxy_set_header X-Request-Id $request_id`: فهو يستبدل معرّفًا قد يرسله العميل. + +### Caddy {#caddy} + +```caddyfile +arkvory.example.com { + reverse_proxy 127.0.0.1:8080 { + header_up X-Request-Id {http.request.uuid} + flush_interval -1 + } +} +``` + +يحصل Caddy على الشهادة بنفسه وينقل أجسام الطلبات تدفقيًا، ولا يفرض حدًا لحجم الجسم أو مهلة للاتصال بالخادم الخلفي افتراضيًا، ويضبط `X-Forwarded-For` و`X-Forwarded-Proto` و`X-Forwarded-Host`. لا يكتب Caddy سجل وصول ما لم تفعّل `log`. إذا فعّلته، فأزل سلسلة الاستعلام من العنوان المسجّل. + +### IIS والوكلاء الآخرون {#iis} + +الإعداد المرجعي للمشروع هو ملف nginx أعلاه. هذه الإعدادات المكافئة لـIIS مع Application Request Routing وURL Rewrite. لا يختبرها المشروع. تحقق من الأسماء وفق إصدار IIS لديك. + +- ارفع مهلة وكيل الخادم إلى 1900 ثانية على الأقل، واضبط عتبة التخزين المؤقت للاستجابة على `0`. +- ارفع `maxAllowedContentLength` في تصفية الطلبات إلى قيمته القصوى، 4 294 967 295 بايت. لا يستطيع IIS قبول جسم طلب بحجم 4 GiB أو أكثر، لذا يفشل رفع ملف بهذا الحجم بطلب `curl -T` واحد. يرسل `arkvoryctl` الملفات الكبيرة في أجزاء. +- أرسل المضيف الأصلي و`X-Forwarded-Proto: https` وعنوان العميل في `X-Forwarded-For`. اضبط `X-Request-Id` جديدًا في قاعدة URL Rewrite. +- استبعد سلسلة الاستعلام من سجل IIS. + +### الوكلاء الموثوقون {#trusted-proxies} + +يقبل `ARKVORY_TRUSTED_PROXIES` حتى 32 عنوانًا أو نطاق CIDR، مفصولة بفواصل. تُرفض أسماء المضيفين والمحارف البديلة. لا يُسمح إلا لطلب قادم من أحد هذه العناوين بتعيين: + +- عنوان العميل بواسطة `X-Forwarded-For`. تأخذ API أقرب عنوان غير موثوق، +- معرّف الطلب بواسطة `X-Request-Id`، +- مضيف الروابط المطلقة بواسطة `X-Forwarded-Host`. + +من دون القائمة، يظهر كل عميل كأنه قادم من عنوان الوكيل. يحسب حد تسجيل الدخول عندئذ جميع الأشخاص عميلًا واحدًا، ويُظهر سجل الوصول عنوان الوكيل في `clientIp`. لا تدرج إلا وكلاء تتحكم فيهم. + +على مضيف Compose، قد ترى API الوكيل بعنوان بوابة شبكة Compose بدلًا من `127.0.0.1`. أرسل طلبًا واحدًا عبر الوكيل، واعثر على `clientIp` في سجل `http.access` داخل سجل API، وأدرج ذلك العنوان. + +عدّل `config/runtime.json` وأعد تشغيل الخدمات. راجع [تطبيق تغيير](./configuration#apply-change). + +```json +{ "ARKVORY_TRUSTED_PROXIES": "127.0.0.1,::1" } +``` + +عندما تستمع API على عنوان غير عنوان الاسترجاع المحلي، ومن دون TLS ووكيل موثوق، تسجّل `http.plaintext_exposed` عند البدء. لا يؤدي إعداد الوكيل الصحيح إلى هذا التحذير. + +## وحدة التحكم وعنوان API الخاص بها {#console-api-address} + +تستخدم وحدة التحكم التي يقدّمها Arkvory العنوان الذي فُتحت منه. لا تتصل إلا بخادمها: لا تسمح سياسة أمان المحتوى الخاصة بها بأي عنوان آخر. خلف وكيل، تعمل من دون تغييرات على `https://arkvory.example.com/console/`. + +لاستضافة وحدة التحكم على خادم ويب آخر، مثلًا بجانب بوابة: + +1. انسخ ملفات وحدة التحكم من `releases//apps/web/public/` ضمن جذر التثبيت إلى الخادم الآخر. قدّمها على المسار `/console/` عبر HTTPS، مع أنواع MIME الصحيحة لـ`.js` و`.css`. انسخها مجددًا بعد كل تحديث لـArkvory. +2. في `index.html` المنسوخ، اضبط عنوان Arkvory: + + ```html + + ``` + +3. إذا كان الخادم الآخر يضبط سياسة أمان محتوى، فاسمح لـ`connect-src` بالاتصال بعنوان Arkvory، واسمح بعامل النص البرمجي المحلي. +4. اسمح بأصل وحدة التحكم في Arkvory. راجع [CORS](#cors). + +### CORS {#cors} + +اضبط أصول تطبيقات الويب الموجودة على عناوين أخرى في `ARKVORY_CORS_ORIGINS` وأعد تشغيل API. + +```json +{ "ARKVORY_CORS_ORIGINS": "https://portal.example.com,https://tools.example.com" } +``` + +- تتسع القائمة لما يصل إلى 16 أصلًا، يتألف كل منها من مخطط ومضيف ومنفذ اختياري، ومن دون مسار. HTTPS مطلوب. لا يُقبل HTTP غير المشفّر إلا مع `localhost` و`127.0.0.1` و`[::1]`. +- ينطبق CORS على `/api/v1/*` و`/health/ready`. يحصل الطلب القادم من أصل غير مدرج على الحالة 403 مع السبب `origin_not_allowed`. لا يحتاج الطلب القادم من عنوان الخادم نفسه إلى إدخال. +- لا يمنح إدراج الأصل أي حقوق. يظل كل طلب بحاجة إلى مفتاح أو جلسة، ويخضع لفحوص الوصول على الخادم. يرسل تطبيق الويب المفتاح في الترويسة `Authorization`، وليس في ملف تعريف ارتباط. +- الطرق المسموحة هي GET وHEAD وPOST وPUT وPATCH وDELETE. يمكن للمتصفحات تخزين استجابة الطلب التمهيدي مؤقتًا لمدة 10 دقائق. + +اختبر طلبًا تمهيديًا. يجب أن تكون الاستجابة بالحالة 204 وأن يظهر أصلك في `Access-Control-Allow-Origin`: + +```bash +curl -i -X OPTIONS https://arkvory.example.com/api/v1/auth/me \ + -H 'Origin: https://portal.example.com' \ + -H 'Access-Control-Request-Method: GET' \ + -H 'Access-Control-Request-Headers: authorization' +``` + +## التحقق من الإعداد {#check} + +1. يُرجع `curl https://arkvory.example.com/health/status` الحالة 200 والقيمة `{"status":"ready"}`. ويُتحقق من سلسلة الشهادة من دون استثناءات. +2. افتح وحدة التحكم وسجّل الدخول وارفع ملفًا كبيرًا عبر العنوان نفسه. +3. شغّل `arkvoryctl doctor` بملف تعريف يستخدم عنوان HTTPS. لا توقف التحقق من الشهادة على العملاء: لا يتيح عميل سطر الأوامر ذلك، ولا يقبل HTTP غير المشفّر إلا للحاسوب المحلي. راجع [عميل سطر الأوامر](../protocols/cli). +4. بعد إعادة تشغيل API، لا يحتوي السجل على إدخال `http.plaintext_exposed`. + +## استكشاف الأخطاء وإصلاحها {#troubleshooting} + +| المشكلة | السبب والحل | +| ---------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `HTTPS was not enabled; the previous configuration is restored` | يأتي السبب بعد ذلك في الرسالة: الملفات ليست PEM، أو المفتاح محمي بكلمة مرور، أو المفتاح لا يطابق الشهادة، أو الشهادة منتهية، أو حساب الخدمة لا يستطيع قراءة ملف. أصلح السبب وشغّل الأمر مجددًا | +| `TLS files must be given as absolute paths` | أدخل مسارات كاملة | +| `Built-in TLS is for native installations; use a reverse proxy with Compose` | لا يتضمن Compose دعم TLS مدمجًا. استخدم [وكيلًا عكسيًا](#reverse-proxy) | +| الحالة 413 من الوكيل | حد الجسم منخفض جدًا. استخدم `client_max_body_size 0` في nginx | +| الحالة 502 أو 504، أو انقطاع الرفع بعد دقائق | يخزّن الوكيل الجسم مؤقتًا، أو تقل مهله عن 1900 ثانية | +| تقييد الجميع عند تسجيل الدخول، أو كون `clientIp` هو الوكيل دائمًا | الوكيل غير مدرج في `ARKVORY_TRUSTED_PROXIES` | +| روابط في استجابات Git LFS أو npm تُظهر `http` أو اسمًا داخليًا | لا يمرّر الوكيل `Host` أو `X-Forwarded-Proto: https` | +| تطبيق متصفح يتلقى 403 `origin_not_allowed` | أضف أصله إلى `ARKVORY_CORS_ORIGINS` وأعد التشغيل | + +للمزيد من الإرشادات، راجع [استكشاف الأخطاء وإصلاحها](../operate/troubleshooting) و[الأمان](../operate/security). diff --git a/wiki/ar/install/index.md b/wiki/ar/install/index.md index 8c89bcde..c496127f 100644 --- a/wiki/ar/install/index.md +++ b/wiki/ar/install/index.md @@ -15,13 +15,13 @@ title: اختيار طريقة التثبيت ## خيارات التثبيت {#installation-options} -| الخيار | المنصة | يبدأ بعد إعادة التشغيل دون تسجيل دخول | قاعدة البيانات | التحديثات التلقائية بعد التثبيت | موصى به لـ | -| -------------------------------------------------------------------------------------------- | ------------------------------------------- | -------------------------------------------------------------------------- | ---------------------------------------------------- | -------------------------------------------------------- | -------------------------------------------------------- | -| [برنامج التثبيت الرسومي](./windows) `Arkvory-Setup-x64.exe` | Windows x64 | نعم (خدمات Windows) | PostgreSQL 18.4 مضمَّن، يديره Arkvory | متوقفة | خوادم Windows ومحطات العمل، والتثبيت دون اتصال بالإنترنت | -| [حزمة Linux](./linux) `Arkvory-amd64.deb` و`Arkvory-x86_64.rpm` | Linux x64 مع systemd | نعم (وحدات systemd) | عنقود PostgreSQL مخصص من توزيعتك (الإصدار 16 إلى 19) | متوقفة | خوادم Debian وUbuntu والخوادم المعتمدة على RPM | -| نص برمجي، خدمات أصلية: `install.sh` ([Linux](./linux))، `install.ps1` ([Windows](./windows)) | Linux x64 أو arm64 مع systemd، وWindows x64 | نعم | خادم PostgreSQL الموجود لديك | متوقفة، أو مفعّلة مع `--automatic` / `-AutomaticUpdates` | الأتمتة، وخادم PostgreSQL قائم، وLinux arm64 | -| [Docker Compose](./docker) | Linux مع Docker Engine | نعم، إذا بدأ محرك الحاويات عند الإقلاع | حاوية PostgreSQL 18.4 | متوقفة، أو مفعّلة مع `--automatic` | مضيفات الحاويات | -| [Docker Desktop](./docker) | Windows x64 | لا. لا تعمل الحاويات إلا بعد أن يسجّل المستخدم الدخول ويبدأ Docker Desktop | حاوية PostgreSQL 18.4 | متوقفة، أو مفعّلة مع `-AutomaticUpdates` | التجربة على محطة عمل | +| الخيار | المنصة | يبدأ بعد إعادة التشغيل دون تسجيل دخول | قاعدة البيانات | التحديثات التلقائية بعد التثبيت | موصى به لـ | +| -------------------------------------------------------------------------------------------- | ------------------------------------------- | ------------------------------------------------------------------------- | ---------------------------------------------------- | ------------------------------------------------------- | -------------------------------------------------------- | +| [برنامج التثبيت الرسومي](./windows) `Arkvory-Setup-x64.exe` | Windows x64 | نعم (خدمات Windows) | PostgreSQL 18.7 مضمَّن، يديره Arkvory | متوقفة | خوادم Windows ومحطات العمل، والتثبيت دون اتصال بالإنترنت | +| [حزمة Linux](./linux) `Arkvory-amd64.deb` و`Arkvory-x86_64.rpm` | Linux x64 مع systemd | نعم (وحدات systemd) | عنقود PostgreSQL مخصص من توزيعتك (الإصدار 16 إلى 19) | متوقفة | خوادم Debian وUbuntu والخوادم المعتمدة على RPM | +| نص برمجي، خدمات أصلية: `install.sh` ([Linux](./linux))، `install.ps1` ([Windows](./windows)) | Linux x64 أو arm64 مع systemd، وWindows x64 | نعم | خادم PostgreSQL الموجود لديك | متوقفة، أو مفعّلة مع `--automatic` / `-AutomaticUpdates` | الأتمتة، وخادم PostgreSQL قائم، وLinux arm64 | +| [Docker Compose](./docker) | Linux مع Docker Engine | نعم، إذا بدأ محرك الحاويات عند الإقلاع | حاوية PostgreSQL 18.7 | متوقفة، أو مفعّلة مع `--automatic` | مضيفات الحاويات | +| [Docker Desktop](./docker) | Windows x64 | لا. لا تعمل الحاويات إلا بعد أن يسجّل المستخدم الدخول ويبدأ Docker Desktop | حاوية PostgreSQL 18.7 | متوقفة، أو مفعّلة مع `-AutomaticUpdates` | التجربة على محطة عمل | تثبّت كل الخيارات API والعامل ووكيل النسخ الاحتياطي نفسها. ويتوفر HTTPS المضمَّن للتثبيتات الأصلية فقط. أما تثبيت Compose فيحتاج إلى وكيل عكسي (reverse proxy) لتوفير HTTPS. راجع [HTTPS والوكيل العكسي](./https). @@ -52,16 +52,16 @@ title: اختيار طريقة التثبيت ## المتطلبات {#requirements} -| العنصر | المتطلب | -| ------------------------------- | ----------------------------------------------------------------------------------------------------------------- | -| Windows، برنامج التثبيت الرسومي | x64، إصدار Windows 10.0.17763 أو أحدث (Windows 10 الإصدار 1809، Windows Server 2019). صلاحيات المسؤول | -| Windows، النص البرمجي | x64، وWindows PowerShell. صلاحيات المسؤول للخدمات الأصلية | +| العنصر | المتطلب | +| ------------------------------- | ---------------------------------------------------------------------------------------------------------------- | +| Windows، برنامج التثبيت الرسومي | x64، إصدار Windows 10.0.17763 أو أحدث (Windows 10 الإصدار 1809، Windows Server 2019). صلاحيات المسؤول | +| Windows، النص البرمجي | x64، وWindows PowerShell. صلاحيات المسؤول للخدمات الأصلية | | حزم Linux | x64، وsystemd، وglibc 2.28 أو أحدث، وPython 3. يثبّت مدير الحزم PostgreSQL 16 أو أحدث | -| Linux، النص البرمجي | x64 أو arm64، وsystemd للخدمات الأصلية، وglibc، وBash، وcurl، وPython 3، وtar، وxz | +| Linux، النص البرمجي | x64 أو arm64، وsystemd للخدمات الأصلية، وglibc، وBash، وcurl، وPython 3، وtar، وxz | | Docker Compose | Docker Engine مع إضافة Compose، أو Docker Desktop بوضع حاويات Linux. ويمكن استخدام Podman مع موفّر compose متوافق | | PostgreSQL | قاعدة بيانات واحدة لتثبيت Arkvory واحد. لا تربط تثبيتين بقاعدة البيانات نفسها أبدًا | -| تخزين الملفات | نظام ملفات محلي يدعم الروابط الصلبة (hard links). لا تستخدم مشاركة شبكية لتخزين الملفات | -| مخزن النسخ الاحتياطية | وحدة تخزين منفصلة، مُحمَّلة (mounted) قبل بدء الخدمات. راجع [النسخ الاحتياطية](../operate/backups) | +| تخزين الملفات | نظام ملفات محلي يدعم الروابط الصلبة (hard links). لا تستخدم مشاركة شبكية لتخزين الملفات | +| مخزن النسخ الاحتياطية | وحدة تخزين منفصلة، مُحمَّلة (mounted) قبل بدء الخدمات. راجع [النسخ الاحتياطية](../operate/backups) | لا يحدد Arkvory حدودًا دنيا ثابتة للمعالج أو الذاكرة. خطّط لمساحة القرص لملفاتك وقاعدة البيانات ومخزن النسخ الاحتياطية. يُبقي Arkvory افتراضيًا 1 GiB من المساحة الحرة على وحدة التخزين، ويقبل حتى 10 TiB من عمليات الرفع المحجوزة. ويمكنك تغيير الحدين كليهما. راجع [الإعداد](./configuration). @@ -69,22 +69,22 @@ title: اختيار طريقة التثبيت يعمل برنامج التثبيت الرسومي دون إنترنت. أما الخيارات الأخرى فتنزّل ملفات عبر HTTPS: -| المضيف | يستخدمه | -| -------------------------------------------------------- | --------------------------------------------------------------------------------------------- | -| `nodejs.org` | ينزّل كل من `install.sh` و`install.ps1` الإصدار 24.21.0 من Node.js ويتحقق من SHA-256 الخاص به | -| `api.github.com` و`github.com` ومضيفات التنزيل في GitHub | برامج التثبيت النصية، والتحديثات عندما يتعذر الوصول إلى مركز التحديثات | -| `hub.proanima.net` | التحقق من التحديثات وتنزيلها. راجع [التحديثات](./updates) | -| Docker Hub | يبني Compose صورته من `node:24.21.0-bookworm-slim` ويشغّل `postgres:18.4` | +| المضيف | يستخدمه | +| -------------------------------------------------------- | -------------------------------------------------------------------------------------------- | +| `nodejs.org` | ينزّل كل من `install.sh` و`install.ps1` الإصدار 24.22.3 من Node.js ويتحقق من SHA-256 الخاص به | +| `api.github.com` و`github.com` ومضيفات التنزيل في GitHub | برامج التثبيت النصية، والتحديثات عندما يتعذر الوصول إلى مركز التحديثات | +| `hub.proanima.net` | التحقق من التحديثات وتنزيلها. راجع [التحديثات](./updates) | +| Docker Hub | يبني Compose صورته من `node:24.22.3-bookworm-slim` ويشغّل `postgres:18.7` | دون إنترنت، ثبّت وحدّث من نسخة محلية من الإصدار. راجع [التحديثات](./updates). ## المنافذ {#ports} -| المنفذ | الخدمة | الإتاحة الافتراضية | -| --------- | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | -| 8080/TCP | API ووحدة التحكم (HTTP، أو HTTPS مع TLS المضمَّن) | `127.0.0.1` فقط. يمكن للتثبيت الأصلي أن يستمع إلى عناوين أخرى بعد إعداد HTTPS. وينشره Compose دائمًا على `127.0.0.1:8080` | -| 54329/TCP | PostgreSQL المُدار في برنامج التثبيت الرسومي وحزم Linux | `127.0.0.1` فقط | -| 5432/TCP | حاوية PostgreSQL في تثبيت Compose | غير منشور. لا يمكن الوصول إليه إلا داخل شبكة Compose | +| المنفذ | الخدمة | الإتاحة الافتراضية | +| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | +| 8080/TCP | API ووحدة التحكم (HTTP، أو HTTPS مع TLS المضمَّن) | `127.0.0.1` فقط. يمكن للتثبيت الأصلي أن يستمع إلى عناوين أخرى بعد إعداد HTTPS أو خلف وكيل عكسي موثوق. وينشره Compose دائمًا على `127.0.0.1:8080` | +| 54329/TCP أو 45329-45348/TCP | PostgreSQL المُدار في برنامج التثبيت الرسومي وحزم Linux؛ يُختار أول منفذ متاح أثناء التثبيت، ويكون أقل من 49152 على Windows | `127.0.0.1` فقط | +| 5432/TCP | حاوية PostgreSQL في تثبيت Compose | غير منشور. لا يمكن الوصول إليه إلا داخل شبكة Compose | افتح منفذ HTTPS فقط لشبكات العملاء. ولا تفتح منفذ قاعدة البيانات أبدًا. @@ -92,19 +92,19 @@ title: اختيار طريقة التثبيت جذر التثبيت هو `C:\ProgramData\ProAnima\Arkvory` على Windows و`/opt/proanima-arkvory` على Linux. استخدم دليلًا مخصصًا فارغًا خارج الأدلة الرئيسية للمستخدمين (home) وملفاتهم الشخصية. -| المسار في الجذر | المحتوى | -| -------------------------------- | -------------------------------------------------------------------------- | +| المسار في الجذر | المحتوى | +| -------------------------------- | ------------------------------------------------------------------------ | | `installation.json` | الإصدار المثبَّت ووضع التثبيت وإعداد التحديث التلقائي وتثبيت الإصدار (pin) | -| `journal.json` و`operation.lock` | حالة آخر تحديث، وقفل العملية الجارية | -| `launcher.mjs` و`manage.mjs` | يشغّلان الخدمات وأوامر الإدارة | +| `journal.json` و`operation.lock` | حالة آخر تحديث، وقفل العملية الجارية | +| `launcher.mjs` و`manage.mjs` | يشغّلان الخدمات وأوامر الإدارة | | `releases//` | شيفرة البرنامج لكل إصدار مثبَّت. لا تكتب الخدمات هنا | -| `runtime/` | Node.js. ويضع برنامج التثبيت الرسومي هنا أيضًا PostgreSQL وWinSW | -| `config/` | الإعدادات والمفاتيح ومفتاح الاسترداد. راجع [الإعداد](./configuration) | -| `data/` | تخزين الملفات في التثبيت الأصلي | +| `runtime/` | Node.js. ويضع برنامج التثبيت الرسومي هنا أيضًا PostgreSQL وWinSW | +| `config/` | الإعدادات والمفاتيح ومفتاح الاسترداد. راجع [الإعداد](./configuration) | +| `data/` | تخزين الملفات في التثبيت الأصلي | | `database/` | عنقود PostgreSQL المُدار. وعلى Windows سجلاته أيضًا | -| `logs/` | سجلات خدمات Windows وسجل برنامج التحديث في Windows | -| `service/` | أغلفة خدمات Windows | -| `updates/` | طلبات التحديث من وحدة التحكم وحالة برنامج التحديث | +| `logs/` | سجلات خدمات Windows وسجل برنامج التحديث في Windows | +| `service/` | أغلفة خدمات Windows | +| `updates/` | طلبات التحديث من وحدة التحكم وحالة برنامج التحديث | يحتفظ تثبيت Compose ببياناته في مجلدات Docker (volumes) باسم `proanima-arkvory_storage` (الملفات) و`proanima-arkvory_catalog` (قاعدة البيانات)، لا في `data/`. diff --git a/wiki/ar/install/linux.md b/wiki/ar/install/linux.md index cd09fa7f..d44a5169 100644 --- a/wiki/ar/install/linux.md +++ b/wiki/ar/install/linux.md @@ -1,12 +1,269 @@ --- -title: 'Linux' -description: 'Install Arkvory on Linux from the .deb or .rpm package, start it, operate the systemd services, upgrade and remove it.' +title: Linux +description: ثبّت Arkvory على Linux من حزمة .deb أو .rpm، وابدأ تشغيله، وأدِر خدمات systemd، وحدّثه أو أزله. --- - +# Linux -::: warning -لم تُترجم هذه الصفحة بعد، وهي معروضة بالإنجليزية. -::: +توجد طريقتان لتشغيل Arkvory على Linux: - +- **حزمة** `Arkvory-amd64.deb` أو `Arkvory-x86_64.rpm`. موصى بها. تثبّت خدمات systemd وعنقود PostgreSQL مخصصًا يديره Arkvory. يوفّر مدير الحزم برامج PostgreSQL. +- **النص البرمجي** `install.sh`. يثبّت الخدمات نفسها، لكنه يستخدم خادم PostgreSQL موجودًا. ويدعم arm64 أيضًا. راجع [استخدام PostgreSQL موجود](#existing-postgresql). + +لاستخدام Docker، راجع [Docker Compose](./docker). ولجولة أولى في وحدة التحكم، راجع [البدء السريع](../guide/quick-start). + +## المتطلبات {#requirements} + +| العنصر | المتطلب | +| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| المعالج | x64 للحزم. لا توجد حزم arm64: استخدم `install.sh` على arm64 | +| نظام التهيئة | systemd. لا تُدعم OpenRC أو runit أو أنظمة التهيئة الأخرى | +| مكتبة C | glibc 2.28 أو أحدث. لا يُدعم Alpine Linux ‏(musl) | +| التوزيعات المختبرة | Ubuntu 24.04 لحزمة `.deb` وFedora 44 لحزمة `.rpm`. لم تُختبر توزيعات systemd الأخرى التي تستوفي الاعتماديات أدناه | +| اعتماديات `.deb` | `postgresql` 16 أو أحدث، و`systemd`، و`python3`، و`ca-certificates`، و`libc6` 2.28 أو أحدث، و`libstdc++6`، و`libgcc-s1`، و`libatomic1` | +| اعتماديات `.rpm` | `postgresql-server` 16 أو أحدث، و`systemd`، و`python3`، و`ca-certificates`، و`glibc` 2.28 أو أحدث، و`libstdc++`، و`libatomic` | +| برامج PostgreSQL | الإصدار 16 إلى 19. تبحث خطوة التثبيت في `/usr/lib/postgresql/*/bin` و`/usr/pgsql-*/bin` و`/usr/bin` و`/usr/lib/pgsql/bin` وتختار أعلى إصدار تجده. إذا كانت توزيعتك لا توفّر إلا إصدارًا أقدم، فأضف مستودع PostgreSQL أحدث أولًا | +| الحساب | `root` أو مستخدم يستطيع تشغيل `sudo` | +| المنافذ المتاحة | 8080، و54329 أو أحد المنافذ 45329-45348، على `127.0.0.1` | +| تخزين الملفات | نظام ملفات محلي يدعم الروابط الصلبة. لا تستخدم مشاركة شبكية | + +تتضمن الحزمة Node.js 24. لا يحتاج تثبيتها إلى إنترنت إلا بقدر ما يستخدمه مدير الحزم للحصول على الاعتماديات. + +لا تغيّر الحزمة أي عنقود أو خدمة PostgreSQL موجودة. يشغّل Arkvory عنقوده الخاص باستخدام برامج PostgreSQL. + +## تثبيت الحزمة {#install-package} + +1. نزّل حزمة توزيعتك من [إصدارات GitHub](https://github.com/ProAnima/Arkvory/releases)، مع `native-linux.json` من الإصدار نفسه. +2. قارن SHA-256 للحزمة بالقيمة في `native-linux.json`. الحزم غير موقّعة بمفتاح الناشر، لذا فهذا التحقق هو الدليل الوحيد على ما نزّلته. +3. ثبّت الحزمة. أبقِ `./` قبل اسم الملف: فهي تخبر مدير الحزم بأن الملف محلي. على Debian وUbuntu: + +```bash +sudo apt install ./Arkvory-amd64.deb +``` + +على Fedora والأنظمة المتوافقة مع RPM: + +```bash +sudo dnf install ./Arkvory-x86_64.rpm +``` + +يثبّت مدير الحزم الاعتماديات، ثم يُهيّئ Arkvory نفسه. وهو: + +1. ينسخ Node.js إلى `/opt/proanima-arkvory/runtime/node`، +2. ينشئ حسابَي الخدمة والإعدادات والمفاتيح ومفتاح الاسترداد، +3. ينشئ عنقود PostgreSQL ويشغّله وينفّذ ترحيلات قاعدة البيانات، +4. يسجّل الخدمات ومؤقّت التحديث ويشغّلها، +5. ينتظر حتى تستجيب API لفحص الجاهزية ثلاث مرات متتالية. + +في النهاية يطبع عنوان وحدة التحكم ومسار مفتاح الاسترداد. إذا فشلت خطوة، يتوقف التثبيت مع خطأ. راجع [استكشاف الأخطاء وإصلاحها](#troubleshooting). + +التحديثات التلقائية متوقفة بعد التثبيت. لتفعيلها، راجع [التحديثات](./updates). + +## ما الذي تنشئه الحزمة {#what-package-creates} + +### الملفات والأدلة {#files} + +| المسار | المحتوى | +| --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | +| `/usr/lib/proanima-arkvory/` | محتويات الحزمة: Node.js وملفات الإصدار وبرنامج التثبيت. تديرها الحزمة | +| `/usr/bin/arkvory` | أمر الإدارة. راجع [أمر arkvory](#arkvory-command) | +| `/usr/share/applications/arkvory.desktop` | عنصر قائمة يفتح وحدة التحكم على سطح المكتب. لا يستخدمه خادم بلا سطح مكتب | +| `/opt/proanima-arkvory/` | جذر التثبيت: الإعدادات والبيانات وقاعدة البيانات وشيفرة كل إصدار. يُشرح تنظيمه في [اختيار طريقة التثبيت](./#installation-directory) | +| `/etc/systemd/system/arkvory-*.service`، `arkvory-update.timer` | وحدات الخدمات ومؤقّت التحديث | + +ملكية الجذر هي `root:arkvory` ووضع أذوناته `0711`. داخله، تكون ملكية `config/` هي `root:arkvory` ووضعه `0750`، ويملك `arkvory` الدليلين `data/` و`logs/`، ويملك `arkvory-db` الدليل `database/` بوضع `0700`. لا يستطيع قراءة مفتاح الاسترداد وملفات كلمة مرور قاعدة البيانات إلا `root`. + +### الحسابات {#accounts} + +| الحساب | ما يشغّله | ملاحظات | +| ------------ | --------------------------------- | ------------------------------------------------------------------------------- | +| `arkvory` | API والعامل ووكيل النسخ الاحتياطي | حساب نظام بلا صدفة لتسجيل الدخول، ودليله الرئيسي `/opt/proanima-arkvory/data` | +| `arkvory-db` | قاعدة البيانات | حساب نظام بلا صدفة لتسجيل الدخول. لا يستطيع حساب API قراءة ملفات قاعدة البيانات | + +### الخدمات {#services} + +| الوحدة | حساب التشغيل | سياسة إعادة التشغيل | +| ---------------------- | ------------------------------------------ | -------------------------------------------------- | +| `arkvory-database` | `arkvory-db` | `on-failure`، بعد 10 ثوانٍ | +| `arkvory-api` | `arkvory` | `always`، بعد 10 ثوانٍ | +| `arkvory-worker` | `arkvory` | `always`، بعد 10 ثوانٍ | +| `arkvory-backup` | `arkvory` | `always`، بعد 10 ثوانٍ | +| `arkvory-update.timer` | يشغّل `arkvory-update.service` بحساب `root` | كل دقيقة. تتحقق المهمة من طلبات التحديث والإصدارات | + +تبدأ جميع الوحدات عند الإقلاع (`multi-user.target`). وتُمنح 120 ثانية للتوقف. تعمل مع `NoNewPrivileges` و`/tmp` خاص ونظام ملفات للقراءة فقط خارج أدلتها، ومن دون وصول إلى `/home`. لا تستطيع API والعامل الكتابة إلا في `data/` و`logs/` و`updates/inbox/` ضمن الجذر. يقرأ وكيل النسخ الاحتياطي التخزين ولا يكتب إلا في مخزن النسخ الاحتياطية. ولأن `/home` مخفي عن الوحدات، فلا تضع الشهادات أو مخازن النسخ الاحتياطية أو دليل البيانات تحت أي دليل رئيسي لمستخدم. + +الخدمة التي تتوقف من دون طلبك تبدأ مجددًا بعد 10 ثوانٍ. والعملية التي يتعطل خيطها الرئيسي لمدة 60 ثانية تنهي نفسها وتبدأ مجددًا. فشل فحص الجاهزية وحده لا يعيد تشغيل الخدمة. راجع [الإصلاح الذاتي](../operate/self-healing). + +### المنافذ {#ports} + +| المنفذ | الاستخدام | الإتاحة | +| --------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------- | +| 8080/TCP | API ووحدة التحكم | على `127.0.0.1` فقط، حتى تضبط [HTTPS](./https) | +| 54329/TCP | عنقود PostgreSQL المُدار | على `127.0.0.1` فقط. إذا كان 54329 مشغولًا عند التثبيت، يُختار أول منفذ متاح من 45329-45348؛ ويُحفظ في `database/settings.json` | + +## التشغيل الأول والخطوات الأولى {#first-start} + +1. تحقق من تشغيل الخدمات: + + ```bash + systemctl status arkvory-database arkvory-api arkvory-worker arkvory-backup + ``` + +2. اقرأ مفتاح الاسترداد. لا يستطيع قراءته إلا `root`. + + ```bash + sudo cat /opt/proanima-arkvory/config/bootstrap-token.txt + ``` + +3. افتح `http://127.0.0.1:8080/console/#onboarding`. على خادم بعيد، مرّر المنفذ أولًا وافتح العنوان على حاسوبك: + + ```bash + ssh -L 8080:127.0.0.1:8080 admin@arkvory.example + ``` + +4. في وحدة التحكم، افتح [[ui:navStart]] ووسّع [[ui:welcomeOwner]]. ألصق المفتاح في [[ui:welcomeRecovery]]، وأدخل اسم المالك وكلمة مرور لا تقل عن 12 حرفًا، واختر [[ui:welcomeCreate]]. يتألف الاسم من 3 إلى 64 حرفًا: أحرف لاتينية أو أرقام أو نقطة أو شرطة أو شرطة سفلية. +5. سجّل الدخول بالاسم وكلمة المرور الجديدين. + +المالك هو المسؤول الأول. يبقى مفتاح الاسترداد على الخادم: لا تحذف الملف ولا تنسخه إلى العملاء أو أنظمة CI. تقرؤه أدوات التثبيت. للعمل اليومي، أنشئ حسابات ومفاتيح خدمة. راجع [الحسابات والوصول](../use/accounts) و[الأمان](../operate/security). + +قبل اتصال العملاء من حواسيب أخرى، اضبط [HTTPS](./https). ثم صِل مخزن نسخ احتياطية ونفّذ أول نسخة احتياطية: راجع [النسخ الاحتياطي](../operate/backups). + +للتثبيت على خادم من حاسوبك، يمكنك استخدام Arkvory Remote Setup بدلًا من ذلك. راجع [اختيار طريقة التثبيت](./#remote-installation-over-ssh). + +## أمر arkvory {#arkvory-command} + +تثبّت الحزمة `/usr/bin/arkvory`. يسرد `arkvory help` جميع الأوامر ولا يحتاج إلى حقوق خاصة. يحتاج كل أمر آخر إلى `root` وجذر التثبيت: + +```bash +sudo arkvory status --root /opt/proanima-arkvory +``` + +يطبع `status` نمط التثبيت والإصدار المثبّت وإعداد التحديث التلقائي وتثبيت الإصدار. + +| الأمر | الاستخدام | +| ----------------- | ----------------------------------------------------------------------------------------------- | +| `status` | عرض الإصدار المثبّت وسياسة التحديث | +| `update` | تثبيت إصدار مستقر أحدث الآن. راجع [التحديثات](./updates) | +| `configure` | HTTPS ومخزن النسخ الاحتياطية والمرايا وسياسة التحديث والمركز. راجع [الإعدادات](./configuration) | +| `recover` | إكمال تحديث انقطع. راجع [التحديثات](./updates#recover-update) | +| `finish-install` | متابعة تثبيت انقطع | +| `updates-connect` | ربط وحدة التحكم بمؤقّت التحديث لتثبيت حُدّث من إصدار قديم | + +## السجلات {#logs} + +تكتب الخدمات في سجل النظام. وتكتب API والعامل سجل JSON واحدًا في كل سطر. + +```bash +sudo journalctl -u arkvory-api -u arkvory-worker -u arkvory-backup -u arkvory-database +sudo journalctl -u arkvory-api -f +sudo journalctl -u arkvory-update --since today +``` + +يحتوي `arkvory-update` على مخرجات مؤقّت التحديث. حجم سجل النظام والاحتفاظ به من إعدادات نظام التشغيل. لحقول السجلات والمقاييس، راجع [المراقبة](../operate/monitoring). تطبع أوامر النشر أسطرًا بالصيغة ` INFO|WARN|ERROR `. وتُزال الأسرار منها. + +## الترقية {#upgrade} + +ثبّت حزمة أحدث فوق القديمة، أو حدّث من وحدة التحكم أو باستخدام `arkvory update`. تواصل الخدمات العمل حتى ينتقل التحديث إلى الشيفرة الجديدة. راجع [التحديثات](./updates) لمعرفة السياسات والنسخة الاحتياطية التي تسبق تغيير مخطط قاعدة البيانات وخطوات الاسترداد. + +لا يوجد مستودع apt أو dnf لـArkvory. نزّل كل حزمة جديدة من صفحة الإصدارات. + +## الإزالة {#remove} + +### إزالة الحزمة مع الاحتفاظ بالبيانات {#remove-package} + +على Debian وUbuntu: + +```bash +sudo apt remove proanima-arkvory +``` + +على Fedora والأنظمة المتوافقة مع RPM: + +```bash +sudo dnf remove proanima-arkvory +``` + +توقف الإزالة الخدمات ومؤقّت التحديث وتعطّلها. وتحذف `/usr/lib/proanima-arkvory` و`/usr/bin/arkvory` وعنصر القائمة. وهي **تحتفظ** عمدًا بما يلي: + +- `/opt/proanima-arkvory`: قاعدة البيانات وجميع الملفات والإعدادات ومفتاح الاسترداد، +- ملفات الوحدات في `/etc/systemd/system` والحسابين `arkvory` و`arkvory-db`، +- مخزن النسخ الاحتياطية وملف إعداد systemd الإضافي الخاص به. لا تمس المخزن أبدًا. + +لا يزيل `apt purge` أكثر مما يزيله `apt remove`. إذا ثبّت الحزمة مرة أخرى، تتابع باستخدام البيانات المحتفَظ بها وتبدأ الخدمات. + +### إزالة كل شيء {#remove-all} + +يحذف هذا جميع الملفات المخزّنة والفهرس. أنشئ نسخة احتياطية أولًا واحتفظ بمخزن النسخ الاحتياطية. + +```bash +sudo systemctl disable --now arkvory-update.timer arkvory-backup arkvory-worker arkvory-api arkvory-database +sudo rm -rf /opt/proanima-arkvory +sudo rm -f /etc/systemd/system/arkvory-*.service /etc/systemd/system/arkvory-update.timer +sudo rm -rf /etc/systemd/system/arkvory-backup.service.d +sudo systemctl daemon-reload +sudo userdel arkvory +sudo userdel arkvory-db +``` + +أزِل الحزمة أولًا كما هو موضح أعلاه. بعد التثبيت بنص برمجي لا توجد حزمة: يوقف الأمر الأول الخدمات، وتُبلغ الأوامر التي تذكر `arkvory-database` و`arkvory-db` بأنهما غير موجودين. + +## استخدام PostgreSQL موجود {#existing-postgresql} + +تنشئ الحزمة عنقودها الخاص دائمًا. لاستخدام خادم PostgreSQL تديره مؤسستك، ثبّت بواسطة `install.sh`. ينشئ الخدمات الثلاث نفسها ومؤقّت التحديث، لكنه لا ينشئ وحدة `arkvory-database` ولا أمر `/usr/bin/arkvory`. + +استخدم إصدار PostgreSQL من 16 إلى 19. خصّص قاعدة بيانات واحدة لكل تثبيت Arkvory. لا تربط تثبيتين بقاعدة البيانات نفسها أبدًا. + +1. اطلب من مسؤول قاعدة البيانات قاعدة بيانات فارغة ودورًا يملكها. ينفّذ Arkvory ترحيلاته باستخدام هذا الدور. +2. نزّل `install.sh` من الإصدار واقرأه. يحتاج إلى `bash` و`curl` و`python3` و`tar` و`xz`، وإلى systemd و`root`. +3. شغّله. يسأل النص البرمجي عن عنوان URL للاتصال؛ ويكون الإدخال مخفيًا. + + ```bash + sudo bash ./install.sh --automatic + ``` + + لتمرير العنوان في ملف بدلًا من ذلك، أنشئ ملفًا لا يستطيع قراءته إلا `root`: + + ```json + { "ARKVORY_DATABASE_URL": "postgresql://arkvory:@db.example:5432/arkvory" } + ``` + + ```bash + sudo bash ./install.sh --config /root/arkvory.json + ``` + +4. احذف دليل العمل المؤقت `/opt/proanima-arkvory/bootstrap.*` عند اكتمال التثبيت. إذا أدخلت العنوان عند المطالبة، فسيحتوي عليه الدليل في `native.json`. +5. أنشئ المالك كما هو موضح في [التشغيل الأول والخطوات الأولى](#first-start). + +ينزّل النص البرمجي Node.js 24.22.3 من `nodejs.org` ويتحقق من SHA-256 الخاص به ويثبّت أحدث إصدار مستقر. احذف `--automatic` من الأمر لإبقاء التحديثات التلقائية متوقفة. تغيّر متغيرات البيئة القيم الافتراضية: + +| المتغير | المعنى | القيمة الافتراضية | +| ------------------------- | -------------------------------------------------------- | ----------------------- | +| `ARKVORY_INSTALL_ROOT` | جذر التثبيت. استخدم دليلًا فارغًا ومخصصًا خارج `/home` | `/opt/proanima-arkvory` | +| `ARKVORY_RELEASE_VERSION` | تثبيت هذا الإصدار المستقر بدلًا من الأحدث | أحدث إصدار مستقر | +| `ARKVORY_ARTIFACT_DIR` | التثبيت من `Arkvory-Linux.tar.gz` بعد فكّه بدلًا من GitHub | غير معيّن | + +مرّرها عبر `sudo env`، مثل `sudo env ARKVORY_INSTALL_ROOT=/srv/arkvory bash ./install.sh`. + +عند عدم وجود أمر `arkvory`، استدعِ برنامج الإدارة باستخدام Node.js الذي ثبّته النص البرمجي. استخدم `linux-arm64` على arm64: + +```bash +root=/opt/proanima-arkvory +sudo "$root/runtime/node-v24.22.3-linux-x64/bin/node" "$root/manage.mjs" status --root "$root" +``` + +تتولى بنفسك نسخ خادم PostgreSQL احتياطيًا وصيانته. ينسخ وكيل النسخ الاحتياطي في Arkvory محتوى قاعدة البيانات إلى مخزن النسخ الاحتياطية عبر عنوان URL للاتصال. راجع [النسخ الاحتياطي](../operate/backups). + +## استكشاف الأخطاء وإصلاحها {#troubleshooting} + +| المشكلة | الإجراء | +| ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `PostgreSQL 16–19 server binaries are required` | برامج PostgreSQL مفقودة أو قديمة جدًا. ثبّت خادم PostgreSQL بإصدار من 16 إلى 19 وثبّت الحزمة مجددًا | +| `Use a dedicated empty installation directory` | يحتوي `/opt/proanima-arkvory` على ملفات من تثبيت أول توقف قبل حفظ `installation.json`. لا يستبدل برنامج التثبيت الإعدادات أبدًا. اقرأ السجل ومخرجات مدير الحزم وأصلح السبب. يمكن نقل دليل لا يحتوي بيانات بعد إلى مكان آخر لتستطيع التثبيت مجددًا. لا تحذف `config/` أو `database/` من تثبيت يحتوي بيانات | +| `Installation is locked` | هناك عملية قيد التشغيل أو عملية تعطلت. أوقف مؤقّت التحديث واقرأ `journal.json` في الجذر، ولا تحذف `operation.lock` قبل معرفة الحالة. راجع [التحديثات](./updates#recover-update) | +| وجود `database/bootstrap-started` مع غياب `database/initialized` | انقطع إنشاء قاعدة البيانات. لا تحذف العنقود ولا تكرّر SQL يدويًا. أصلح السبب وشغّل `sudo arkvory finish-install --root /opt/proanima-arkvory` | +| خدمة لا تبدأ | `journalctl -u arkvory-api -n 100`. يطبع فشل البدء سجل JSON واحدًا يحتوي `reason` يذكر اسم الإعداد، ولا يذكر قيمته أبدًا | +| المنفذ 8080 مشغول | يستخدمه برنامج آخر. حرّر المنفذ أو اضبط `ARKVORY_PORT` في `config/runtime.json`. راجع [الإعدادات](./configuration#address-and-port). منفذ قاعدة البيانات هو الذي اختير عند التثبيت (54329 أو 45329-45348)؛ ولا يتغيّر تلقائيًا | + +إذا توقف التثبيت بعد كتابة `installation.json`، فيمكنك أيضًا تكرار خطوة تهيئة الحزمة: `sudo dpkg --configure -a` على Debian وUbuntu، أو تثبيت الحزمة نفسها مجددًا على أنظمة RPM. + +للمزيد من الإرشادات، راجع [استكشاف الأخطاء وإصلاحها](../operate/troubleshooting). diff --git a/wiki/ar/install/updates.md b/wiki/ar/install/updates.md index 8baed1c2..b7550c71 100644 --- a/wiki/ar/install/updates.md +++ b/wiki/ar/install/updates.md @@ -1,12 +1,246 @@ --- -title: 'Updates' -description: 'How Arkvory finds, verifies and installs new releases, with manual and automatic updates, the backup before a schema change, rollback, pinning and offline updates.' +title: التحديثات +description: كيفية عثور Arkvory على الإصدارات الجديدة والتحقق منها وتثبيتها، والتحديث اليدوي والتلقائي، والنسخ الاحتياطي قبل تغيير المخطط، والتراجع، وتثبيت إصدار، والتحديث دون إنترنت. --- - +# التحديثات -::: warning -لم تُترجم هذه الصفحة بعد، وهي معروضة بالإنجليزية. -::: +تعلن ProAnimaStudio كل إصدار مستقر من Arkvory عبر مركز. يسأل خادمك المركز عن الإصدار المسموح بتثبيته، وينزّل الإصدار ويتحقق من توقيعه ويثبّته. لا يُثبَّت شيء إلا إذا بدأت التحديث أو فعّلت التحديثات التلقائية. التحديثات التلقائية متوقفة افتراضيًا. - +التحديث ليس تحديثًا متدرجًا. تتوقف الخدمات لفترة قصيرة وتنقطع عمليات النقل الجارية. يواصل العملاء الذين يدعمون الاستئناف عمليات النقل. نفّذ التحديث خلال نافذة صيانة. + +## كيفية عمل التحديثات {#how-it-works} + +- **الإصدارات.** لا تُثبَّت إلا الإصدارات المستقرة المنشورة برقم `x.y.z`. تُرفض الإصدارات التمهيدية والفروع والعناوين الاعتباطية والإصدارات الأقدم. +- **المركز يقرر.** كل 6 ساعات يسأل الخادم المركز عن الإصدار المعتمد له. يؤخّر المركز إتاحة إصدار جديد أو يتيحه تدريجيًا. تأتي الملفات نفسها من GitHub عبر روابط قصيرة العمر يصدرها المركز. لا يحتاج الخادم إلى رمز GitHub لذلك. +- **التوقيع.** توقّع ProAnimaStudio بيان كل إصدار. يتحقق الخادم من التوقيع بمفتاح عام مدمج في البرنامج المثبّت، ثم من SHA-256 للأرشيف. لا يُثبَّت إصدار غير موقّع أو معدّل، سواء أتى من المركز أو GitHub. لا يُعتمد على المركز لضمان السلامة. +- **محدّث المضيف.** يشغّل مؤقّت على الخادم (`arkvory-update.timer` على Linux، والمهمة `ProAnimaArkvoryUpdate` على Windows) المحدّث كل دقيقة. يلتقط طلبات وحدة التحكم، ويتحقق من الإصدارات عند مرور 6 ساعات على آخر فحص، ويبدأ التحديث التلقائي في ساعته. تُجرى الفحوص حتى عندما يكون التثبيت التلقائي متوقفًا. + +### ما الذي يفعله التحديث {#what-an-update-does} + +1. بينما تستمر الخدمات في العمل، ينزّل الإصدار ويتحقق من التوقيع وSHA-256، ويفك الملفات في `releases//` ضمن جذر التثبيت. وفي Compose، يبني الصورة الجديدة. +2. إذا غيّر الإصدار مخطط قاعدة البيانات، ينشئ نسخة احتياطية حديثة ويتحقق منها أولًا. راجع [النسخة الاحتياطية قبل التحديث](#backup). +3. يوقف وكيل النسخ الاحتياطي والعامل وAPI. يحصل كل منها على مهلة تصل إلى 120 ثانية للانتهاء. +4. يحوّل التثبيت إلى الإصدار الجديد. عند تغيير المخطط، يُنفَّذ الترحيل الآن. +5. يبدأ API والعامل وينتظر حتى تبلغ API عن الجاهزية ثلاث مرات متتالية. ثم يبدأ وكيل النسخ الاحتياطي. لا يشمل الفحص الوكيل: إذا لم يبلّغ عن حالته خلال نحو 90 ثانية، يطبع التحديث تحذيرًا ويبقى التحديث مطبّقًا. +6. يرسل الحدث المجهول الهوية `updated` إلى المركز إذا كانت الإحصاءات مفعّلة. لا يؤدي فشل هذه الخطوة إلى التراجع عن التحديث أبدًا. + +يبقى الإصدار القديم في `releases/`. وتبقى جميع البيانات والمفاتيح والإعدادات كما كانت. + +## التحقق من التحديثات {#check} + +سجّل الدخول إلى وحدة التحكم كمسؤول وافتح [[ui:updates]]. تعرض الصفحة [[ui:updateCurrent]] و[[ui:updateLatest]] و[[ui:updateChecked]]. اختر [[ui:updateCheck]] لسؤال المركز الآن. بعد تسجيل الدخول، يخبرك شريط يحمل [[ui:updateOpen]] بوجود إصدار أحدث. + +إذا فشل فحص، مثلًا بسبب غياب الوصول إلى الشبكة، تحتفظ الصفحة بآخر إصدار وجدته وتضع علامة تفيد باحتمال تقادمه. يُعاد الفحص بعد 6 ساعات أو عندما تختار [[ui:updateCheck]]. + +على الخادم، يعرض `arkvory status --root ` الإصدار المثبّت وإعداد التحديث التلقائي وتثبيت الإصدار. + +إذا ذكرت الصفحة أن محدّث المضيف غير متصل، فشغّل `arkvory updates-connect --root `. يربط وحدة التحكم بمؤقّت التحديث لتثبيت حُدّث من إصدار قديم. إذا ذكرت الصفحة أن المحدّث توقف عن الإبلاغ، فهذا يعني أن المؤقّت أو المهمة لم يعمل منذ 5 دقائق. راجع [استكشاف الأخطاء وإصلاحها](#troubleshooting). + +## التثبيت اليدوي {#manual} + +### من وحدة التحكم {#manual-console} + +1. افتح [[ui:updates]] وتحقق من أن [[ui:updateLatest]] يعرض الإصدار المطلوب. +2. اختر [[ui:updateInstall]]. يذكر مربع الحوار الإصدار ويحذّر من احتمال انقطاع عمليات النقل. +3. اختر [[ui:updateConfirmButton]]. ترسل وحدة التحكم الإصدار وقيمة SHA-256 اللذين رأيتهما. إذا تغيّرت البايتات المنشورة منذ ذلك الحين، يُرفض الطلب. +4. انتظر. يُقبل الطلب فورًا؛ ويلتقطه محدّث المضيف خلال دقيقة. قد تفقد الصفحة الاتصال أثناء إعادة تشغيل الخدمات، وتتصل مجددًا تلقائيًا. لا ترسل طلبًا ثانيًا. + +ترفض وحدة التحكم التثبيت عندما يكون الإصدار مثبّتًا لمنع تغييره. راجع [تثبيت إصدار](#pin). + +### باستخدام أمر {#manual-command} + +```bash +sudo arkvory update --root /opt/proanima-arkvory +sudo arkvory update --root /opt/proanima-arkvory --version 1.2.3 +``` + +من دون `--version`، يثبّت الأمر الإصدار الذي يعتمده المركز لهذا الخادم. ومع `--version`، يثبّت ذلك الإصدار المستقر بعينه، ويجب أن يكون أحدث من المثبّت. ينتهي الأمر برمز خطأ عند فشل التحديث. تُشرح كيفية تشغيل الأمر على كل منصة في [الإعدادات](./configuration#lifecycle-commands). + +## التحديثات التلقائية {#automatic} + +فعّل التحديثات التلقائية بإحدى ثلاث طرق: + +- في وحدة التحكم، افتح [[ui:updates]]، وحدد [[ui:updateAutomatic]] ضمن [[ui:updateSettings]]، واختر [[ui:updateHour]] ثم [[ui:updateSave]]. +- على الخادم: `arkvory configure --root --enable-updates`. +- عند التثبيت بنص برمجي: `--automatic` مع `install.sh`، و`-AutomaticUpdates` مع `install.ps1`. + +أوقفها من وحدة التحكم أو بواسطة `arkvory configure --root --disable-updates`. + +| القاعدة | القيمة | +| ------------ | ----------------------------------------------------------------------------------------------------------- | +| النافذة | الساعة المختارة بتوقيت UTC. القيمة الافتراضية من 03:00 إلى 03:59 UTC. لا يمكن ضبط الساعة إلا من وحدة التحكم | +| المحاولات | محاولة واحدة على الأكثر في كل يوم بتوقيت UTC، سواء نجحت أم فشلت. لا تُعوَّض النافذة الفائتة لاحقًا خلال اليوم | +| حالات التخطي | تثبيت إصدار، أو فشل آخر فحص، أو عدم معرفة إصدار أحدث | +| الإصدار | أحدث إصدار اعتمده المركز في آخر فحص | + +جدْوِل النسخ الاحتياطية خارج نافذة التحديث. يوقف التحديث وكيل النسخ الاحتياطي، وتنقطع النسخة الاحتياطية الجارية وتُعاد إلى الطابور. + +## النسخة الاحتياطية قبل التحديث {#backup} + +لا ينشئ التحديث الذي لا يغيّر مخطط قاعدة البيانات نسخة احتياطية. اعتمد على نسخك الاحتياطية المجدولة. + +لا يُثبَّت إصدار يغيّر مخطط قاعدة البيانات إلا بعد نسخة احتياطية حديثة تم التحقق منها. ينفّذ المحدّث ذلك بينما لا تزال الخدمات تعمل: + +1. يطلب من وكيل النسخ الاحتياطي نسخة احتياطية جديدة وينتظر إنشاءها وفحصها. ينتظر حتى 6 ساعات. تعرض وحدة التحكم أثناء ذلك أن الإصدار قيد التثبيت. +2. عندئذ فقط يوقف الخدمات ويرحّل قاعدة البيانات ويبدأ الإصدار الجديد. + +تحتاج النسخة الاحتياطية إلى ثلاثة أمور: مخزن نسخ احتياطية موصول ومتاح، ووكيل نسخ احتياطي متصل، ونسخة احتياطية واحدة على الأقل اكتملت سابقًا. النسخ الكامل الأول لتيرابايتات من البيانات عمل مخطط له، ولا يكون أبدًا أثرًا جانبيًا لتحديث. إذا غاب أحد الأمور الثلاثة، **يُرفض التحديث قبل تغيير أي شيء**. تستمر الخدمات في العمل، وتُظهر وحدة التحكم أن التثبيت رُفض، ويُعيد التحديث التلقائي المحاولة في اليوم التالي. صِل المخزن ونفّذ أول نسخة احتياطية: راجع [النسخ الاحتياطي](../operate/backups). + +التغييرات التي تصل بعد اللقطة وقبل توقف الخدمات لا تكون في تلك النسخة الاحتياطية. لا تصبح النسخة الاحتياطية لازمة إلا إذا فشل الإصدار الجديد بعد ترحيله: راجع [التراجع والاسترداد](#rollback). + +### الترقية باستخدام نسخة احتياطية خاصة بك {#manual-upgrade} + +من دون مخزن مدمج، أنشئ بنفسك نسخة احتياطية لقاعدة البيانات ولكامل التخزين وتحقق منها، ثم أعطِ المحدّث ملفًا يسجّلها: + +```bash +sudo arkvory upgrade --root /opt/proanima-arkvory --version 1.2.3 --backup-record /secure/backup-record.txt +``` + +الملف ملاحظة تكتبها بنفسك. لا يتحقق المحدّث إلا من وجوده؛ ولا يثبت ذلك اكتمال النسخة الاحتياطية. السجل والتراجع هما نفسهما في `update`. لا يعمل هذا الأمر إلا نحو إصدار أحدث، ويُرفض عندما يكون إصدار آخر مثبّتًا لمنع تغييره. + +## التراجع والاسترداد {#rollback} + +### التراجع التلقائي {#automatic-rollback} + +- **لا تغيير في المخطط.** إذا لم يصبح الإصدار الجديد جاهزًا، يوقفه المحدّث ويستعيد الإصدار السابق وينتظر الجاهزية ويبلّغ بالرسالة `Update failed; previous release restored`. +- **تغيير في المخطط مع فشل الترحيل.** يُنفَّذ الترحيل في معاملة واحدة. يُتراجع عن الترحيل الفاشل، ويبدأ الإصدار السابق مجددًا على المخطط الذي لم يتغيّر. +- **تغيير في المخطط وعدم بدء الإصدار الجديد بعد الترحيل.** لا يستطيع الإصدار السابق قراءة المخطط الجديد، لذلك لا توجد طريقة تلقائية للعودة. يضع المحدّث العلامة `maintenance-required` في السجل ويذكر نقطة النسخ الاحتياطي. أصلح السبب وشغّل `recover` الذي يُكمل التحديث. أو استعد نقطة النسخ الاحتياطي المذكورة في `journal.json` وشغّل الإصدار السابق. + +لا يحتوي Arkvory على أمر للرجوع إلى إصدار أقدم. يرفض الأمر الإصدار الأقدم. يبقى الإصدار السابق في `releases/` من أجل التراجع التلقائي فقط. + +### استرداد تحديث انقطع {#recover-update} + +يترك التعطل أو انقطاع الطاقة أثناء التحديث شيئين في جذر التثبيت: القفل `operation.lock` والسجل `journal.json`. ترفض التحديثات الجديدة ومعظم الأوامر العمل حتى تُجري الاسترداد. لا تحذف القفل قبل معرفة الحالة أبدًا. + +عندما لا يكون هناك تحديث جارٍ (السجل مكتمل أو مفقود)، ولا تعود العملية التي أمسكت القفل تعمل، مثل فحص تحديث توقف أو، في [عنقود](../operate/cluster)، قفل أُخذ على خادم عُزل، يزيل الأمر التالي القفل بنفسه ويسجّل تحذيرًا. + +1. أوقف مؤقّت التحديث كي لا يبدأ تشغيل جديد. على Linux: `sudo systemctl stop arkvory-update.timer`. على Windows: `Disable-ScheduledTask -TaskName ProAnimaArkvoryUpdate`. في تثبيت Compose بلا مؤقّت، أوقف مهمتك المجدولة. +2. تأكد من عدم وجود عملية محدّث قيد التشغيل. احفظ `journal.json` والسجلات. +3. عندئذ فقط احذف `operation.lock`. +4. شغّل `arkvory recover --root `. يتقدم في الاتجاه الذي يسمح به السجل: + - لتحديث من دون تغيير المخطط، أو قبل بدء الترحيل، يعود إلى الإصدار السابق، + - بعد بدء الترحيل، يتقدم إلى الأمام: يكرّر الترحيل، وهو آمن التكرار، ويبدأ الإصدار الجديد. +5. تحقق من جاهزية الخدمات ومن نجاح تنزيل تجريبي. ابدأ المؤقّت مجددًا: `sudo systemctl start arkvory-update.timer`، أو `Enable-ScheduledTask -TaskName ProAnimaArkvoryUpdate`. + +إذا كان طلب وحدة التحكم الذي بدأ التحديث ما زال مخزّنًا، فإن `arkvory updates-reset --root ` يزيله. لا تشغّله إلا بعد التحقق من الحالة. وهو لا يزيل القفل. + +## تثبيت إصدار {#pin} + +ثبّت إصدارًا لمنع أي تحديث إلى إصدار آخر. + +```bash +sudo arkvory configure --root --pin # تثبيت الإصدار الموجود حاليًا +sudo arkvory configure --root --pin --version 1.2.3 # تثبيت إصدار مستقر آخر +sudo arkvory configure --root --unpin +``` + +ما دام الإصدار مثبّتًا لمنع تغييره: + +- لا تفعل التحديثات التلقائية شيئًا، +- ترفض وحدة التحكم تثبيت إصدار وتطلب إزالة التثبيت المانع للتغيير على الخادم، +- يثبّت `arkvory update` الإصدار المحدد بالتثبيت، ويرفض أي `--version` آخر، +- تستمر الفحوص، لذلك تواصل وحدة التحكم عرض الإصدارات الأحدث. + +لتثبيت إصدار أحدث بعد تثبيت إصدار أقدم لمنع تغييره، ثبّت الإصدار الأحدث وشغّل `arkvory update`. يمكنك أيضًا تثبيت إصدار عند التثبيت بنص برمجي: `--pin` مع `install.sh`، و`-Pin` مع `install.ps1`. + +## المركز والقناة والإحصاءات {#hub} + +### ما الذي يرسله الخادم إلى المركز {#hub-data} + +| التوقيت | ما يُرسل | +| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| فحص التحديث، كل 6 ساعات أو عند الطلب | طلب تحديث المشروع `arkvory` مع الإصدار المثبّت ونظام التشغيل (`linux` أو `windows`) والمعالج (`x86_64` أو `aarch64`) والقناة. عند تفعيل الإحصاءات، تُضاف الترويسة `X-Install-Id` مع معرّف تثبيت عشوائي | +| اكتمال تحديث، مع تفعيل الإحصاءات | حدث `updated` واحد مع معرّف التثبيت والإصدار الجديد ونظام التشغيل والمعالج والقناة | +| تنزيل إصدار | يستجيب المركز برابط إلى GitHub. تأتي الملفات من هناك | + +لا يُرسل أي مفتاح أو حساب أو اسم مضيف أو محتوى مخزّن، ولا تصل أي بيانات اعتماد إلى المركز. معرّف التثبيت قيمة عشوائية لا تعرّف إلا التثبيت. وفقًا للمشروع، لا يخزّن المركز عناوين IP أو أسماء أو محتوى. يتلقى المركز أيضًا الملاحظات التي يرسلها المستخدم من وحدة التحكم. وهذا إجراء منفصل ينفّذه المستخدم. + +عند إيقاف الإحصاءات، لا يرسل الخادم معرّف تثبيت أو أحداثًا. ولا يعرض المركز إصدارًا عندئذ إلا عندما يكون قد أتاحه لجميع التثبيتات. + +### الخيارات {#hub-options} + +| الإعداد | القيمة الافتراضية | كيفية تغييره | +| ------------ | -------------------------- | -------------------------------------------------------------------------------------------------------------- | +| الإحصاءات | مفعّلة | وحدة التحكم: [[ui:updateStatistics]] ضمن [[ui:updateSettings]]. الأمر: `--statistics off` أو `--statistics on` | +| القناة | `stable` | `--update-channel beta` لتلقي الإصدارات التي تتيحها ProAnimaStudio مبكرًا، و`--update-channel stable` للعودة | +| عنوان المركز | `https://hub.proanima.net` | `--hub-url https://hub.example` لمركز خاص بك، و`--hub-off` لاستخدام GitHub فقط. يجب أن يستخدم العنوان HTTPS | + +جميعها خيارات لأمر `arkvory configure --root ` وتسري من دون إعادة تشغيل. تُخزَّن الإعدادات في `config/hub.json`. يغيّر تعديل عنوان المركز أيضًا وجهة إرسال ملاحظات وحدة التحكم، بعد إعادة تشغيل الخدمات التالية. + +### عند تعذّر الوصول إلى المركز {#hub-unreachable} + +إذا لم يستجب المركز (فشل في الشبكة أو انتهاء المهلة أو خطأ في الخادم)، يقرأ المحدّث أحدث إصدار مستقر على GitHub بدلًا منه ويسجّل تحذيرًا. ويجري فحوص التوقيع وSHA-256 نفسها. يُعد رفض المركز (الحالة 4xx) أو ملف مفقود أو توقيع غير صالح خطأ، ولا يُستخدم مصدر بديل عندئذ. + +إذا كانت إصدارات GitHub تحتاج إلى مصادقة، فأنشئ الملف `github-token.txt` في جذر التثبيت برمز يستطيع قراءة محتويات المستودع. يجب ألا يستطيع قراءة الملف إلا المسؤولون. يستخدمه المحدّث، ولا تستخدمه الخدمات، ولا يُمرَّر أبدًا كخيار أمر. مع `--hub-off` يستخدم المحدّث GitHub دائمًا. + +يحتاج الخادم إلى الوصول عبر HTTPS إلى `hub.proanima.net` و`api.github.com` و`github.com` ومضيفي التنزيل في GitHub. + +## التثبيتات دون إنترنت {#offline} + +لا يستطيع خادم بلا اتصال إنترنت التحقق من الإصدارات. تعرض صفحة [[ui:updates]] عندئذ أن الفحص فشل. لا يؤثر ذلك في الخدمات. حدّث من الملفات بدلًا من ذلك. + +1. على حاسوب متصل بالإنترنت، نزّل حزمة التشغيل الخاصة بمنصة خادمك: `Arkvory-Linux.tar.gz` أو `Arkvory-Windows.zip`. قارن SHA-256 الخاص بها بالقيمة في `release-checksums.json` للإصدار. +2. انسخ حزمة التشغيل إلى الخادم وفكّها. يحتوي الدليل على `arkvory-release.json` و`arkvory-runtime.zip` و`arkvory-setup.mjs`. لا تتضمن حزمة التشغيل ملف توقيع. نزّل `arkvory-release.json.sig` من صفحة الإصدار نفسها وضعه بجوار `arkvory-release.json`: عندئذ يتحقق المحدّث من التوقيع أيضًا. +3. شغّل التحديث مع المسار المطلق للدليل: + + ```bash + sudo arkvory update --root /opt/proanima-arkvory --artifact /media/release + ``` + + ```powershell + & 'C:\Program Files\ProAnima\Arkvory\arkvory.ps1' update --root C:\ProgramData\ProAnima\Arkvory --artifact D:\release + ``` + +يتحقق المحدّث من SHA-256 للأرشيف مقارنةً بالبيان. ولا يتحقق من التوقيع إلا عند وجود `arkvory-release.json.sig` بجوار البيان. اختيار دليل محلي قرارك، لذلك لا يشترط التحديث التوقيع. من دونه، تكون مقارنة حزمة التشغيل بـ`release-checksums.json` في الخطوة 1 دليلك الوحيد على المصدر. تنطبق قواعد تغيير المخطط نفسها: تحتاج إلى نسخة احتياطية تم التحقق منها أولًا. + +تحمل الحزمة الأصلية أو `Arkvory-Setup-x64.exe` إصدارها ولا تحتاج إلى إنترنت. يبني تحديث Compose الصورة على المضيف. ولا يحتاج إلى Docker Hub إلا إذا لم تكن الصورة الأساسية `node:24.22.3-bookworm-slim` موجودة على المضيف بعد. + +## التحديث حسب المنصة {#platforms} + +### Windows {#platform-windows} + +شغّل `Arkvory-Setup-x64.exe` أحدث فوق المثبّت. يعثر برنامج التثبيت على البيانات ولا يسأل عن المالك مجددًا. يحدّث البرامج والخدمات وإصدار قاعدة البيانات بالطريقة نفسها التي يعمل بها تحديث من وحدة التحكم. يُرفض تثبيت إصدار أقدم، ويصلح تثبيت الإصدار نفسه الخدمات. لا تبدأ برنامج التثبيت أثناء تشغيل تحديث. لا يتوفر برنامج التثبيت إلا بالإنجليزية والروسية. يمكنك أيضًا التحديث من وحدة التحكم أو بالأمر. + +### حزم Linux {#platform-linux} + +نزّل الحزمة الأحدث من صفحة الإصدارات وثبّتها مثل الأولى: `sudo apt install ./Arkvory-amd64.deb` أو `sudo dnf install ./Arkvory-x86_64.rpm`. لا يوجد مستودع apt أو dnf، لذلك لا يعثر `apt upgrade` و`dnf upgrade` على إصدارات جديدة. تنفّذ خطوة تهيئة الحزمة التحديث نفسه الذي ينفّذه الأمر، باستخدام الإصدار الموجود داخل الحزمة. تستمر الخدمات الجارية في العمل حتى التحويل. + +إذا رُفض التحديث، مثلًا لأن تغيير المخطط يحتاج إلى نسخة احتياطية غير موجودة، يستمر الإصدار القديم في العمل وتفشل خطوة التهيئة. أصلح السبب ثم كرّر الخطوة باستخدام `sudo dpkg --configure -a` على Debian وUbuntu، أو بإعادة تثبيت الحزمة نفسها على أنظمة RPM. + +بعد تحديث من وحدة التحكم، قد يكون الإصدار الذي يعرضه مدير الحزم أقدم من الإصدار الجاري. تُرفض حزمة أقدم من الإصدار الجاري. + +### التثبيت بنص برمجي {#platform-script} + +لا يتضمن التثبيت بنص برمجي أمر `arkvory`. حدّث من وحدة التحكم أو شغّل `manage.mjs update` باستخدام Node.js الخاص بالتثبيت. راجع [الإعدادات](./configuration#lifecycle-commands). + +### Docker Compose {#platform-compose} + +حدّث من وحدة التحكم أو باستخدام `manage.mjs update`. يبني المحدّث صورة الإصدار الجديد ويستبدل حاويات `backup` و`worker` و`api` ويحتفظ بوحدات التخزين. يحتاج تثبيت Compose من دون `root` إلى جدولة `updates-poll`. راجع [Docker Compose](./docker#updates-compose). + +## بعد التحديث {#after} + +- تحقق بواسطة `arkvory status --root ` وسجّل الدخول إلى وحدة التحكم. +- احذف الإصدارات التي لم تعد تحتاج إليها من `releases/`. احتفظ بالإصدار الحالي وبالسابق المذكور في `journal.json`. لا يحذف المحدّث الإصدارات القديمة أو ملفات التنزيل أو ملفات التجهيز المؤقتة أبدًا. +- لا يحدّث التحديث Node.js الخاص بالتثبيت بنص برمجي، أو برامج PostgreSQL، أو نظام التشغيل، أو محرّك الحاويات. حدّثها منفصلةً. تغيير الإصدار الرئيسي لـPostgreSQL ترحيل مستقل: أنشئ نسخة احتياطية أولًا. + +## استكشاف الأخطاء وإصلاحها {#troubleshooting} + +| ما تراه | الإجراء | +| ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| تقول الصفحة إن محدّث المضيف غير متصل | شغّل `arkvory updates-connect --root ` خلال نافذة صيانة | +| تقول الصفحة إن المحدّث توقف عن الإبلاغ | تحقق من المؤقّت أو المهمة. على Linux: `systemctl status arkvory-update.timer` و`journalctl -u arkvory-update`. على Windows: المهمة `ProAnimaArkvoryUpdate` و`logs\updater.log`. تحقق من عدم بقاء `operation.lock` | +| فشل فحص الإصدارات | تحقق من الوصول إلى المركز وGitHub من الخادم. لا تتأثر الخدمات | +| رُفض التثبيت بسبب الحاجة إلى نسخة احتياطية | صِل المخزن وانتظر النسخة الاحتياطية الأولى ثم تحقق من الحالة مجددًا. راجع [النسخة الاحتياطية قبل التحديث](#backup) | +| فشل التحديث | اقرأ `journal.json` وسجل المحدّث وسجلات الخدمات قبل المحاولة مجددًا | +| يلزم استرداد يدوي | اتبع [استرداد تحديث انقطع](#recover-update) | +| تغيّرت الإعدادات أثناء انتظار الطلب | أعد تحميل الصفحة وأرسل الطلب مجددًا | +| `Installation is locked` | هناك عملية أخرى جارية أو عملية تعطلت. راجع [استرداد تحديث انقطع](#recover-update) | +| `Interrupted deployment; use recover after inspecting journal.json` | لم يكتمل تحديث سابق. أجرِ الاسترداد أولًا | +| `Downgrades are forbidden` | الإصدار ليس أحدث من الإصدار المثبّت | +| `Version is pinned` | أزل تثبيت الإصدار المانع لتغييره، أو ثبّت الإصدار المحدد به | +| `Interrupted update request; inspect installation and use updates-reset` | قُبل طلب من وحدة التحكم لكنه لم يكتمل. تحقق من الحالة ثم شغّل `updates-reset` | + +للمزيد من الإرشادات، راجع [استكشاف الأخطاء وإصلاحها](../operate/troubleshooting) و[الإصلاح الذاتي](../operate/self-healing). + +قبل تحديث قاعدة بيانات موجودة إلى PostgreSQL 18.7، راجع [متطلبات المورّد بعد التحديث](https://www.postgresql.org/about/news/postgresql-187-1712-1616-1520-1425-and-19-rc-2-released-3442/). diff --git a/wiki/ar/install/windows.md b/wiki/ar/install/windows.md index d555dcf2..a98f3804 100644 --- a/wiki/ar/install/windows.md +++ b/wiki/ar/install/windows.md @@ -52,7 +52,7 @@ title: Windows | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | ملفات البرنامج | `C:\Program Files\ProAnima\Arkvory` | | البيانات والإعدادات والسجلات | `C:\ProgramData\ProAnima\Arkvory` (جذر التثبيت) | -| قاعدة البيانات | PostgreSQL 18.4 في `database\` ضمن الجذر، على `127.0.0.1` في أول منفذ متاح من 45329-45348، مستثنى من المنافذ التي يحجزها Windows عند الإقلاع | +| قاعدة البيانات | PostgreSQL 18.7 في `database\` ضمن الجذر، على `127.0.0.1` في أول منفذ متاح من 45329-45348، مستثنى من المنافذ التي يحجزها Windows عند الإقلاع | | وحدة التحكم | `http://127.0.0.1:8080/console/` | | مفتاح الاسترداد | `config\bootstrap-token.txt` في الجذر | | مهمة التحديث | `ProAnimaArkvoryUpdate` في جدولة المهام (Task Scheduler). تعمل كل دقيقة بحساب SYSTEM | @@ -82,7 +82,7 @@ title: Windows .\install.ps1 -AutomaticUpdates ``` -يطلب النص البرمجي عنوان اتصال PostgreSQL. ويكون الإدخال مخفيًا. ثم ينزّل Node.js 24.21.0 من `nodejs.org`، ويتحقق من SHA-256 الخاص به، ويثبّت أحدث إصدار مستقر. وإذا كان Node.js موجودًا في الجذر، فلا يستخدمه النص البرمجي إلا إذا كان SHA-256 للملف `node.exe` مطابقًا للقيمة المتوقعة ولم يكن في المجلد شيء آخر. وإلا فإنه ينزّل Node.js من جديد وينقل المجلد القديم إلى `runtime\unverified-…`. +يطلب النص البرمجي عنوان اتصال PostgreSQL. ويكون الإدخال مخفيًا. ثم ينزّل Node.js 24.22.3 من `nodejs.org`، ويتحقق من SHA-256 الخاص به، ويثبّت أحدث إصدار مستقر. وإذا كان Node.js موجودًا في الجذر، فلا يستخدمه النص البرمجي إلا إذا كان SHA-256 للملف `node.exe` مطابقًا للقيمة المتوقعة ولم يكن في المجلد شيء آخر. وإلا فإنه ينزّل Node.js من جديد وينقل المجلد القديم إلى `runtime\unverified-…`. بدلًا من الطلب التفاعلي، يمكنك تمرير ملف JSON محمي: @@ -99,13 +99,13 @@ title: Windows | المعامل | المعنى | | ---------------------------- | --------------------------------------------------------- | | `-Root ` | جذر التثبيت. الافتراضي: `C:\ProgramData\ProAnima\Arkvory` | -| `-Version ` | ثبّت هذا الإصدار المستقر بدلًا من الأحدث | +| `-Version ` | ثبّت هذا الإصدار المستقر بدلًا من الأحدث | | `-Mode windows` أو `compose` | خدمات Windows (الافتراضي) أو [Docker Compose](./docker) | | `-Engine docker` أو `podman` | محرك الحاويات لـ Compose | | `-Config ` | ملف JSON بإعدادات `ARKVORY_*`، ومنها عنوان قاعدة البيانات | -| `-Artifact ` | ثبّت من `Arkvory-Windows.zip` بعد فك ضغطه بدلًا من GitHub | -| `-AutomaticUpdates` | فعّل التحديثات التلقائية | -| `-Pin` | احمِ الإصدار المثبَّت من التحديث (pin) | +| `-Artifact ` | ثبّت من `Arkvory-Windows.zip` بعد فك ضغطه بدلًا من GitHub | +| `-AutomaticUpdates` | فعّل التحديثات التلقائية | +| `-Pin` | احمِ الإصدار المثبَّت من التحديث (pin) | مرّر `-Root` و`-Config` و`-Artifact` كمسارات مطلقة، مثل `-Artifact $PWD.Path`. @@ -126,7 +126,7 @@ $root = 'C:\ProgramData\ProAnima\Arkvory' # برنامج التثبيت الرسومي & 'C:\Program Files\ProAnima\Arkvory\arkvory.ps1' status --root $root # التثبيت بالنص البرمجي -& "$root\runtime\node-v24.21.0-win-x64\node.exe" "$root\manage.mjs" status --root $root +& "$root\runtime\node-v24.22.3-win-x64\node.exe" "$root\manage.mjs" status --root $root ``` شغّل `arkvory.ps1 help` لعرض كل الأوامر. وتوصف الأوامر في [الإعداد](./configuration) و[التحديثات](./updates). @@ -142,12 +142,12 @@ $root = 'C:\ProgramData\ProAnima\Arkvory' ## السجلات {#logs} -| الموقع في الجذر | المحتوى | -| ------------------ | ----------------------------------------------------------------------------------------------- | +| الموقع في الجذر | المحتوى | +| ------------------ | ------------------------------------------------------------------------------------------- | | `logs\` | مخرجات API والعامل ووكيل النسخ الاحتياطي. تُدوَّر الملفات عند 20 MiB؛ ويُحتفظ بخمسة ملفات قديمة | -| `logs\updater.log` | مخرجات مهمة التحديث، بالتدوير نفسه | -| `database\` | سجلات خدمة قاعدة البيانات (`arkvory-database*.log`) | -| `bootstrap.log` | مخرجات خطوة الإعداد في برنامج التثبيت الرسومي | +| `logs\updater.log` | مخرجات مهمة التحديث، بالتدوير نفسه | +| `database\` | سجلات خدمة قاعدة البيانات (`arkvory-database*.log`) | +| `bootstrap.log` | مخرجات خطوة الإعداد في برنامج التثبيت الرسومي | ويكتب برنامج التثبيت أيضًا سجله الخاص في المجلد المؤقت للمستخدم الذي شغّله. ويكتب API والعامل سجل JSON واحدًا في كل سطر. راجع [المراقبة](../operate/monitoring). @@ -180,14 +180,14 @@ Docker Desktop تطبيق لمستخدم واحد. ولا تعمل حاويات ## استكشاف الأخطاء وإصلاحها {#troubleshooting} -| المشكلة | ما الذي تفعله | -| ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | -| يبلّغ برنامج التثبيت أن الإعداد لم يكتمل | اقرأ `bootstrap.log` وسجل برنامج التثبيت وسجلات قاعدة البيانات. لا تحذف مجلد قاعدة البيانات | +| المشكلة | ما الذي تفعله | +| ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- | +| يبلّغ برنامج التثبيت أن الإعداد لم يكتمل | اقرأ `bootstrap.log` وسجل برنامج التثبيت وسجلات قاعدة البيانات. لا تحذف مجلد قاعدة البيانات | | `database\bootstrap-started` موجود، لكن `database\initialized` غير موجود | انقطع إنشاء قاعدة البيانات. لا تحذف العنقود (cluster) ولا تكرر أوامر SQL يدويًا. أصلح السبب وشغّل الأمر `finish-install` | -| `Run installer as Administrator` | ابدأ PowerShell بالخيار **Run as administrator** (تشغيل كمسؤول) | +| `Run installer as Administrator` | ابدأ PowerShell بالخيار **Run as administrator** (تشغيل كمسؤول) | | `Use a dedicated directory` | الجذر يحتوي ملفات بالفعل. استخدم دليلًا فارغًا. وأدر التثبيت القائم بأوامره | -| `Node.js runtime is incomplete after extraction` | تحقق من الحجر الصحي (quarantine) في برنامج مكافحة الفيروسات لديك | -| `Another installation owns this service` | توجد خدمات تثبيت في جذر آخر. أزلها أولًا | +| `Node.js runtime is incomplete after extraction` | تحقق من الحجر الصحي (quarantine) في برنامج مكافحة الفيروسات لديك | +| `Another installation owns this service` | توجد خدمات تثبيت في جذر آخر. أزلها أولًا | لإنهاء تثبيت انقطع دون حذف البيانات: diff --git a/wiki/ar/operate/backups.md b/wiki/ar/operate/backups.md index 17db4f81..79edfefe 100644 --- a/wiki/ar/operate/backups.md +++ b/wiki/ar/operate/backups.md @@ -1,12 +1,438 @@ --- -title: 'Backups' -description: 'Connect a backup vault, schedule and verify backups, restore a restore point into an empty server and test the restore regularly.' +title: النسخ الاحتياطية +description: ربط مخزن للنسخ الاحتياطية وجدولتها والتحقق منها، واستعادة نقطة استعادة إلى خادم فارغ واختبار الاستعادة بانتظام. --- - +# النسخ الاحتياطية -::: warning -لم تُترجم هذه الصفحة بعد، وهي معروضة بالإنجليزية. -::: +ينسخ وكيل النسخ الاحتياطي قاعدة البيانات والملفات المخزّنة في تثبيتك إلى **مخزن النسخ الاحتياطية**: دليل على قرص آخر أو مشاركة شبكية. ويعمل مع استمرار المستخدمين في الرفع والتنزيل. كل نسخة احتياطية مكتملة هي **نقطة استعادة** يمكنك التحقق منها واستعادتها. - +تتناول هذه الصفحة المخزن والجدولة والاحتفاظ والتحقق وشاشات الحالة وإجراء الاستعادة. الاستعادة أمر تشغّله على الخادم. ولا تحتوي وحدة التحكم على زر للاستعادة. + +## آلية عمل النسخ الاحتياطية {#how-backups-work} + +الوكيل هو الخدمة الثالثة في التثبيت، إلى جانب API والعامل. اسمه `arkvory-backup` على Linux، و`Arkvorybackup` على Windows، و`backup` في Docker Compose. يعمل وكيل واحد فقط في الوقت نفسه. ينتظر وكيل ثانٍ ويتولى العمل عندما يتوقف الأول. + +ينفّذ الوكيل ثلاثة أمور: + +- يشغّل الخطة اليومية عندما تكون مفعّلة. +- يشغّل المهام التي تطلبها في وحدة التحكم أو باستخدام `arkvoryctl` أو عبر API. +- يفحص كل نقطة استعادة جديدة ويطبّق الاحتفاظ. + +تحتوي نقطة الاستعادة على الحالة المنشورة للتثبيت في اللحظة **T**، وهي وقت اللقطة. تدخل الملفات التي ينشرها المستخدمون بعد T في النسخة الاحتياطية التالية. تحسب وحدة التحكم عمر النسخة الاحتياطية بدءًا من T، وليس من وقت اكتمال النسخ. + +ضع الحقائق التالية في الحسبان: + +- لا يوقف النسخ الاحتياطي الرفع أو التنزيل. أثناء عمله، يُبقي التنظيف الفعلي على الملفات التي تحتاجها النسخة الاحتياطية ويزيلها في مرور لاحق. +- يُخزَّن الملف مرة واحدة في المخزن، مهما كان عدد نقاط الاستعادة التي تتضمنه. تنسخ النسخة الاحتياطية الأولى كل شيء، لذا تستغرق وقتًا طويلًا مع محتوى يبلغ حجمه تيرابايتات. وتنسخ النسخ اللاحقة الملفات الجديدة فقط. +- لا تظهر نقطة الاستعادة إلا بعد اكتمال نسخها. ولا تضر نسخة احتياطية فاشلة أو منقطعة نقاطَ الاستعادة السابقة مطلقًا. +- النسخ الاحتياطي ليس نظام استعادة إلى أي لحظة زمنية وليس توافرًا عاليًا. تستعيد الحالة عند نقطة استعادة واحدة، وتفقد التغييرات التي حدثت بعد T الخاصة بها. + +## محتويات النسخة الاحتياطية {#contents} + +تحتوي نقطة الاستعادة على: + +- جداول الفهرس في قاعدة البيانات: المُخرَجات والحزم ومسارات الملفات ومحفوظاتها، والتسميات وبيانات التعريف، والمراحل والمرفقات، والحسابات والمجموعات ومنح الوصول، وحسابات الخدمة والمفاتيح، وسجلات التدقيق، وسياسات التخزين والتنظيف، وبيانات سجل صور الحاويات وGit LFS وnpm، وحالة المرايا. +- محتوى كل ملف منشور. + +لا تحتوي نقطة الاستعادة على: + +- جلسات تسجيل الدخول وروابط التنزيل وحالة تشغيل بوابات القراءة. +- عمليات الرفع غير المكتملة. تلغيها الاستعادة ويبدأها العملاء مجددًا. +- خطة النسخ الاحتياطي وحالة الوكيل. يبدأ التثبيت المستعاد والنسخ الاحتياطي معطّل. +- دليل `config/` للتثبيت: الإعدادات وملفات TLS ومفاتيح المرايا ومفتاح الاسترداد. احتفظ بنسخ من هذه الملفات بنفسك. +- برامج Arkvory. ثبّت إصدارًا أولًا، ثم استعد البيانات. + +## تجهيز مخزن النسخ الاحتياطية {#vault} + +### المتطلبات {#vault-requirements} + +| المتطلب | السبب | +| -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | +| دليل جديد أو فارغ، مركّب قبل بدء الخدمات | يكتب الوكيل `vault.json` ونقاط الاستعادة فيه | +| خارج دليل التثبيت وخارج دليل التخزين، بما في ذلك عبر الروابط ووصلات الأدلة والأسماء المختصرة | يضيع المخزن الموجود داخل التخزين معه. يرفض الفحص مسارًا يحتوي على هذين الدليلين أو يقع داخلهما. وينطبق ذلك على كل [وحدة تخزين](./storage#volumes) أيضًا. | +| قابل للكتابة بواسطة حساب الخدمة | على Linux، الحساب `arkvory`. وعلى Windows، الحساب `NT AUTHORITY\LocalService`. يضبط `arkvory configure` الصلاحيات نيابةً عنك | +| مساحة حرة لا تقل عن 1 GiB فوق حجم البيانات الجاري نسخها | يحتفظ المخزن بهذا الاحتياطي. يؤدي امتلاء وحدة التخزين إلى إنهاء النسخ الاحتياطي مع `vault_full`، وتبقى النقاط السابقة سليمة | +| على Linux، خارج `/home` و`/root` و`/run/user` و`/tmp` و`/var/tmp` | تخفي بيئة عزل الخدمة هذه الأشجار | +| على Windows، وحدة تخزين محلية أو iSCSI بحرف محرك أقراص | لا يستطيع `LocalService` تسجيل الدخول إلى مشاركات SMB، لذا تُرفض مسارات مثل `\\nas\share` | + +استخدم وحدة تخزين على قرص آخر أو على NAS، حتى لا يؤدي تعطل قرص التخزين إلى ضياع النسخ الاحتياطية معه. يحمي المخزن الموجود على القرص الفعلي نفسه الذي يحوي التخزين من الأخطاء، ولا يحمي من تعطل القرص. + +**المخزن مشفّر افتراضيًا.** يشفّر Arkvory الملفات والفهرس وأوصاف النقاط (راجع [تشفير المخزن](#encryption)). يحتوي المخزن الذي أُنشئ دون تشفير على الفهرس وبصمات كلمات المرور وكل ملف منشور بصيغة غير مشفّرة: ضعه على وحدة تخزين مشفّرة (LUKS أو BitLocker أو تشفير NAS)، واقصر الوصول على حساب الخدمة ومسؤول النسخ الاحتياطي. + +### تشفير المخزن {#encryption} + +يُشفَّر المخزن عند إنشائه ويبقى كذلك. يشفّر Arkvory محتوى الملفات والفهرس وأوصاف النقاط باستخدام AES-256-GCM، ويكتشف الملف الذي تغيّر أو اقتُطع أو استُبدل عند قراءة المخزن. ولا يخفي أسماء الملفات أو أحجامها أو عدد النقاط. + +أنشئ المخزن على الخادم باستخدام برنامج `arkvory-backup` (راجع [قبل البدء](#restore-prepare)). يجب أن يكون كلا الملفين جديدًا وخارج المخزن والتخزين: + +```bash +arkvory-backup vault init /mnt/backup/arkvory \ + --kit-file /root/arkvory-recovery-kit.txt \ + --agent-key-file /root/arkvory-agent.key +``` + +1. ينشئ الأمر المخزن بمفتاحين: مفتاح الوكيل (`arkvory-agent.key`) ومفتاح الاسترداد في حزمة الاسترداد. ويفتح المخزن بكل منهما قبل إعلان النجاح. +2. انقل حزمة الاسترداد خارج هذا الخادم الآن: إلى مدير كلمات مرور أو خزنة آمنة. دون الحزمة أو مفتاح الوكيل، لا يستطيع أحد قراءة النسخ الاحتياطية أو استعادتها لك. يستطيع كل من يملك الحزمة ونسخة من المخزن قراءة كل نسخة احتياطية فيه. +3. اربط المخزن بمفتاح الوكيل، كما يوضح القسم التالي، واحذف نسختك من ملف المفتاح. يحتفظ التثبيت بنسخته الخاصة في `config/backup/vault.key`، ولا يستطيع قراءتها إلا حساب الخدمة. + +يفتح مفتاح الاسترداد الموجود في الحزمة هذا المخزن وحده. وهو ليس مفتاح استرداد التثبيت (`config/bootstrap-token.txt`). + +تحقّق الآن من أن الحزمة تفتح المخزن، وكرّر التحقق بعد كل تغيير للمفاتيح: + +```bash +arkvory-backup vault key verify --vault /mnt/backup/arkvory --key-file /root/arkvory-recovery-kit.txt +``` + +ينتمي المفتاح إلى خانة، وتفتح كل خانة المخزن بمفتاحها الخاص. تغيّر الأوامر التالية الخانات. ولا يعرض أي منها مفتاحًا: + +| الأمر | التأثير | +| ------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `vault key list --vault DIR` | يسرد الخانات: المعرّف والنوع (`agent` أو `recovery`) ووقت الإنشاء. لا يحتاج إلى مفتاح. | +| `vault key add-recovery --vault DIR --key-file KEY --kit-file NEW` | يضيف خانة استرداد ويكتب حزمتها، لشخص آخر أو خزنة آمنة أخرى. | +| `vault key rotate-agent --vault DIR --key-file KEY --agent-key-file NEW` | ينشئ ملف مفتاح وكيل وخانة جديدين. يستمر مفتاح الوكيل القديم في العمل: شغّل `arkvory configure` بملف المفتاح الجديد، ثم أزل الخانة القديمة (`backup.vault.key.previous` في المخرجات) باستخدام `vault key remove`. | +| `vault key remove --vault DIR --key-file KEY --slot ID` | يزيل خانة. تبقى الخانة الأخيرة وخانة الاسترداد الأخيرة. | + +تغلق إزالة خانة المخزن أمام من لا يملك إلا مفتاحها. ولا تعيد تشفير النقاط السابقة: يظل من نسخ المخزن والمفتاح قبل ذلك قادرًا على قراءة تلك النسخة. إذا احتُمل تسرّب مفتاح، فأنشئ مخزنًا جديدًا بمفاتيح جديدة وابدأ نقاطًا جديدة فيه. + +يمكن إنشاء مخزن دون تشفير: `arkvory-backup vault init DIR --no-encryption`. يحتوي على الفهرس وبصمات كلمات المرور وجميع الملفات بصيغة غير مشفّرة، لذا يحتاج إلى وحدة تخزين مشفّرة ووصول يقتصر على حساب الخدمة. + +### ربط المخزن {#connect-vault} + +شغّل الأمر على الخادم بصفة root أو مسؤول. يفحص الدليل قبل تغيير أي شيء. + +```bash +sudo arkvory configure --root /opt/proanima-arkvory --backup-vault /mnt/backup/arkvory --vault-key-file /root/arkvory-agent.key +``` + +```powershell +$root = 'C:\ProgramData\ProAnima\Arkvory' +& 'C:\Program Files\ProAnima\Arkvory\arkvory.ps1' configure --root $root --backup-vault D:\Backup\Arkvory --vault-key-file C:\Private\arkvory-agent.key +``` + +للتثبيت ببرنامج نصي على Windows، شغّل `manage.mjs` كما هو موضح في [Windows](../install/windows#manage-the-services). + +1. يفحص الأمر المسار: مطلق، ودليل موجود قابل للكتابة، وخارج التثبيت والتخزين، ومرئي للخدمة. +2. يكون المخزن المشفّر، وهو الافتراضي، موجودًا بالفعل: أنشأته باستخدام `arkvory-backup vault init`، ويعطي `--vault-key-file` الخدمة مفتاحه (مفتاح `AK1-…`، وليس مفتاح الاسترداد مطلقًا). باستخدام `--init-vault --vault-no-encryption`، ينشئ بدلًا منه مخزنًا دون تشفير في دليل **فارغ**. ولا يهيّئ دليلًا مرتين مطلقًا. دون `vault.json` ودون `--init-vault`، يرفض العملية، حتى لا يُعتبر NAS غير المركّب مخزنًا فارغًا. +3. يمنح حساب الخدمة الوصول، وينسخ المفتاح إلى `config/backup/vault.key`، ويكتب `ARKVORY_BACKUP_VAULT` و`ARKVORY_BACKUP_VAULT_KEY_FILE` في `config/runtime.json`، ويعيد تشغيل الوكيل فقط. +4. ينتظر حتى 150 ثانية إلى أن يعلن الوكيل توفر هذا المخزن. يقرأ هذا الفحص `config/bootstrap-token.txt`، لذا لا تحذف ذلك الملف. +5. إذا فشل أي شيء، يستعيد الإعدادات السابقة وصلاحيات الوصول السابقة ويعيد تشغيل الوكيل. + +لاستخدام مخزن موجود بالفعل، على خادم جديد مثلًا، أعطِ مفتاحه باستخدام `--vault-key-file` واترك `--init-vault`. لفصل المخزن، استخدم `--backup-vault-off`. يُبقي ذلك الدليل وملفاته دون تغيير ويزيل ملف مفتاح التثبيت. تقطع إعادة التشغيل نسخة احتياطية جارية، ويعيدها الوكيل. + +في Docker Compose، يُركَّب المخزن بربط دليل من `config/compose.vault.yml`. عندما تشغّل أوامر Compose بنفسك، أضف `-f config/compose.vault.yml`. دونه، ينشئ `up` حاوية الوكيل دون المخزن. + +### المخزن على مشاركة شبكية {#network-share} + +على Linux، يعمل NAS عبر SMB 3 وNFS 4. اركب المشاركة بحيث تنتمي الملفات إلى حساب الخدمة، وإلا فلن يستطيع الوكيل الكتابة، ويرفض `configure` العملية ويستعيد الإعدادات القديمة. + +```bash +sudo mount -t cifs //nas/arkvory /mnt/backup/arkvory \ + -o credentials=/etc/arkvory/smb.credentials,uid=$(id -u arkvory),gid=$(id -g arkvory),file_mode=0600,dir_mode=0700,vers=3.1.1 +``` + +- اضبط وضع ملف بيانات الاعتماد على `0600`. +- بالنسبة إلى NFS، طابق المالكين بحيث تنتمي الملفات إلى `arkvory`. استخدم `no_root_squash` على المورد المصدَّر، أو معرّف المستخدم نفسه على الجانبين. +- أضف التركيب إلى `/etc/fstab` مع `_netdev`. بالنسبة إلى SMB، أضف `nofail` عندما يُحتمل عدم توفر NAS عند الإقلاع. +- إذا انقطع NAS، يعلن الوكيل `vault_unavailable`. ولا يكتب في نقطة التركيب الفارغة، لأن هوية المخزن محفوظة في `vault.json`. + +## الجدولة والاحتفاظ {#schedule} + +### ضبط الجدول {#set-schedule} + +افتح [[ui:backups]] واستخدم [[ui:backupPlan]]. تحتاج إلى حق إدارة النسخ الاحتياطية. دونه، يعرض النموذج [[ui:backupReadOnly]]. + +| الإعداد | المعنى | الافتراضي | +| ------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | --------- | +| [[ui:backupEnabled]] | يفعّل الخطة اليومية. لا يبدأ تفعيلها نسخة احتياطية فورًا | معطّل | +| [[ui:backupTime]] | الوقت المحلي للنسخة الاحتياطية اليومية، بدقة الدقيقة | 02:00 | +| [[ui:backupTimezone]] | منطقة IANA الزمنية لذلك الوقت المحلي، مثل `Europe/Moscow` أو `UTC`. لا تُقبل الإزاحات مثل `+03:00` | `UTC` | +| [[ui:backupDaily]]، [[ui:backupWeekly]]، [[ui:backupMonthly]] | عدد الأيام والأسابيع والأشهر التي تُحفَظ نقاط استعادتها. راجع [الاحتفاظ](#retention). الحدود: 0–366، 0–260، 0–120 | 7، 4، 6 | + +اختر [[ui:backupPlanSave]]. إذا غيّر شخص آخر الخطة في الأثناء، تحمّل وحدة التحكم الخطة الحالية، فتراجعها وتحفظ مجددًا. + +يتبع الجدول القواعد التالية: + +- يُنفَّذ الوقت المحلي غير الموجود في يوم تغيير الساعة عند لحظة التغيير. ويُنفَّذ الوقت المحلي الذي يتكرر مرتين مرة واحدة، عند ظهوره الأول. +- بعد فترة توقف، ينشئ الوكيل نسخة احتياطية تعويضية واحدة، وليس نسخة عن كل يوم فائت. لا يؤدي تغيير الجدول إلى تعويض أوقات سابقة. +- نافذة التحديث الافتراضية للتثبيت هي 03:00 UTC. يوقف التحديث الوكيل، وتنقطع نسخة احتياطية جارية وتُعاد لاحقًا. اختر وقتًا للنسخ الاحتياطي لا يقع ضمن نافذة التحديث. راجع [التحديثات](../install/updates). + +### الاحتفاظ {#retention} + +يُبقي الاحتفاظ على أحدث نقطة استعادة لكل يوم من آخر N يومًا محليًا، ولكل أسبوع من آخر N أسبوعًا وفق ISO، ولكل شهر من آخر N شهرًا، محسوبةً بمنطقة الخطة الزمنية. تُوحَّد المجموعات الثلاث، لذا تحتفظ القيم 7 و4 و6 بحد أقصى 17 نقطة، وعادةً بأقل من ذلك. + +يُبقي الاحتفاظ دائمًا على: + +- النقاط المثبّتة. +- أحدث نقطة، حتى تبقى نقطة واحدة على الأقل دائمًا. + +لا يحذف الاحتفاظ مطلقًا نقطة فشلت في التحقق، ولا يمس نقاط تثبيت آخر في المخزن نفسه. + +بعد كل نسخة احتياطية، يضع الوكيل الاحتفاظ في قائمة الانتظار كمهمة منفصلة. يمكنك أيضًا اختيار [[ui:backupRetentionApply]]. تعرض وحدة التحكم أولًا النقاط التي ستبقى والتي ستُزال. لا يمكن التراجع عن الإزالة. يحذف الوكيل بعدها النقطة، ثم الملفات التي لا تحتاجها أي نقطة متبقية. إذا احتوى المخزن على نقطة تالفة (دليل نقطة دون `COMMITTED` أو بملف بيان غير صالح)، تتوقف الإزالة مع `invalid_manifest`. اترك المخزن كما هو، وحدد السبب، ثم أزل الدليل التالف يدويًا. + +لا يغيّر الاحتفاظ بالنسخ الاحتياطية احتفاظ نسخ البناء في مستودعاتك. راجع [التخزين](./storage). + +### تثبيت نقطة استعادة {#pin} + +تُحفَظ النقطة المثبّتة بما يتجاوز قواعد الاحتفاظ. مثلًا، ثبّت النقطة السابقة لترحيل كبير. + +- وحدة التحكم: اختر [[ui:backupPin]] في صف النقطة في [[ui:backupPoints]]. ويلغي [[ui:backupUnpin]] تثبيتها. +- CLI: الأمر `arkvoryctl backup pin POINT_ID`، والأمر `arkvoryctl backup pin POINT_ID --off`. +- API: العملية [setBackupPointPin](../api/reference/backups#setBackupPointPin). + +## التحقق {#verification} + +يوجد نوعان من التحقق: + +| النوع | ما يفحصه | متى يعمل | +| ------------------------------------------------------ | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| سريع (تسميه وحدة التحكم [[ui:backupVerifyStructural]]) | كل ملف في النقطة مقابل الملخص في ملف بيانها، ووجود كل ملف مخزّن بالحجم الصحيح | تلقائيًا بعد كل نسخة احتياطية | +| كامل ([[ui:backupVerifyDeep]]) | الفحوصات السريعة، بالإضافة إلى قراءة كل ملف مخزّن والتحقق من SHA-256 الخاص به | تلقائيًا مرة كل 7 أيام لأحدث نقطة. وعند الطلب باستخدام [[ui:backupVerifyDeepAction]] أو `arkvoryctl backup verify POINT_ID` أو `arkvory-backup verify --deep` | + +يقرأ التحقق الكامل النقطة كاملةً، لذا يحتاج إلى وقت ومعدل نقل قرص مناسب مع المخازن الكبيرة. إذا فشلت نقطة، تعرض وحدة التحكم [[ui:backupVerifyFailed]] مع رمز خطأ، ويصبح التحذير `verify_failed` نشطًا. لا تغيّر المخزن حتى تعرف السبب. + +تعرض النقطة التي لم تُفحَص بعد [[ui:backupVerifyNone]]. والتحقق الكامل من أحدث نقطة هو أيضًا أفضل فحص دوري لإمكانية قراءة المخزن. + +## تشغيل نسخة احتياطية الآن {#run-now} + +استخدم أيًا مما يلي: + +- وحدة التحكم: [[ui:backupRun]] في [[ui:backups]]. +- CLI: الأمر `arkvoryctl backup run`. +- API: تعيد [requestBackupRun](../api/reference/backups#requestBackupRun) الرمز 202 مع المهمة المدرجة في قائمة الانتظار. + +يفحص الوكيل قائمته كل 15 ثانية (`ARKVORY_BACKUP_POLL_SECONDS`)، لذا تبدأ المهمة بعد وقت قصير. تعمل المهام واحدة تلو الأخرى، ولا يوقفها إغلاق وحدة التحكم. تُعاد المهمة التي تتوقف بسبب إعادة تشغيل أو تعارض، حتى 5 محاولات. راجع [متغيرات البيئة](../reference/environment#backups) لإعدادات الوكيل، بما فيها حد معدل النسخ `ARKVORY_BACKUP_BYTES_PER_SECOND`. + +تمر النسخة الاحتياطية بهذه المراحل التي تعرضها وحدة التحكم في [[ui:backupJobPhase]]: [[ui:backupPhasePreparing]] و[[ui:backupPhaseCatalog]] و[[ui:backupPhaseTransfer]] و[[ui:backupPhaseFinishing]] و[[ui:backupPhaseDone]]. ويعرض الفحص السريع [[ui:backupPhaseStructural]]، والكامل [[ui:backupPhaseDeep]]. + +لا تشغّل ترحيلات قاعدة البيانات أو أداتي العمل دون اتصال `gc` و`scrub` أثناء نسخة احتياطية. تنتظران اكتمالها أو ترفضان مع `busy`. + +## متابعة الحالة {#status} + +### في وحدة التحكم {#status-console} + +يظهر [[ui:backups]] للمسؤولين ولمفتاح الاسترداد. لا تراه مفاتيح الخدمة ورموز الوصول الشخصية مطلقًا. تعرض الصفحة: + +- الحالة: [[ui:backupStateOk]] أو [[ui:backupStateWarning]] أو [[ui:backupStateCritical]]. +- [[ui:backupNewest]] مع عمرها بدءًا من T، و[[ui:backupNextRun]] مع [[ui:backupOverdue]] عند تأخر التشغيل، و[[ui:backupAgent]] مع آخر إشارة منه، و[[ui:backupVault]] مع المساحة الحرة وما إذا كان المخزن مشفّرًا ([[ui:backupVaultEncrypted]] أو [[ui:backupVaultPlain]]). ويظهر للمخزن غير المشفّر تلميح أيضًا، وليس تحذيرًا. +- المهمة الجارية الآن، ثم التحذيرات، وكل منها مع تلميح للإجراء المطلوب. +- [[ui:backupPoints]] مع [[ui:backupSnapshot]] و[[ui:backupCompleted]] و[[ui:backupSize]] و[[ui:backupFiles]] و[[ui:backupVerification]] والتثبيت. +- [[ui:backupJobs]] مع النوع ([[ui:backupKindCapture]] و[[ui:backupKindVerify]] و[[ui:backupKindRetention]]) والحالة والمرحلة والأوقات ورمز الخطأ ومدى التقدم. + +للمهمة إحدى الحالات التالية: [[ui:backupJobQueued]] أو [[ui:backupJobRunning]] أو [[ui:backupJobCommitting]] أو [[ui:backupJobCompleted]] أو [[ui:backupJobFailed]] أو [[ui:backupJobInterrupted]]. تتحدث الصفحة أثناء عمل المهمة. استخدم [[ui:backupRefresh]] في أي وقت. + +### التحذيرات {#warnings} + +| الرمز | المستوى | الإجراء المطلوب | +| ---------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `vault_not_configured` | تحذير | اربط مخزنًا. راجع [ربط المخزن](#connect-vault) | +| `agent_offline` | حرج | لا توجد إشارة منذ دقيقتين. ابدأ خدمة الوكيل واقرأ سجلها | +| `schedule_disabled` | تحذير | فعّل الخطة إذا احتجت إلى نسخ احتياطية يومية | +| `no_backup_yet` | تحذير | أنشئ أول نسخة احتياطية | +| `backup_stale` | حرج | عمر أحدث نقطة يتجاوز 26 ساعة مع تفعيل الخطة. اقرأ رموز أخطاء المهام وسجل الوكيل | +| `last_run_failed` | تحذير | فشلت آخر نسخة احتياطية. يوجد رمز الخطأ في قائمة المهام | +| `vault_unavailable` | حرج | وحدة التخزين غير مركّبة، أو `vault.json` مفقود، أو المخزن غير قابل للكتابة، أو لا يوجد مفتاح صالح لمخزن مشفّر (يذكر سجل الوكيل `vault_key_missing` أو `vault_key_invalid`) | +| `vault_low_space` | تحذير | المساحة الحرة أقل من 10% من وحدة التخزين، أو أقل من ضعفي البيانات الجديدة في آخر نسخة احتياطية. وفّر مساحة أو احتفظ بنقاط أقل | +| `verify_failed` | حرج | فشلت نقطة في التحقق. لا تغيّر المخزن؛ حقّق في السبب | +| `never_deep_verified` | تحذير | لم يُجرَ تحقق كامل منذ أكثر من 8 أيام. تأكّد من عمل الوكيل، أو ابدأ تحققًا كاملًا | + +### باستخدام CLI وAPI {#status-cli} + +```bash +arkvoryctl backup status +arkvoryctl backup jobs +arkvoryctl backup points +arkvoryctl backup status --json || echo "backup problem" +``` + +ينتهي `backup status` برمز الخروج 9 ما دام تحذير حرج نشطًا، لذا يمكنك استخدامه في المراقبة. تحتاج هذه الأوامر إلى مفتاح المالك المحفوظ في ملف أو جلسة حساب مسؤول. راجع [عميل سطر الأوامر](../protocols/cli#backups) و[SDK لـTypeScript](../protocols/sdk#backups). توجد عمليات HTTP في [مرجع API للنسخ الاحتياطية](../api/reference/backups). + +بالنسبة إلى Prometheus، تعرض API المقاييس `arkvory_backup_last_success_timestamp_seconds` (قيمة T لأحدث نقطة)، و`arkvory_backup_agent_last_seen_timestamp_seconds`، و`arkvory_backup_warnings` مع تسمية `code`. راجع [المراقبة](./monitoring). + +## الاستعادة {#restore} + +تكتب الاستعادة في قاعدة بيانات **فارغة** ودليل تخزين **فارغ**. ولا تستبدل تثبيتًا قيد التشغيل مطلقًا. بعد الاستعادة، تشغّل نسخة مستقلة على البيانات المستعادة وتفحصها، وبعد ذلك فقط تقرر ما إذا كانت ستحل محل الخادم القديم. + +### قبل البدء {#restore-prepare} + +- **البرنامج.** أمر الاستعادة هو برنامج `arkvory-backup` للإصدار المثبّت. شغّله باستخدام Node.js الخاص بالتثبيت: + - حزم Linux: `/opt/proanima-arkvory/runtime/node /opt/proanima-arkvory/releases/VERSION/apps/backup/dist/main.js COMMAND` + - برنامج التثبيت الرسومي على Windows: `& "$root\runtime\node.exe" "$root\releases\VERSION\apps\backup\dist\main.js" COMMAND` + + القيمة `VERSION` هي الإصدار المثبّت من `installation.json`. في بقية هذه الصفحة، يشير `arkvory-backup` إلى سطر الأوامر الكامل هذا. يشغّل مستخدمو Docker Compose البرنامج نفسه من حاوية صورة الإصدار. وللتثبيت ببرنامج نصي، استخدم مجلد Node.js تحت `runtime/`. + +- **الإصدار.** استخدم الإصدار الذي أنشأ النقطة أو إصدارًا أحدث. تُرفض النقطة التي أُنشئت بإصدار أحدث مع `schema_mismatch`. +- **الحساب.** شغّل الأمر بحساب يستطيع قراءة المخزن. على Linux، ينتمي المخزن إلى `arkvory` ووضعه 0700، لذا استخدم `sudo -u arkvory`. وعلى Windows، استخدم PowerShell بصلاحيات مرتفعة. يجب أن ينتهي دليل التخزين الجديد مملوكًا للحساب الذي سيشغّل API. +- **المفتاح.** يحتاج المخزن المشفّر إلى مفتاحه. مرّر حزمة الاسترداد أو ملف مفتاح عبر `--key-file FILE` إلى كل أمر أدناه، أو اضبط `ARKVORY_BACKUP_VAULT_KEY_FILE`. المفتاح ملف دائمًا، ولا يُمرَّر نصه كوسيطة مطلقًا. +- **الهدف.** أنشئ قاعدة بيانات فارغة، مثل `CREATE DATABASE arkvory_restore OWNER arkvory;`. اختر دليل تخزين غير موجود أو فارغًا، على وحدة تخزين مختلفة عن المخزن، وخارج تخزين المصدر. يحتاج التثبيت ذو [عدة وحدات تخزين](./storage#volumes) إلى دليل فارغ إضافي لكل وحدة، راجع [استعادة عدة وحدات تخزين](#restore-volumes). +- **عنوان URL لقاعدة البيانات.** مرّره في البيئة، وليس كوسيطة، لأن الوسائط ظاهرة في قائمة العمليات. + +### الاستعادة خطوة بخطوة {#restore-steps} + +1. اسرد نقاط الاستعادة واختر واحدة. انسخ معرّف النقطة. + + ```bash + arkvoryctl backup points + arkvory-backup list --vault /mnt/backup/arkvory + ``` + +2. تحقّق من النقطة تحققًا كاملًا. + + ```bash + arkvory-backup verify --vault /mnt/backup/arkvory --point POINT_ID --deep + ``` + +3. اضبط قاعدة البيانات الهدف في البيئة. + + ```bash + export ARKVORY_RESTORE_DATABASE_URL='postgresql://arkvory@db.example/arkvory_restore' + ``` + +4. شغّل الاستعادة **دون** `--yes`. هذا تشغيل تجريبي. يفحص النقطة وبصمات الملفات وإصدار المخطط وخلو الهدف، ولا يكتب شيئًا. + + ```bash + arkvory-backup restore --vault /mnt/backup/arkvory --point POINT_ID --storage /srv/arkvory-restore + ``` + + ينتهي الفحص الناجح برمز الخروج 0 وسطر السجل `backup.restore.planned`. + +5. شغّل الأمر نفسه مع `--yes`. أضف `--report` للاحتفاظ بملف تقرير. يجب ألا يكون الملف موجودًا بعد. + + ```bash + arkvory-backup restore --vault /mnt/backup/arkvory --point POINT_ID --storage /srv/arkvory-restore --yes --report /root/restore-report.json + ``` + + تمر الاستعادة بالمراحل `verify` و`content` و`schema` و`tables` و`migrate` و`done`. تنسخ كل ملف وتتحقق من SHA-256 الخاص به، وتنشئ المخطط، وتحمّل كل الجداول في معاملة واحدة، وتطبّق التسوية، ثم تشغّل الترحيلات المتبقية. يحتوي التقرير على معرّفات وأعداد فقط، ولا يحتوي على مسارات أو بيانات اعتماد مطلقًا. + +6. ابدأ نسخة API مستقلة على البيانات المستعادة: `ARKVORY_DATABASE_URL` لقاعدة البيانات الجديدة، و`ARKVORY_DATA_DIR` للدليل الجديد، و`ARKVORY_KEYS_FILE` خاص بها، ومنفذ آخر. تحقّق من استجابة `/health/ready`، ومن إمكانية تسجيل الدخول، واكتمال الفهرس، وتنزيل ملف اختبار بقيمة SHA-256 نفسها. + +إذا فشلت الاستعادة، فاحذف قاعدة البيانات والدليل الهدف وأنشئهما مجددًا. يُرفض الهدف غير الفارغ مع `target_not_empty`، لحماية البيانات الموجودة. + +### استعادة عدة وحدات تخزين {#restore-volumes} + +تتذكر نقطة الاستعادة وحدة تخزين كل ملف. استعد كل ملف إلى وحدته: + +1. اكتب ملف الوحدات للتثبيت المستعاد، مع مثيل لكل وحدة تخزين في المصدر بالمعرّف نفسه ودليل جديد فارغ لكل منها، مثل `/srv/arkvory-restore-volume-2`. تتبع الأدلة قواعد `--storage` نفسها. +2. أضف `--modules-file FILE` إلى أمري الاستعادة كليهما: + + ```bash + arkvory-backup restore --vault /mnt/backup/arkvory --point POINT_ID --storage /srv/arkvory-restore --modules-file /srv/arkvory-restore-modules.json + ``` + +3. ابدأ النسخة المستعادة بملف الوحدات هذا بوصفه `ARKVORY_MODULES_FILE`. + +تُرفض النقطة التي تحتوي على ملفات من وحدة تخزين لا يحددها الهدف قبل كتابة أي شيء، وفي التشغيل التجريبي أيضًا. سياسات توزيع التخزين جزء من النسخة الاحتياطية. أما هويات وحدات التخزين فليست كذلك: تسجّل API المستعادة الأدلة الجديدة عند أول بدء لها. + +### ما تغيّره الاستعادة {#after-restore} + +تطبّق الاستعادة مجموعة ثابتة من التغييرات، حتى لا تتابع النسخة الجديدة أي عمل كان جاريًا ولا تفعّل أي بيانات اعتماد قديمة: + +- تُلغى عمليات الرفع غير المكتملة وتُحرَّر حصتها. تنتهي مهام الإكمال المنتظرة والجارية بحالة فشل مع الرمز `conflict`. وتُسقَط الترقيات غير المكتملة. +- لا تُستعاد أي جلسة. يسجّل الجميع الدخول مجددًا. +- تُبطَل جميع رموز الوصول الشخصية، وتصبح جميع مفاتيح الخدمة بالحالة `revoked`. أصدر مفاتيح جديدة. +- يُعطَّل احتفاظ التخزين والتنظيف الفعلي في كل مستودع. أعد تفعيلهما عن قصد. +- يُعطَّل النسخ الاحتياطي ولا يُضبط أي مخزن. ولا تنتقل روابط التنزيل وإعدادات بوابات القراءة. +- تبقى الحسابات والمجموعات ومنح الوصول مع بصمات كلمات المرور كما كانت عند T. تعود كلمة مرور غيّرتها بعد T إلى العمل بصيغتها القديمة، لذا أعد تعيين كلمات المرور وفق سياستك. +- يأتي مفتاح الاسترداد والمفاتيح المحفوظة في ملف من ملف مفاتيح التثبيت الذي يشغّل البيانات المستعادة. +- تحتفظ المرايا بموضعها، لكن إعداداتها في `config/`. اربطها مجددًا. راجع [المرايا](./mirrors). +- يسجّل إدخال تدقيق أمان `backup.restored` النقطة والأعداد. + +### الانتقال إلى خادم آخر {#move-server} + +يمكنك استخدام نسخة احتياطية لنقل تثبيت إلى خادم آخر: + +1. ثبّت Arkvory على الخادم الجديد بالإصدار نفسه أو إصدار أحدث. راجع [اختيار طريقة تثبيت](../install/index). +2. اربط المخزن نفسه، أو نسخة منه، بالخادم الجديد. لا تستخدم `--init-vault` لمخزن موجود. +3. استعد أحدث نقطة إلى قاعدة بيانات جديدة فارغة ودليل فارغ، كما هو موضح أعلاه، واختبر النتيجة. +4. وجّه التثبيت إلى البيانات المستعادة: اضبط `ARKVORY_DATABASE_URL` و`ARKVORY_DATA_DIR` في `config/runtime.json` وأعد تشغيل الخدمات. راجع [الإعداد](../install/configuration). +5. أصدر مفاتيح جديدة، واضبط سياسات الاحتفاظ والتنظيف مجددًا، واربط المرايا وخطة النسخ الاحتياطي، وأبلغ العملاء بالعنوان الجديد. + +الخطوتان الأخيرتان يدويتان وليستا جزءًا من تحويل موجَّه. تمرّن على التسلسل كاملًا على خادم احتياطي أولًا. تُفقَد التغييرات التي أُجريت على الخادم القديم بعد T، لذا أوقف الخادم القديم قبل انتقال العملاء. + +## اختبار الاستعادة بانتظام {#test-restore} + +النسخة الاحتياطية التي لم تستعدها مطلقًا ليست إلا أملًا. يتحقق المنتج من بايتات النقطة، لكنه لا يسجّل اختبار استعادة. احتفظ بالتاريخ والنتيجة بنفسك. + +اختبر على الأقل: + +- بعد أول نسخة احتياطية. +- بعد كل تحديث يغيّر مخطط قاعدة البيانات. +- وفق جدول خاص بك، مثل كل ثلاثة أشهر. + +يتبع كل اختبار [الاستعادة خطوة بخطوة](#restore-steps) على خادم احتياطي أو قاعدة بيانات مؤقتة، وينتهي بتسجيل الدخول وفحص الفهرس وتنزيل ملف اختبار. احذف قاعدة البيانات المؤقتة والدليل بعد ذلك. + +## رموز الخروج وأسطر السجل {#exit-codes} + +### رموز الخروج {#exit-codes-table} + +يكتب برنامج `arkvory-backup` كائن JSON واحدًا في كل سطر إلى المخرج القياسي، وعند الفشل يكتب سطر تلميح واحدًا إلى مخرج الأخطاء القياسي. + +| الرمز | المعنى | +| ----- | ------------------------------------------------------------------------------------------------------------------------------- | +| 0 | نجاح. بالنسبة إلى `restore` دون `--yes`، نجح الفحص | +| 1 | فشل التشغيل: قاعدة البيانات أو القرص غير متاح، أو فُقد الحجز المؤقت أو اللقطة، أو امتلأ المخزن أو الهدف. لا تتضرر نقاط الاستعادة | +| 2 | وسائط أو متغيرات بيئة غير صحيحة | +| 3 | رفض فحص حماية العملية: غياب `vault.json`، أو تداخل الأدلة، أو هدف غير فارغ، أو مخطط غير مدعوم، أو عدم وجود النقطة | +| 4 | فشل سلامة: بصمة، أو ملف مفقود، أو ملف بيان متغيّر. اترك المخزن دون تغيير حتى تفهم السبب | +| 5 | مشغول: نسخ احتياطي أو صيانة أخرى جارية، أو لم يكتمل حذف في الوقت المحدد. أعد المحاولة لاحقًا | + +### أسطر السجل {#log-lines} + +تكون قيمة `component` في كل سطر هي `backup`. لا تُكتب المسارات أو عناوين URL أو الأسرار مطلقًا. أهم الأسطر: + +| الرمز | المعنى | +| ------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | +| `backup.phase` | تنتقل النسخة الاحتياطية إلى مرحلة: `barrier`، `pins`، `tables`، `blobs`، `manifest`، `commit`، `done` | +| `backup.capture.completed` | اكتملت نسخة احتياطية. الحقول: `pointId` و`outcome` و`blobs` و`copied` و`reused` و`copiedBytes` و`contentBytes` و`durationMs` | +| `backup.point` | نقطة استعادة واحدة في مخرجات `list` | +| `backup.verify.point`، `backup.verify.problem` | نتيجة التحقق، وكل مشكلة مع `errorCode` الخاص بها | +| `backup.restore.phase`، `backup.restore.planned`، `backup.restore.completed` | تقدم الاستعادة ونتيجتها، مع أعداد الصفوف والتغييرات المذكورة أعلاه | +| `backup.failed` | فشل أمر. اقرأ `errorCode` | +| `backup.agent.started`، `.standby`، `.lease_acquired`، `.lease_lost`، `.stopped`، `.failed` | دورة عمل الوكيل | +| `backup.request.started`، `.done`، `.failed`، `.requeued` | مهمة للوكيل، مع `kind` و`errorCode` | +| `backup.schedule.due` | بدأت الخطة نسخة احتياطية | +| `backup.retention.applied` | اكتمل الاحتفاظ. الحقول: `forgotten` و`blobs` و`freedBytes` | + +اقرأ سجل الوكيل باستخدام `journalctl -u arkvory-backup` على Linux، وفي `logs\` ضمن جذر التثبيت على Windows، وباستخدام `docker compose logs backup` في Compose. + +### رموز الأخطاء {#error-codes} + +| `errorCode` | رمز الخروج | الإجراء المطلوب | +| -------------------------------------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------- | +| `vault_missing` | 3 | لا يحتوي الدليل على `vault.json`. اركب وحدة التخزين، أو شغّل `vault init` مرة واحدة | +| `vault_key_missing` | 3 | المخزن مشفّر ولم يُقدَّم مفتاح. استخدم `--key-file FILE` أو `ARKVORY_BACKUP_VAULT_KEY_FILE` | +| `vault_key_invalid` | 3 | لا يفتح المفتاح هذا المخزن: افحص الملف والمخزن وما إذا كانت الخانة قد أُزيلت. يكتشف المجموع الاختباري للمفتاح الخطأ المطبعي | +| `unsafe_path` | 3 | أبقِ المخزن والتخزين وهدف الاستعادة في أشجار أدلة منفصلة | +| `target_not_empty` | 3 | لا تكتب الاستعادة إلا في قاعدة بيانات فارغة ودليل فارغ | +| `schema_mismatch` | 3 | النقطة أحدث من الإصدار، أو أقدم من نطاق الاستعادة المدعوم. استخدم إصدارًا آخر | +| `upgrade_required` | 3 | حدّث كل عمليات API والصيانة للتثبيت | +| `point_not_found`، `storage_mismatch` | 3 | معرّف نقطة غير صحيح، أو لا يشير `ARKVORY_DATA_DIR` إلى دليل تخزين مهيّأ لهذا التثبيت | +| `integrity_mismatch`، `invalid_manifest`، `blob_missing` | 4 | أبقِ المخزن دون تغيير. شغّل `verify --deep` وحقّق في السبب | +| `busy`، `barrier_timeout` | 5 | عملية أخرى جارية. أعد المحاولة لاحقًا | +| `vault_full`، `storage_full` | 1 | وفّر مساحة. النقاط السابقة سليمة | +| `attempts_exhausted` | 3 | استنفد هذا الطلب محاولاته الخمس. ابدأ نسخة احتياطية جديدة | + +## الحدود {#limits} + +- خطة واحدة ومخزن واحد لكل تثبيت. المخزن دليل على قرص أو مشاركة مركّبة، دون S3 ودون نمط نسخ خارج الموقع أو نمط غير قابل للتغيير. +- يخفي التشفير المحتوى والفهرس، وليس أسماء الملفات أو أحجامها أو عدد النقاط. فقدان المفاتيح يعني فقدان النسخ الاحتياطية. لا تعيد إزالة خانة مفتاح تشفير النقاط السابقة. +- لا يمكنك إيقاف مهمة نسخ احتياطي مؤقتًا أو إلغاءها، ولا تتضمن وحدة التحكم معالج استعادة أو حالة اختبار استعادة. +- تحتاج الاستعادة إلى هدف فارغ، ويكون التحويل إلى البيانات المستعادة خطوة يدوية. +- وكيل النسخ الاحتياطي ليس نظام توافر عالٍ. لا يفعل الوكيل الثاني إلا الانتظار بديلًا احتياطيًا. + +## صفحات ذات صلة {#related-pages} + +- [اختيار طريقة تثبيت](../install/index) +- [التحديثات](../install/updates) +- [التخزين](./storage) +- [المرايا](./mirrors) لموقع ثانٍ +- [المراقبة](./monitoring) +- [الإصلاح الذاتي](./self-healing) +- [استكشاف الأخطاء وإصلاحها](./troubleshooting) +- [متغيرات البيئة](../reference/environment#backups) + +## الاستعادة دون التخزين الأصلي {#restore-default-storage} + +أضف `--to-default-storage` إلى أمر الاستعادة لوضع جميع الكائنات في التخزين الافتراضي دون وحدات التخزين أو الوحدات البرمجية الأصلية. احجز مساحة لبايتات الكائنات كاملةً. دون `--yes`، يكتفي الأمر بالفحص والإبلاغ عن الخطة. يجب أن تكون قاعدة البيانات والتخزين فارغين. يمسح هذا النمط قواعد توزيع التخزين ويستعيد المحتوى المنشور بوصفه كتل بيانات عادية؛ اضبط قواعد توزيع جديدة بعد الاسترداد. + +تلتقط النسخ الاحتياطية المنطقية بايتات الكائنات المنشورة عبر الوحدة البرمجية المثبّتة في دور النسخ الاحتياطي؛ ولا تنسخ دليل الوحدة أو ذاكراتها المخبئية أو حالة تنسيقها الخاصة كصورة لنظام الملفات. أبقِ وحدات المصدر مثبّتة وقابلة للقراءة حتى اكتمال الالتقاط. تستطيع الاستعادة باستخدام [--to-default-storage](#restore-default-storage) استرداد هذه الكائنات بوصفها كتل بيانات عادية في النواة دون الوحدة الأصلية أو ترخيص مدفوع؛ احجز حجمها المنطقي كاملًا. احفظ أسرار التثبيت منفصلةً واتبع إجراء استرداد الترخيص قبل إعادة تمكين الكتابات المدفوعة. diff --git a/wiki/ar/operate/cluster.md b/wiki/ar/operate/cluster.md index 7332f8fb..b9676425 100644 --- a/wiki/ar/operate/cluster.md +++ b/wiki/ar/operate/cluster.md @@ -1,12 +1,278 @@ --- -title: 'High availability cluster' -description: 'Run Arkvory on two or three Linux servers of one site with a synchronous copy of all data, automatic failover and mandatory fencing.' +title: عنقود عالي التوافر +description: شغّل Arkvory على خادمين أو ثلاثة خوادم Linux في موقع واحد مع نسخ متزامن لجميع البيانات وتجاوز تلقائي للفشل وعزل قسري إلزامي. --- - +# عنقود عالي التوافر -::: warning -لم تُترجم هذه الصفحة بعد، وهي معروضة بالإنجليزية. -::: +يواصل عنقود Arkvory العمل عند تعطل خادم واحد في الموقع. يحتفظ خادمان أو ثلاثة خوادم Linux بنسخ متطابقة من وحدة تخزين كتلية واحدة. يكون خادم واحد **نشطاً** ويشغّل Arkvory. وعند تعطله، يعزله مدير العنقود قسرياً ويبدأ Arkvory على خادم آخر بالبيانات نفسها. - +يحمي العنقود من فقدان خادم أو قرص أو وصلة شبكة داخل موقع واحد. ولا يحمي من فقدان الموقع كله. للحماية من ذلك، احتفظ [بمرايا](./mirrors) في موقع آخر و[بنسخ احتياطية](./backups) خارج العنقود. + +## آلية العمل {#how-it-works} + +- **وحدة تخزين واحدة ونسخ متزامنة.** ينسخ DRBD 9 كل عملية كتابة على وحدة التخزين إلى الخوادم الأخرى قبل اكتمالها (البروتوكول C). يوجد التثبيت كله على الوحدة: قاعدة البيانات والتخزين والإعدادات والإصدارات. ولا ينفصل الفهرس أبداً عن بايتات الملفات. +- **يحدد Pacemaker مكان تشغيل Arkvory.** يحافظ Corosync وPacemaker على النصاب، ويختاران الخادم النشط، ويبدآن بالترتيب: وحدة التخزين، ونظام الملفات، والخدمات كما هي محفوظة على الوحدة (`arkvory-units`)، وقاعدة البيانات، و`arkvory-replica`، وواجهة API، والعامل، ووكيل النسخ الاحتياطي، ومؤقت التحديث، وعنوان IP افتراضي. لا يجري Arkvory انتخاباً خاصاً به. +- **العزل القسري إلزامي.** قبل تولي خادم آخر العمل، يطفئ Pacemaker الخادم المتعطل من خلال جهاز تحكم بالطاقة (IPMI أو iDRAC أو iLO أو Redfish أو وحدة توزيع طاقة PDU) أو مراقب أجهزة افتراضية. من دون العزل القسري، يمكن أن يكتب خادمان في الوقت نفسه. ولا يبدأ عنقود بلا عزل قسري. +- **نسختان لكل عملية كتابة مؤكدة.** لا يعيد Arkvory نجاح عملية الكتابة إلا عند وجودها في نسختين مكتملتين على الأقل (انظر [الكتابة](#writes)). عند فقدان نسخة، تتوقف الكتابة وتستمر القراءة. + +| ملف التعريف | خوادم البيانات | الشاهد | عند تعطل خادم بيانات واحد | +| ----------- | -------------- | ------------------------------------------------------------------------- | ---------------------------------------------------- | +| `ha-2` | 2 | مطلوب: خادم صغير بلا بيانات يشغّل `corosync-qnetd` وعقدة DRBD لكسر التعادل | تتوقف الكتابة حتى عودة الخادم أو صدور قرار من المشغّل | +| `ha-3` | 3 | غير مستخدم: تتخذ الخوادم الثلاثة القرار بالأغلبية | تستمر الكتابة: تبقى نسختان | + +ملف التعريف الموصى به هو `ha-3`. وتكلفة `ha-2` أقل، وهو يوقف الكتابة صراحةً بدلاً من الاحتفاظ بالبيانات في نسخة واحدة. + +العنقود مخصص لحزم Linux الأصلية. تبقى تثبيتات Windows وDocker Compose خوادم مستقلة مع مرايا ونسخ احتياطية. + +## الكتابة والنسخ {#writes} + +تُحتسب ضمن **النسخ المكتملة** نسخة القرص المحلي للخادم النشط عندما تكون محدثة، ونسخة كل خادم بيانات آخر متصل ينسخ البيانات ويحتفظ بنسخة محدثة. لا يُحتسب الخادم الذي يعيد المزامنة حتى تصبح نسخته محدثة. لا يحمل الشاهد بيانات ولا يُحتسب أبداً. + +يُفحص كل طلب يغيّر البيانات (واجهة HTTP API، وسجل الحاويات، وGit LFS، وnpm) مرتين: + +- **قبل** تنفيذه، وفق حالة النسخ خلال الثانية الأخيرة؛ +- **بعد** تثبيت البيانات ومزامنتها، وفق قراءة جديدة لوحدة التخزين. + +عندما يقل عدد النسخ المكتملة عن العدد المطلوب للكتابة، يتلقى العميل HTTP 503 مع الرمز `unavailable` والسبب `replication_degraded` وترويسة `Retry-After`، ولا يتلقى 2xx أبداً. تُفحص حالة مهمة إكمال الرفع (`GET /api/v1/jobs/{id}`) بالطريقة نفسها، لأنها تخبر العميل بأن عملية رفع كبيرة قد نُشرت. + +تعني استجابة 503 بعد التثبيت أن العملية قد تكون موجودة في نسخة واحدة فقط. كرر الطلب بالقيمة نفسها لـ`Idempotency-Key`: تعيد المحاولة النتيجة الموجودة، وتؤكدها استجابة 2xx عندما تتوفر نسختان مجدداً. + +تستمر القراءة والتنزيلات ووحدة التحكم وتسجيل الدخول والخروج والملاحظات وطلب الدفعة في Git LFS أثناء توقف الكتابة. + +يرى المسؤول الذي سجّل دخوله إلى وحدة التحكم لافتة أثناء توقف الكتابة أو سريان قرار استخدام نسخة واحدة. + +## المتطلبات {#requirements} + +- خادما بيانات أو ثلاثة خوادم بالتوزيعة نفسها من Linux وبالإصدار نفسه من حزمة Arkvory، وعلى كل منها قرص (أو وحدة تخزين منطقية) بالحجم الكامل المطلوب لوحدة التخزين. احسب مساحة التخزين كلها وقاعدة البيانات. +- في `ha-2`، خادم ثالث صغير بصفة شاهد. لا يحتاج إلى قرص للبيانات ولا يشغّل Arkvory. +- شبكة بين الخوادم بزمن استجابة منخفض. تنتظر كل عملية كتابة الخوادم الأخرى، لذلك يضاف زمن استجابة الشبكة إلى كل عملية كتابة. استخدم وصلة مخصصة متى أمكن. +- DRBD 9 (وحدة النواة و`drbd-utils` 9؛ توفر توزيعات كثيرة الوحدة الأقدم 8.4، لذا استخدم حزم LINBIT)، و`pacemaker` و`pcs` و`corosync` و`resource-agents` (على Ubuntu: `resource-agents-base` و`resource-agents-extra`)، ووكلاء العزل القسري المناسبون لأجهزتك. في `ha-2`: `corosync-qdevice` على خوادم البيانات و`corosync-qnetd` على الشاهد. +- جهاز عزل قسري لكل خادم بيانات وبيانات الاعتماد الخاصة به. +- عنوان IP متاح في شبكة الخوادم. يتصل العملاء بهذا العنوان الافتراضي. +- شهادة TLS للعنوان الافتراضي. احتفظ بالشهادة والمفتاح على وحدة التخزين ليجدهما كل خادم في المسار نفسه. + +## إنشاء عنقود {#build} + +تستخدم الأوامر التالية اسم المورد الافتراضي `arkvory`، ودليل التثبيت `/opt/proanima-arkvory`، والقرص الأساسي `/dev/vg0/arkvory`. نفّذها بصلاحيات root. + +1. على كل خادم بيانات، فك حزمة Arkvory دون تثبيتها. يضيف ذلك الملفات والأمر `arkvory` ولا ينشئ شيئاً في `/opt/proanima-arkvory`: + + ```bash + dpkg --unpack Arkvory-amd64.deb + ``` + + مع حزمة RPM، ثبّت الملفات دون تشغيل برامجها النصية: `rpm -i --noscripts Arkvory-x86_64.rpm`. على الخادم الأول ستثبّت الحزمة بالطريقة المعتادة في الخطوة 5 بدلاً من ذلك، لذا أنشئ الخطة في الخطوة 2 على خادم بيانات آخر. + +2. على أحد خوادم البيانات، أنشئ الخطة. يكتب الأمر مورد DRBD وأوامر Pacemaker في دليل لتراجعها: + + ```bash + arkvory cluster-plan --cluster ha-2 \ + --nodes node-a=10.0.0.11,node-b=10.0.0.12 --witness witness=10.0.0.13 \ + --disk /dev/vg0/arkvory --fence-agent fence_ipmilan \ + --virtual-ip 10.0.0.100/24 --output /root/arkvory-plan + ``` + + في `ha-3`، أدرج ثلاثة خوادم في `--nodes` واحذف `--witness`. الخيارات الاختيارية: `--cluster-resource`، و`--drbd-minor` (الافتراضي 0)، و`--drbd-port` (الافتراضي 7789)، و`--filesystem` (إما `xfs` أو `ext4`، والافتراضي `xfs`). يجب أن تكون الأسماء هي أسماء مضيفي الخوادم. والعناوين من نوع IPv4. + +3. انسخ `arkvory.res` إلى `/etc/drbd.d/` على كل خادم، بما فيه الشاهد. أنشئ بيانات التعريف على خوادم البيانات وفعّل المورد في كل مكان: + + ```bash + drbdadm create-md arkvory # خوادم البيانات فقط + drbdadm up arkvory # كل خادم + ``` + + على الشاهد، نفّذ أيضاً `systemctl enable drbd@arkvory.service` لتعود عقدة كسر التعادل بعد إعادة التشغيل. + + تتيح الخطة للنسخة العائدة إعادة المزامنة بسرعة لا تقل عن 20 MB/s حتى تحت حمل الكتابة، ولا تزيد عن 1 GB/s. اضبط `c-min-rate` و`c-max-rate` في قسم `disk` وفق قدرة وصلة النسخ لديك. + +4. على خادم البيانات الأول، اجعله أساسياً، وأنشئ نظام الملفات واربطه. مع الأقراص الجديدة الفارغة، تجاوز المزامنة الأولية أولاً: + + ```bash + drbdadm new-current-uuid --clear-bitmap arkvory/0 + drbdadm primary arkvory + mkfs.xfs /dev/drbd0 + mkdir -p /opt/proanima-arkvory && mount /dev/drbd0 /opt/proanima-arkvory + ``` + +5. ثبّت Arkvory على وحدة التخزين المرتبطة (مع RPM: `rpm -i Arkvory-x86_64.rpm` بدلاً من `dpkg --configure`)، وضع ملفات TLS على الوحدة وفعّل وضع العنقود: + + ```bash + dpkg --configure proanima-arkvory + install -d -m 0750 -o root -g arkvory /opt/proanima-arkvory/config/tls + install -m 0644 tls.crt /opt/proanima-arkvory/config/tls/tls.crt + install -m 0640 -g arkvory tls.key /opt/proanima-arkvory/config/tls/tls.key + arkvory configure --root /opt/proanima-arkvory --tls-cert /opt/proanima-arkvory/config/tls/tls.crt --tls-key /opt/proanima-arkvory/config/tls/tls.key --listen-host 0.0.0.0 + arkvory configure --root /opt/proanima-arkvory --cluster ha-2 + ``` + + يتحقق `configure --cluster` من أن دليل التثبيت هو جهاز DRBD المرتبط، وأن هذا الخادم أساسي، وأن نسختين على الأقل مكتملتان. ويبدأ `arkvory-replica`، ويجعل Arkvory يؤكد الكتابة عند وجود نسختين مكتملتين فقط، ويعطّل البدء التلقائي لخدمات Arkvory: يتولى Pacemaker بدءها من الآن فصاعداً. إذا فشلت خطوة، تُستعاد إعدادات الوضع المستقل. + +6. أوقف Arkvory على الخادم الأول وحرر وحدة التخزين: + + ```bash + arkvory cluster-release --root /opt/proanima-arkvory + ``` + + يوقف الأمر خدمات Arkvory بالترتيب، ويفك ربط وحدة التخزين، ويجعل هذا الخادم ثانوياً. + +7. جهّز كل خادم بيانات آخر على حدة: + + ```bash + arkvory cluster-node --root /opt/proanima-arkvory + dpkg --configure proanima-arkvory # لحزم .deb فقط؛ لا يلزم شيء آخر مع RPM + ``` + + يستحوذ `cluster-node` على وحدة التخزين، ويجهّز الخادم، ويحرر الوحدة مجدداً، حتى عند فشل خطوة؛ ويُبلّغ عن الخطأ الأول. لا يلزم `--cluster-resource` إلا إذا كان اسم المورد غير `arkvory`. يرفض الأمر العمل على خادم يخدم العنقود بالفعل ووحدة التخزين مرتبطة عليه (حررها أولاً باستخدام `cluster-release`)، وكذلك أثناء إدارة Pacemaker لمجموعة Arkvory، لأن الوحدة حينئذٍ تخص العنقود: أضف خادماً إلى عنقود يعمل كما هو موضح في [استبدال خادم](#replace-node). ينشئ `cluster-node` حسابات الخدمة بمعرّفات المستخدمين والمجموعات نفسها الموجودة على الخادم الأول (فهي مالكة الملفات على الوحدة)، ويثبّت الخدمات نفسها دون بدء أي منها تلقائياً. إذا كان حساب موجوداً بالفعل بمعرّفات مختلفة، يتوقف الأمر ويخبرك بالمعرّفات المطلوب تعيينها. في كل مرة يصبح فيها خادم نشطاً، يأخذ `arkvory-units` الخدمات من الوحدة أولاً، لذلك تسري أيضاً بعد تجاوز الفشل الإعدادات التي تغيّرت لاحقاً على الخادم النشط (مثل مخزن النسخ الاحتياطية). + +8. أعدّ عنقود Corosync باستخدام `pcs` على خوادم البيانات (`pcs host auth` و`pcs cluster setup` و`pcs cluster start --all`). على Debian وUbuntu، نفّذ أولاً `pcs cluster destroy` على كل خادم بيانات: تثبّت الحزم نموذج إعدادات Corosync يعتبره `pcs` عنقوداً موجوداً. لا تنفّذ `pcs cluster enable`: يجب ألا ينضم الخادم الذي عُزل قسرياً إلا عندما تبدأه أنت. في `ha-2`، صادِق أيضاً الشاهد ونفّذ عليه `pcs qdevice setup model net --enable --start`. على Debian وUbuntu تكون الحزمة قد أعدّت جهاز النصاب لحساب الخدمة الخاص بها: نفّذ هناك `systemctl enable --now corosync-qnetd` بدلاً من ذلك. + +9. افتح `/root/arkvory-plan/pacemaker.sh`. استبدل كل `` بمعلمات جهاز العزل القسري لديك: عنوانه، واسم الدخول، وملف كلمة المرور أو المفتاح، ومقبس الطاقة أو منفذ ذلك الخادم. ثم شغّل البرنامج النصي على أحد خوادم البيانات: + + ```bash + sh /root/arkvory-plan/pacemaker.sh + ``` + + يبني البرنامج النصي الإعدادات كلها في ملف ويطبقها دفعة واحدة: العزل القسري، وسياسة النصاب، ومورد DRBD، ومجموعة Arkvory وقيودها. + +10. افحص العنقود على الخادم النشط: + + ```bash + arkvory cluster-check --root /opt/proanima-arkvory + ``` + + يتحقق الأمر من النصاب، وتمكين العزل القسري، ووجود جهاز عزل لكل خادم، وإعدادات النصاب والعزل في DRBD، واكتمال نسختين على الأقل، وتشغيل Arkvory على خادم واحد بالضبط. ويخرج بخطأ عند فشل أي فحص. + +11. اختبر العزل القسري مرة: اعزل كل خادم احتياطي قسرياً واتركه يعود (انظر [اختبار العزل القسري](#fence-test)). + +وجّه عملاءك واسم DNS إلى العنوان الافتراضي. + +## التشغيل اليومي {#operation} + +نفّذ هذه الأوامر بصلاحيات root. تقرأ أوامر `cluster-status` و`cluster-single-copy` و`cluster-kit` وحدة التخزين، لذا نفّذها على الخادم النشط؛ وتعمل أوامر `cluster-check` و`cluster-switchover` و`cluster-fence-test` على أي خادم بيانات. + +| الأمر | وظيفته | +| ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | +| `arkvory cluster-status --root ` | ملف التعريف، ودور هذا الخادم، والنسخ المكتملة والمطلوبة، وأي قرار للمشغّل، بصيغة JSON | +| `arkvory cluster-check --root ` | جميع فحوص سلامة العنقود؛ يخرج بخطأ عند فشل أي منها | +| `arkvory cluster-switchover --root --to ` | نقل مخطط له لـArkvory إلى خادم بيانات آخر؛ يُرفض ما لم يحتفظ الهدف بنسخة مكتملة | +| `arkvory cluster-fence-test --root --node [--yes]` | يعزل خادماً احتياطياً قسرياً لاختبار جهاز عزله؛ يُرفض استهداف الخادم النشط | +| `arkvory cluster-single-copy --root --until