From d02131141723ec95eb8cc836bffe85dbd187649a Mon Sep 17 00:00:00 2001 From: ProAnima <217052501+ProAnima@users.noreply.github.com> Date: Mon, 16 Nov 2026 14:35:20 +0300 Subject: [PATCH 1/4] chore: refresh core dependencies and CI actions --- .github/workflows/check.yml | 84 +- .github/workflows/pages.yml | 4 +- .github/workflows/release.yml | 32 +- CHANGELOG.md | 2 + CONTRIBUTING.md | 4 +- apps/api/package.json | 4 +- apps/cli/package.json | 4 +- apps/web/src/user-token-model.ts | 5 +- docs/CURRENT_STATE.md | 6 +- docs/MAINTENANCE_2026-11-16.md | 100 ++ package-lock.json | 1250 +++++++++-------- package.json | 19 +- packages/infrastructure/package.json | 2 +- packages/infrastructure/src/webhook-egress.ts | 2 +- wiki/ar/guide/console.md | 12 +- wiki/ar/guide/index.md | 30 +- wiki/ar/install/index.md | 64 +- wiki/ar/install/windows.md | 30 +- wiki/ar/protocols/cli.md | 130 +- wiki/ar/protocols/containers.md | 48 +- wiki/ar/protocols/index.md | 28 +- wiki/ar/protocols/sdk.md | 20 +- wiki/ar/reference/environment.md | 180 +-- wiki/ar/use/trees.md | 14 +- wiki/hi/api/authentication.md | 126 +- wiki/hi/api/index.md | 54 +- wiki/hi/guide/agents.md | 26 +- wiki/hi/guide/concepts.md | 38 +- wiki/hi/guide/console.md | 14 +- wiki/hi/guide/index.md | 34 +- wiki/hi/install/configuration.md | 120 +- wiki/hi/install/docker.md | 92 +- wiki/hi/install/https.md | 60 +- wiki/hi/install/index.md | 100 +- wiki/hi/install/linux.md | 94 +- wiki/hi/install/updates.md | 60 +- wiki/hi/install/windows.md | 58 +- wiki/hi/operate/backups.md | 124 +- wiki/hi/operate/cluster.md | 46 +- wiki/hi/operate/licenses.md | 38 +- wiki/hi/operate/mirrors.md | 68 +- wiki/hi/operate/modules.md | 80 +- wiki/hi/operate/monitoring.md | 250 ++-- wiki/hi/operate/read-gateways.md | 28 +- wiki/hi/operate/security.md | 74 +- wiki/hi/operate/self-healing.md | 46 +- wiki/hi/operate/sites.md | 50 +- wiki/hi/operate/storage.md | 100 +- wiki/hi/operate/troubleshooting.md | 126 +- wiki/hi/protocols/cli.md | 194 +-- wiki/hi/protocols/containers.md | 114 +- wiki/hi/protocols/events.md | 20 +- wiki/hi/protocols/git-lfs.md | 82 +- wiki/hi/protocols/index.md | 72 +- wiki/hi/protocols/raw-files.md | 84 +- wiki/hi/protocols/sdk.md | 28 +- wiki/hi/protocols/unity-npm.md | 74 +- wiki/hi/protocols/webhooks.md | 46 +- wiki/hi/reference/environment.md | 248 ++-- wiki/hi/use/accounts.md | 88 +- wiki/hi/use/files.md | 22 +- wiki/hi/use/packages.md | 36 +- wiki/hi/use/promotion.md | 30 +- wiki/hi/use/repositories.md | 18 +- wiki/hi/use/transfers.md | 50 +- wiki/hi/use/trees.md | 30 +- 66 files changed, 2708 insertions(+), 2508 deletions(-) create mode 100644 docs/MAINTENANCE_2026-11-16.md diff --git a/.github/workflows/check.yml b/.github/workflows/check.yml index 04798c0c..f2dbc30b 100644 --- a/.github/workflows/check.yml +++ b/.github/workflows/check.yml @@ -33,10 +33,10 @@ 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' cache: npm @@ -63,10 +63,10 @@ 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' cache: npm @@ -75,7 +75,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: quality-${{ matrix.os }} @@ -92,10 +92,10 @@ 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' cache: npm @@ -114,10 +114,10 @@ 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' cache: npm @@ -146,10 +146,10 @@ 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' cache: npm @@ -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 @@ -186,10 +186,10 @@ 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' cache: npm @@ -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 @@ -232,10 +232,10 @@ 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' cache: npm @@ -244,7 +244,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: ${{ matrix.gate }} @@ -257,10 +257,10 @@ 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' cache: npm @@ -269,7 +269,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: security @@ -282,10 +282,10 @@ 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' cache: npm @@ -294,7 +294,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: docs @@ -307,10 +307,10 @@ 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' cache: npm @@ -325,10 +325,10 @@ 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' cache: npm @@ -351,10 +351,10 @@ 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' cache: npm @@ -379,10 +379,10 @@ 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' cache: npm @@ -406,10 +406,10 @@ 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' cache: npm @@ -446,10 +446,10 @@ 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' cache: npm @@ -486,10 +486,10 @@ 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' cache: npm @@ -526,10 +526,10 @@ 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' cache: npm @@ -586,10 +586,10 @@ 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' - name: Require every applicable gate to pass diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml index e49eb4b1..143de39c 100644 --- a/.github/workflows/pages.yml +++ b/.github/workflows/pages.yml @@ -24,10 +24,10 @@ 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' cache: npm diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index d4b18d7f..03a73719 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -23,10 +23,10 @@ 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' - name: Require the complete merge gate for this exact commit @@ -41,10 +41,10 @@ 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' cache: npm @@ -52,7 +52,7 @@ jobs: - 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' 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' 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 + - 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/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..0f65f7a8 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -4,7 +4,9 @@ Node.js 24 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/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/docs/CURRENT_STATE.md b/docs/CURRENT_STATE.md index 59740ece..f0c31ad6 100644 --- a/docs/CURRENT_STATE.md +++ b/docs/CURRENT_STATE.md @@ -1,6 +1,10 @@ # Актуальное состояние Arkvory -Сверено 2026-10-25. Это навигация по реализованным возможностям и ограничениям, а не новый план разработки. При изменении поведения обновляются соответствующая страница wiki, её переводы и этот обзор. Исторические отчёты и ADR сохраняют даты и исходные результаты. +Сверено 2026-11-16. Это навигация по реализованным возможностям и ограничениям, а не новый план разработки. При изменении поведения обновляются соответствующая страница wiki, её переводы и этот обзор. Исторические отчёты и ADR сохраняют даты и исходные результаты. + +Актуализация зависимостей, инструментов и CI поверх `main` / `2c5408af` описана в +[отчёте 2026-11-16](MAINTENANCE_2026-11-16.md). Эти изменения готовятся к следующему +выпуску; опубликованной совместимой парой остаются версии ниже. ## Выпуски и совместимость diff --git a/docs/MAINTENANCE_2026-11-16.md b/docs/MAINTENANCE_2026-11-16.md new file mode 100644 index 00000000..1930861b --- /dev/null +++ b/docs/MAINTENANCE_2026-11-16.md @@ -0,0 +1,100 @@ +# Актуализация 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 | + +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/package-lock.json b/package-lock.json index d87846b0..072aab04 100644 --- a/package-lock.json +++ b/package-lock.json @@ -14,21 +14,21 @@ ], "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" }, @@ -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,37 @@ } }, "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/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 +704,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 +714,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 +800,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 +820,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 +869,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 +884,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 +904,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 +923,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 +1009,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 +1025,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 +1064,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 +1076,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 +1123,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 +1203,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 +1220,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 +1237,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 +1254,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 +1271,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 +1288,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 +1305,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 +1322,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 +1339,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 +1356,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 +1373,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 +1390,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 +1407,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 +1423,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 +1460,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 +1477,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 +1516,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 +1558,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 +1599,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 +1624,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 +1683,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 +1756,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 +1779,23 @@ "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 +1811,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 +1833,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 +1851,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 +1868,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 +1893,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 +1907,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 +1935,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 +1959,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 +1984,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 +1997,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 +2085,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 +2159,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 +2178,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 +2229,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,9 +2264,9 @@ "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, @@ -2239,22 +2353,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 +2388,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 +2437,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 +2574,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 +2648,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 +2719,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": { @@ -2714,9 +2812,9 @@ } }, "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, @@ -2726,11 +2824,11 @@ "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 +2849,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 +3028,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 +3051,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 +3084,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 +3100,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 +3122,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 +3170,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 +3220,14 @@ "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 +3285,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 +3328,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 +3391,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 +3440,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 +3479,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 +3516,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", @@ -3482,9 +3596,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 +3611,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 +3912,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 +4028,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 +4069,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 +4220,15 @@ "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 +4236,7 @@ "node": ">= 16.0.0" }, "optionalDependencies": { - "pg-cloudflare": "^1.4.0" + "pg-cloudflare": "^1.4.1" }, "peerDependencies": { "pg-native": ">=3.0.1" @@ -4148,16 +4248,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 +4279,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 +4330,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 +4342,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 +4367,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 +4383,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 +4396,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 +4474,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 +4490,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 +4567,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 +4632,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 +4654,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 +4679,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 +4695,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 +4724,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 +4761,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 +4777,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 +4789,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 +4818,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 +4952,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 +4973,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 +4984,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 +5065,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,9 +5093,9 @@ } }, "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, @@ -5008,16 +5108,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 +5132,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 +5181,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 +5197,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 +5237,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 +5252,17 @@ } }, "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 +5331,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 +5372,18 @@ } }, "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": "*" @@ -5395,9 +5495,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 +5555,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..84d3d26d 100644 --- a/package.json +++ b/package.json @@ -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/wiki/ar/guide/console.md b/wiki/ar/guide/console.md index 0570ea53..d2ad6e27 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} diff --git a/wiki/ar/guide/index.md b/wiki/ar/guide/index.md index 8d99f3e2..99fd1952 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). @@ -49,19 +49,19 @@ 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). diff --git a/wiki/ar/install/index.md b/wiki/ar/install/index.md index 8c89bcde..d0f9aed3 100644 --- a/wiki/ar/install/index.md +++ b/wiki/ar/install/index.md @@ -15,12 +15,12 @@ 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` | مضيفات الحاويات | +| الخيار | المنصة | يبدأ بعد إعادة التشغيل دون تسجيل دخول | قاعدة البيانات | التحديثات التلقائية بعد التثبيت | موصى به لـ | +| -------------------------------------------------------------------------------------------- | ------------------------------------------- | ------------------------------------------------------------------------- | ---------------------------------------------------- | ------------------------------------------------------- | -------------------------------------------------------- | +| [برنامج التثبيت الرسومي](./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` | التجربة على محطة عمل | تثبّت كل الخيارات 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) | +| `api.github.com` و`github.com` ومضيفات التنزيل في GitHub | برامج التثبيت النصية، والتحديثات عندما يتعذر الوصول إلى مركز التحديثات | +| `hub.proanima.net` | التحقق من التحديثات وتنزيلها. راجع [التحديثات](./updates) | | Docker Hub | يبني Compose صورته من `node:24.21.0-bookworm-slim` ويشغّل `postgres:18.4` | دون إنترنت، ثبّت وحدّث من نسخة محلية من الإصدار. راجع [التحديثات](./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 | PostgreSQL المُدار في برنامج التثبيت الرسومي وحزم Linux | `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/windows.md b/wiki/ar/install/windows.md index d555dcf2..ad96a298 100644 --- a/wiki/ar/install/windows.md +++ b/wiki/ar/install/windows.md @@ -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`. @@ -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/protocols/cli.md b/wiki/ar/protocols/cli.md index 1a7243c1..fa52ba54 100644 --- a/wiki/ar/protocols/cli.md +++ b/wiki/ar/protocols/cli.md @@ -8,12 +8,12 @@ title: سطر الأوامر (arkvoryctl) ## التثبيت {#install} -| النظام | الحزمة | طريقة التثبيت | -| ----------------------------------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------ | +| النظام | الحزمة | طريقة التثبيت | +| ----------------------------------------- | --------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | Windows 10/11 وWindows Server 2019+ (x64) | `Arkvory-CLI-Setup-x64.exe` | شغّله. يثبّت للمستخدم الحالي دون صلاحيات المسؤول، ويضيف `arkvoryctl` إلى `PATH` الخاص بالمستخدم. افتح نافذة طرفية جديدة. | -| Debian وUbuntu (x64) | `Arkvory-CLI-amd64.deb` | `sudo apt install ./Arkvory-CLI-amd64.deb` | -| Fedora والتوزيعات المتوافقة مع RHEL (x64) | `Arkvory-CLI-x86_64.rpm` | `sudo dnf install ./Arkvory-CLI-x86_64.rpm` | -| أي نظام فيه Node.js 24 (مثل مُشغِّل CI) | `arkvoryctl.mjs` | `node ./arkvoryctl.mjs --help` | +| Debian وUbuntu (x64) | `Arkvory-CLI-amd64.deb` | `sudo apt install ./Arkvory-CLI-amd64.deb` | +| Fedora والتوزيعات المتوافقة مع RHEL (x64) | `Arkvory-CLI-x86_64.rpm` | `sudo dnf install ./Arkvory-CLI-x86_64.rpm` | +| أي نظام فيه Node.js 24 (مثل مُشغِّل CI) | `arkvoryctl.mjs` | `node ./arkvoryctl.mjs --help` | تتضمن الحزم الأصلية Node.js الخاص بها. ولا يعتمد الملف المفرد `arkvoryctl.mjs` على أي تبعيات npm. خذ الملفات من إصدار موثوق لـ `ProAnima/Arkvory` وقارن SHA-256 الخاص بها بـ `release-checksums.json`. حزم ARM64 غير متوفرة بعد. وللتحديث، ثبّت إصدارًا مستقرًا أحدث. ولا يحذف إلغاء التثبيت ملفات التعريف (profiles) وملفات المفاتيح ونقاط التحقق (checkpoints) الخاصة بك. @@ -47,30 +47,30 @@ arkvoryctl doctor | `profile use NAME` | يجعل ملف تعريف هو الافتراضي | | `profile remove NAME` | يزيل ملف تعريف | -| المتغير | المعنى | -| -------------------- | -------------------------------------------------------------------------------------------------------------------------------- | -| `ARKVORY_TOKEN` | المفتاح نفسه. له الأولوية على أي ملف. | -| `ARKVORY_TOKEN_FILE` | مسار ملف مفتاح. له الأولوية على ملف المفتاح في ملف التعريف. | +| المتغير | المعنى | +| -------------------- | ------------------------------------------------------------------------------------------------------------------------------ | +| `ARKVORY_TOKEN` | المفتاح نفسه. له الأولوية على أي ملف. | +| `ARKVORY_TOKEN_FILE` | مسار ملف مفتاح. له الأولوية على ملف المفتاح في ملف التعريف. | | `ARKVORY_BASE_URL` | عنوان URL للخادم. وعند ضبطه **لا** يُستخدم ملف المفتاح في ملف التعريف: مرّر المفتاح عبر `ARKVORY_TOKEN` أو `ARKVORY_TOKEN_FILE`. | -| `ARKVORY_CLI_HOME` | مجلد آخر لـ `profiles.json` | +| `ARKVORY_CLI_HOME` | مجلد آخر لـ `profiles.json` | يجب أن يستخدم عنوان URL للخادم HTTPS. ويُسمح بـ HTTP العادي فقط لـ `localhost` و`127.0.0.1` و`[::1]`. ولا يمكن إيقاف التحقق من TLS. ## الخيارات العامة {#global-options} -| الخيار | الافتراضي | المعنى | -| -------------------------- | ----------------- | ------------------------------------------------------------------------------------------------- | -| `--profile NAME` | ملف التعريف النشط | ملف التعريف لهذا الأمر فقط | -| `--repository NAME` | من ملف التعريف | المستودع لهذا الأمر فقط | -| `--json` | متوقف | نتيجة JSON مضغوطة واحدة على stdout؛ والأخطاء بصيغة JSON على stderr | -| `--lang en` أو `--lang ru` | من `LANG` | لغة المساعدة والرسائل | -| `--timeout MS` | 60000 | حد طلبات الإدارة (من 1 إلى 3600000) | -| `--attempt-timeout MS` | 120000 | حد محاولة نقل واحدة (من 1 إلى 1800000) | -| `--retries N` | 20 | إعادات المحاولة عند أعطال الشبكة لعملية واحدة (من 0 إلى 100)؛ و`0` توقفها | +| الخيار | الافتراضي | المعنى | +| -------------------------- | ----------------- | ------------------------------------------------------------------------------------------------ | +| `--profile NAME` | ملف التعريف النشط | ملف التعريف لهذا الأمر فقط | +| `--repository NAME` | من ملف التعريف | المستودع لهذا الأمر فقط | +| `--json` | متوقف | نتيجة JSON مضغوطة واحدة على stdout؛ والأخطاء بصيغة JSON على stderr | +| `--lang en` أو `--lang ru` | من `LANG` | لغة المساعدة والرسائل | +| `--timeout MS` | 60000 | حد طلبات الإدارة (من 1 إلى 3600000) | +| `--attempt-timeout MS` | 120000 | حد محاولة نقل واحدة (من 1 إلى 1800000) | +| `--retries N` | 20 | إعادات المحاولة عند أعطال الشبكة لعملية واحدة (من 0 إلى 100)؛ و`0` توقفها | | `--verbose` | متوقف | سطر stderr واحد لكل طلب HTTP: الطريقة والمسار والحالة والزمن ومعرّف الطلب. دون ترويسات أو مفاتيح. | -| `--transfer MODE` | `auto` | امتدادات النقل في [وحدات العميل](#client-modules): `auto` أو `strict` أو `core` (دونها) | -| `--help` و`--version` | | المساعدة؛ وإصدار العميل بصيغة JSON | -| `--` | | ينهي الخيارات، لأسماء الملفات التي تبدأ بـ `-` | +| `--transfer MODE` | `auto` | امتدادات النقل في [وحدات العميل](#client-modules): `auto` أو `strict` أو `core` (دونها) | +| `--help` و`--version` | | المساعدة؛ وإصدار العميل بصيغة JSON | +| `--` | | ينهي الخيارات، لأسماء الملفات التي تبدأ بـ `-` | يمكن أن يظهر كل خيار مرة واحدة فقط. وتُرفض الخيارات غير المعروفة. @@ -78,30 +78,30 @@ arkvoryctl doctor ### الاستكشاف والفهرس {#discovery-and-catalog} -| الأمر | النتيجة | -| -------------------------------------------------------------------------------------------- | ----------------------------------------------------- | -| `doctor` | الاتصال والإمكانات والأذونات | -| `repositories [--after CURSOR]` | المستودعات المرئية للمفتاح | -| `operations [--after CURSOR]` | عمليات API المتاحة في المستودع | -| `list [--after CURSOR]` | مُخرَجات المستودع | -| `search [--query TEXT] [--label TAG] [--collection NAME] [--after CURSOR]` | بحث بالاسم وبنص بيانات التعريف | -| `search --metadata-key KEY --metadata-value VALUE` | مطابقة دقيقة لبيانات التعريف (مرّر الاثنين معًا) | +| الأمر | النتيجة | +| -------------------------------------------------------------------------------------------- | ---------------------------------------------------- | +| `doctor` | الاتصال والإمكانات والأذونات | +| `repositories [--after CURSOR]` | المستودعات المرئية للمفتاح | +| `operations [--after CURSOR]` | عمليات API المتاحة في المستودع | +| `list [--after CURSOR]` | مُخرَجات المستودع | +| `search [--query TEXT] [--label TAG] [--collection NAME] [--after CURSOR]` | بحث بالاسم وبنص بيانات التعريف | +| `search --metadata-key KEY --metadata-value VALUE` | مطابقة دقيقة لبيانات التعريف (مرّر الاثنين معًا) | | `search --all [--query TEXT] [--repositories R1,R2] [--label L1,L2] [--stage S] [--limit N]` | كل المستودعات التي يستطيع المفتاح سردها، الأحدث أولًا | -| `inspect ID` | بيانات التعريف لمُخرَج واحد | -| `storage usage` / `storage policy` | استخدام المستودع وسياسة التخزين | +| `inspect ID` | بيانات التعريف لمُخرَج واحد | +| `storage usage` / `storage policy` | استخدام المستودع وسياسة التخزين | تعيد الصفحات `next`. مرّره مع `--after` لقراءة الصفحة التالية. ### عمليات النقل {#transfers} -| الأمر | النتيجة | -| ------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- | -| `upload FILE [--label TAG] [--file METADATA.json] [--state CHECKPOINT.json]` | رفع قابل للاستئناف لأي ملف | -| `download ID OUTPUT` | تنزيل قابل للاستئناف ومتحقَّق منه بـ SHA-256 | +| الأمر | النتيجة | +| ------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------- | +| `upload FILE [--label TAG] [--file METADATA.json] [--state CHECKPOINT.json]` | رفع قابل للاستئناف لأي ملف | +| `download ID OUTPUT` | تنزيل قابل للاستئناف ومتحقَّق منه بـ SHA-256 | | `put FILE PATH [--label TAG] [--file METADATA.json] [--state CHECKPOINT.json]` | يرفع الملف ويجعله المراجعة التالية لمسار. وإذا كان المسار يحتوي البايتات نفسها، فلا يُرفع شيء. | | `get PATH OUTPUT` | ينزّل المراجعة الحالية لمسار، مع التحقق وإمكانية الاستئناف | | `link ID [--ttl SECONDS]` | عنوان تنزيل دون مفتاح، صالح من 60 ثانية إلى 24 ساعة (ساعة واحدة افتراضيًا) | -| `uploads status ID` / `uploads cancel ID` | حالة جلسة رفع؛ وإلغاؤها (الإلغاء ليس إيقافًا مؤقتًا) | +| `uploads status ID` / `uploads cancel ID` | حالة جلسة رفع؛ وإلغاؤها (الإلغاء ليس إيقافًا مؤقتًا) | يحتوي `METADATA.json` على `labels` و`metadata` (خريطة من النصوص). وله الأولوية على `--label`. @@ -117,25 +117,25 @@ arkvoryctl link 00000000-0000-4000-8000-000000000001 --ttl 900 | الأمر | النتيجة | | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | -| `tree push DIR [--name NAME.zip] [--label TAG] [--file METADATA.json] [--compress]` | ينشر المجلد بوصفه مُخرَج ZIP واحدًا، مع إمكانية الاستئناف | -| `tree pull ID DIR` | يجعل المجلد مطابقًا للشجرة: الأرشيف كاملًا، أو الملفات المختلفة فقط | +| `tree push DIR [--name NAME.zip] [--label TAG] [--file METADATA.json] [--compress]` | ينشر المجلد بوصفه مُخرَج ZIP واحدًا، مع إمكانية الاستئناف | +| `tree pull ID DIR` | يجعل المجلد مطابقًا للشجرة: الأرشيف كاملًا، أو الملفات المختلفة فقط | | `tree verify ID DIR` | يسرد الملفات المفقودة والمختلفة والزائدة؛ رمز الخروج 5 عند وجود أي اختلاف | -| `tree repair ID DIR` | يعيد كتابة الملفات المفقودة والمختلفة؛ ويُبقي الملفات الزائدة | +| `tree repair ID DIR` | يعيد كتابة الملفات المفقودة والمختلفة؛ ويُبقي الملفات الزائدة | راجع [أشجار الأدلة](../use/trees). ### الحزم والترقية {#packages-and-promotion} -| الأمر | النتيجة | -| --------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | -| `packages list [--group G] [--name N] [--after CURSOR]` | حزم UPack | +| الأمر | النتيجة | +| --------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | +| `packages list [--group G] [--name N] [--after CURSOR]` | حزم UPack | | `packages publish FILE [--label TAG] [--file METADATA.json] [--state CHECKPOINT.json]` | يرفع أرشيف UPack ويسجّله | -| `packages register ID` | يسجّل UPack مرفوعًا بالفعل | +| `packages register ID` | يسجّل UPack مرفوعًا بالفعل | | `packages resolve NAME [--group G] [--exact V] [--range R] [--stage S] [--prerelease] [--order promoted]` | يحدد إصدارًا (`--exact` و`--range` يستبعد أحدهما الآخر) | -| `packages download NAME OUTPUT [same filters]` | يحدد إصدارًا ثم ينزّله مع التحقق | -| `promote ID --to REPOSITORY [--move] [--stage S1,S2] [--comment TEXT]` | ينشر المُخرَج في مستودع آخر دون إرسال البايتات مرة أخرى | -| `stages list ID` / `stages add ID STAGE [--comment TEXT]` / `stages remove ID STAGE` / `stages artifacts [--stage S]` | مراحل المُخرَجات | -| `promotions history ID` / `promotions journal [--after CURSOR]` | محفوظات الترقية | +| `packages download NAME OUTPUT [same filters]` | يحدد إصدارًا ثم ينزّله مع التحقق | +| `promote ID --to REPOSITORY [--move] [--stage S1,S2] [--comment TEXT]` | ينشر المُخرَج في مستودع آخر دون إرسال البايتات مرة أخرى | +| `stages list ID` / `stages add ID STAGE [--comment TEXT]` / `stages remove ID STAGE` / `stages artifacts [--stage S]` | مراحل المُخرَجات | +| `promotions history ID` / `promotions journal [--after CURSOR]` | محفوظات الترقية | ```bash arkvoryctl packages publish ./build.upack --label test --state ./job-state/build.json --json @@ -155,9 +155,9 @@ arkvoryctl packages download app ./app.upack --range ^1.4 --stage release | ----------------------------------------------------------------- | ---------------------------------------------------------------------------- | | `backup status` | المخزن والوكيل والخطة وآخر نقطة والتحذيرات؛ ورمز الخروج 9 عند وجود تحذير حرج | | `backup run` | يضع مهمة نسخ احتياطي في قائمة الانتظار | -| `backup jobs [--after CURSOR]` / `backup points [--after CURSOR]` | المهام ونقاط الاستعادة، الأحدث أولًا | -| `backup verify POINT_ID` | يضع تحققًا كاملًا من نقطة في قائمة الانتظار | -| `backup pin POINT_ID [--off]` | يُبقي نقطة بعد انتهاء مدة الاحتفاظ، أو يحرّرها | +| `backup jobs [--after CURSOR]` / `backup points [--after CURSOR]` | المهام ونقاط الاستعادة، الأحدث أولًا | +| `backup verify POINT_ID` | يضع تحققًا كاملًا من نقطة في قائمة الانتظار | +| `backup pin POINT_ID [--off]` | يُبقي نقطة بعد انتهاء مدة الاحتفاظ، أو يحرّرها | تحتاج هذه الأوامر إلى مفتاح الملف الخاص بمالك التثبيت (bootstrap) أو إلى جلسة مسؤول حساب. أما الرموز الشخصية ومفاتيح الخدمة فتحصل على 403 (رمز الخروج 3). ويؤدي وكيل النسخ الاحتياطي في الخادم العمل. مثال للمراقبة: `arkvoryctl backup status --json || alert`. راجع [النسخ الاحتياطية](../operate/backups). @@ -268,13 +268,13 @@ claude mcp add arkvory -- arkvoryctl mcp --profile production --root ~/work وحدة العميل حزمة موقّعة من ProAnimaStudio تضيف إلى `arkvoryctl` نفسه، مثل طريقة أسرع لنقل البايتات (امتداد نقل). لا يحتوي العميل المجاني أي وحدة من هذا النوع؛ ودون وحدة يعمل كل أمر كما هو موضح في هذه الصفحة. -| الأمر | النتيجة | -| --------------------------------------------------------- | -------------------------------------------------------- | -| `module install FILE [--yes] [--allow-stale-revocations]` | يتحقق من الحزمة ويعرضها مع شروطها؛ ويثبّتها مع `--yes` | -| `module list` | الوحدات المثبتة، وأين هي مفعّلة، وحالة قائمة الإبطال | -| `module enable ID [--profile NAME]` | يفعّل الوحدة لكل ملفات التعريف، أو لملف واحد | -| `module disable ID [--profile NAME]` | يعطّلها في كل مكان، أو لملف تعريف واحد | -| `module remove ID` | يزيل الوحدة | +| الأمر | النتيجة | +| --------------------------------------------------------- | ------------------------------------------------------ | +| `module install FILE [--yes] [--allow-stale-revocations]` | يتحقق من الحزمة ويعرضها مع شروطها؛ ويثبّتها مع `--yes` | +| `module list` | الوحدات المثبتة، وأين هي مفعّلة، وحالة قائمة الإبطال | +| `module enable ID [--profile NAME]` | يفعّل الوحدة لكل ملفات التعريف، أو لملف واحد | +| `module disable ID [--profile NAME]` | يعطّلها في كل مكان، أو لملف تعريف واحد | +| `module remove ID` | يزيل الوحدة | | `module revocations FILE` | يخزّن قائمة إبطال موقّعة، للأجهزة التي لا تتصل بالإنترنت | - **المكان.** تُثبَّت الوحدات لمستخدمك في المجلد `modules` داخل مجلد CLI (`ARKVORY_CLI_HOME`، وافتراضيًا `~/.config/arkvory`). وتبقى الوحدة الجديدة معطّلة إلى أن تفعّلها. @@ -298,7 +298,7 @@ claude mcp add arkvory -- arkvoryctl mcp --profile production --root ~/work | 3 | لا يوجد مفتاح، أو الوصول مرفوض (401 و403) | | 4 | خطأ في HTTP أو الشبكة، أو انتهاء مهلة، أو انشغال الخادم، أو عدم العثور على العنصر | | 5 | فشل في السلامة (عدم تطابق SHA-256، و422 `integrity_mismatch`) | -| 6 | تعارض: المراجعة أو الحالة أو القفل أو ملف موجود أو نقطة تحقق تغيّرت (409) | +| 6 | تعارض: المراجعة أو الحالة أو القفل أو ملف موجود أو نقطة تحقق تغيّرت (409) | | 7 | خطأ في ملف محلي أو رد خادم غير صالح | | 8 | بلوغ حد سعة الخادم: الحصة أو القرص أو قائمة الانتظار (507 `capacity_exceeded`) | | 9 | `backup status`: يوجد تحذير حرج نشط للنسخ الاحتياطي | @@ -308,17 +308,17 @@ claude mcp add arkvory -- arkvoryctl mcp --profile production --root ~/work ## استكشاف الأخطاء وإصلاحها {#troubleshooting} -| الرسالة | السبب والحل | -| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | +| الرسالة | السبب والحل | +| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | | `credential_required` (الخروج 3) | لم يُعثر على مفتاح. تحقق من `--token-file` أو `ARKVORY_TOKEN_FILE`، أو اضبط المفتاح عند استخدام `ARKVORY_BASE_URL`. | | `forbidden` (الخروج 3) | المفتاح لا يملك الإذن. شغّل `doctor` لعرض الأذونات. | | `checkpoint_mismatch` (الخروج 6) | الملف أو الخادم أو المستودع أو الخيارات تختلف عن نقطة التحقق المحفوظة. استخدم الخيارات الأصلية، أو `--state` جديدًا. | -| `state_locked` (الخروج 6) | عملية أخرى تستخدم نقطة التحقق، أو بقي ملف `.lock` قديم بعد تعطل. | +| `state_locked` (الخروج 6) | عملية أخرى تستخدم نقطة التحقق، أو بقي ملف `.lock` قديم بعد تعطل. | | `destination_exists` (الخروج 6) | ملف الإخراج موجود. اختر اسمًا آخر. | -| `revision_mismatch` في `put` (الخروج 6) | غيّر شخص ما المسار في الأثناء. افحص محفوظات المسار ثم قرّر. | -| الخروج 8 | الحصة أو القرص ممتلئ. اسأل المسؤول. | +| `revision_mismatch` في `put` (الخروج 6) | غيّر شخص ما المسار في الأثناء. افحص محفوظات المسار ثم قرّر. | +| الخروج 8 | الحصة أو القرص ممتلئ. اسأل المسؤول. | | `checksum_mismatch` (الخروج 5) | ملف من شجرة لم يطابق الملف المنشور؛ وبقي الملف في المجلد كما كان. كرّر الأمر. | -| `path_outside_root` و`unsafe_name` | يذكر أرشيف أو جدول محتويات مسارًا خارج المجلد، أو اسمًا لا يقبله Windows. لم يُكتب شيء. | +| `path_outside_root` و`unsafe_name` | يذكر أرشيف أو جدول محتويات مسارًا خارج المجلد، أو اسمًا لا يقبله Windows. لم يُكتب شيء. | | `stale_revocations` (الخروج 6) | لا توجد قائمة إبطال حديثة لـ `module install`. خزّن واحدة بـ `module revocations FILE`. | ## صفحات ذات صلة {#related-pages} diff --git a/wiki/ar/protocols/containers.md b/wiki/ar/protocols/containers.md index 020d1357..ab2a3ab5 100644 --- a/wiki/ar/protocols/containers.md +++ b/wiki/ar/protocols/containers.md @@ -34,12 +34,12 @@ description: ادفع صور Docker وOCI ومخططات Helm ومُخرَجات | `arkvory.example/releases/team/web:1.4` | `releases` | `team/web` | الوسم `1.4` | | `arkvory.example/qa/tools/builder@sha256:…` | `qa` | `tools/builder` | الملخص (digest) | -| الجزء | القاعدة | -| -------- | --------------------------------------------------------------------------------------------------------------------- | -| المستودع | أحرف صغيرة وأرقام و`_` و`-`. يبدأ بحرف أو رقم. حتى 64 حرفًا. | +| الجزء | القاعدة | +| -------- | ------------------------------------------------------------------------------------------------------------------- | +| المستودع | أحرف صغيرة وأرقام و`_` و`-`. يبدأ بحرف أو رقم. حتى 64 حرفًا. | | الصورة | مكوّنات مفصولة بـ `/`. يتألف المكوّن من أحرف صغيرة وأرقام تربطها `.` أو `_` أو `__` أو شرطات. حتى 200 حرف في المجموع. | -| الوسم | أحرف وأرقام و`_` و`.` و`-`. يبدأ بحرف أو رقم أو `_`. حتى 128 حرفًا. | -| الملخص | `sha256:` و64 رقمًا سداسي عشريًا بأحرف صغيرة. تُرفض الخوارزميات الأخرى. | +| الوسم | أحرف وأرقام و`_` و`.` و`-`. يبدأ بحرف أو رقم أو `_`. حتى 128 حرفًا. | +| الملخص | `sha256:` و64 رقمًا سداسي عشريًا بأحرف صغيرة. تُرفض الخوارزميات الأخرى. | يُرفض المرجع الذي لا يحتوي على جزء الصورة، مثل `arkvory.example/web:1.4`، بالخطأ `NAME_INVALID`: يؤخذ `web` على أنه المستودع، ويكون اسم الصورة فارغًا. @@ -63,7 +63,7 @@ helm registry login arkvory.example -u ci --password-stdin < ~/.arkvory/key oras login arkvory.example -u ci --password-stdin < ~/.arkvory/key ``` -| المفتاح | يُستخدم لـ | +| المفتاح | يُستخدم لـ | | ---------------------------------- | ---------------------------------------------------------------------- | | رمز وصول شخصي، النطاق `read` | السحب على محطة عمل | | رمز وصول شخصي، النطاق `read-write` | الدفع من محطة عمل | @@ -93,7 +93,7 @@ docker pull arkvory.example/releases/team/web@sha256: | نوع الوسائط (Media type) | الاستخدام | | ----------------------------------------------------------- | ------------------------------------------------------ | -| `application/vnd.oci.image.manifest.v1+json` | صور OCI ومخططات Helm ومُخرَجات ORAS | +| `application/vnd.oci.image.manifest.v1+json` | صور OCI ومخططات Helm ومُخرَجات ORAS | | `application/vnd.oci.image.index.v1+json` | الصور متعددة المنصات، وذاكرة BuildKit المؤقتة في السجل | | `application/vnd.docker.distribution.manifest.v2+json` | صور Docker (المخطط 2) | | `application/vnd.docker.distribution.manifest.list.v2+json` | صور Docker متعددة المنصات | @@ -176,7 +176,7 @@ curl -fsSI -u "ci:$ARKVORY_KEY" \ | -------------------------------------- | --------------------------------------------------- | | `DELETE /v2//manifests/` | يزيل الوسم فقط. ويبقى ملف البيان ويمكن سحبه بملخصه. | | `DELETE /v2//manifests/` | يزيل ملف البيان وكل وسم يشير إليه | -| `DELETE /v2//blobs/` | يُرفض بالرمز `405`. تغادر الطبقات مع ملفات بيانها. | +| `DELETE /v2//blobs/` | يُرفض بالرمز `405`. تغادر الطبقات مع ملفات بيانها. | يحتاج كلا الحذفين إلى مفتاح خدمة بالإجراء `artifact.delete` في المستودع. ولا تستطيع الرموز الشخصية وجلسات وحدة التحكم ومفاتيح الملفات حذف الصور. ويجيب الحذف بالرمز `202`. @@ -213,16 +213,16 @@ curl -fsS -X DELETE -H "Authorization: Bearer $ARKVORY_CLEANUP_KEY" \ ## الحدود {#limits} -| الحد | القيمة | -| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| حجم ملف البيان | 4 MiB | +| الحد | القيمة | +| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| حجم ملف البيان | 4 MiB | | حجم الطبقة | أكبر كائن في التثبيت، `ARKVORY_MAX_OBJECT_BYTES` (نحو 10 TiB افتراضيًا) | | طلب رفع واحد | يجب أن ينتهي خلال 30 دقيقة، ويجب ألا يتوقف أكثر من 30 ثانية (`ARKVORY_UPLOAD_DEADLINE_MS` و`ARKVORY_UPLOAD_IDLE_TIMEOUT_MS`). و30 دقيقة هي أيضًا أعلى قيمة مسموحة. | | رفع غير مكتمل | يُزال مع بايتاته بعد 24 ساعة دون نشاط | -| مساحة القرص المؤقتة | حتى ضعف حجم الطبقة أثناء رفعها | +| مساحة القرص المؤقتة | حتى ضعف حجم الطبقة أثناء رفعها | | عمليات الرفع المتزامنة | 1 لكل مفتاح و2 لكل خادم افتراضيًا (`ARKVORY_MAX_UPLOADS_PER_PRINCIPAL` و`ARKVORY_MAX_UPLOADS`). ويستسلم الطلب المنتظر بعد 20 ثانية (`ARKVORY_TRANSFER_QUEUE_TIMEOUT_MS`). | | عمليات التنزيل المتزامنة | 4 لكل مفتاح و16 لكل خادم افتراضيًا | -| الوسوم في الصفحة | 1000 | +| الوسوم في الصفحة | 1000 | | الحصة | تُحتسب الطبقات وملفات البيان وبايتات عمليات الرفع غير المكتملة ضمن حصة المستودع وسعة التثبيت | يرسل Docker كل طبقة في طلب واحد. لذا يجب أن تصل الطبقة خلال مهلة الرفع، وعندما يفشل رفع طبقة يبدأ من البايت الأول. وللملفات التي يبلغ حجمها غيغابايتات كثيرة، استخدم [`arkvoryctl`](./cli) بدلًا من ذلك: فهو يرفع على أجزاء ويتابع بعد الفشل. وتوصف المتغيرات في [متغيرات البيئة](../reference/environment#transfers-and-bandwidth). @@ -256,20 +256,20 @@ curl -fsS -X DELETE -H "Authorization: Bearer $ARKVORY_CLEANUP_KEY" \ يطبع Docker رموز أخطاء السجل بأحرف صغيرة مع مسافات، مثل `denied` أو `name invalid`، متبوعة برسالة الخادم. ولكل خطأ أيضًا معرّف طلب في `detail.requestId`. أعطه لمسؤولك: فهو يعثر على الطلب في سجل الخادم. -| الخطأ | السبب | ما العمل | -| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | -| `UNAUTHORIZED` (401) | المفتاح مفقود أو خاطئ أو منتهٍ أو مُبطَل | سجّل الدخول مرة أخرى بمفتاح صالح | +| الخطأ | السبب | ما العمل | +| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | +| `UNAUTHORIZED` (401) | المفتاح مفقود أو خاطئ أو منتهٍ أو مُبطَل | سجّل الدخول مرة أخرى بمفتاح صالح | | `DENIED` (403) | لا يستطيع المفتاح الكتابة أو لا يرى المستودع. والرمز ذو النطاق `read` يحصل على "Read-only personal access token". | استخدم مفتاحًا له وصول كتابة إلى هذا المستودع | -| `DENIED` (409) | المستودع مرآة | ادفع إلى الخادم الرئيسي | -| `DENIED` (507) | بلغت حصة المستودع أو سعة التثبيت حدها. وتُحتسب عمليات الرفع غير المكتملة أيضًا. | حرّر مساحة أو اطلب حصة أكبر | -| `NAME_INVALID` | لا يحتوي المرجع على جزء الصورة بعد المستودع، أو فيه أحرف كبيرة | استخدم `//:` بأحرف صغيرة | -| `MANIFEST_UNKNOWN` | الوسم أو الملخص غير موجود في هذه الصورة | تحقق من الاسم بـ `tags/list` | -| `MANIFEST_BLOB_UNKNOWN` | يشير ملف بيان إلى طبقة أو ملف بيان منصة غير موجود في هذا المستودع | ادفع الصورة كلها مرة أخرى ليرفع العميل الأجزاء الناقصة | -| `DIGEST_INVALID` | البايتات لا تطابق الملخص | ادفع مرة أخرى. وإذا تكرر ذلك، فافحص الوكيل (proxy). | -| `TOOMANYREQUESTS` (503 أو 429) | عمليات نقل كثيرة جدًا لهذا المفتاح في الوقت نفسه، أو الخادم مشغول | انتظر وأعد المحاولة. قلّل عمليات الرفع المتوازية للعميل، مثل `"max-concurrent-uploads": 1` في إعدادات خدمة Docker، أو اطلب من المسؤول رفع حدود النقل. | +| `DENIED` (409) | المستودع مرآة | ادفع إلى الخادم الرئيسي | +| `DENIED` (507) | بلغت حصة المستودع أو سعة التثبيت حدها. وتُحتسب عمليات الرفع غير المكتملة أيضًا. | حرّر مساحة أو اطلب حصة أكبر | +| `NAME_INVALID` | لا يحتوي المرجع على جزء الصورة بعد المستودع، أو فيه أحرف كبيرة | استخدم `//:` بأحرف صغيرة | +| `MANIFEST_UNKNOWN` | الوسم أو الملخص غير موجود في هذه الصورة | تحقق من الاسم بـ `tags/list` | +| `MANIFEST_BLOB_UNKNOWN` | يشير ملف بيان إلى طبقة أو ملف بيان منصة غير موجود في هذا المستودع | ادفع الصورة كلها مرة أخرى ليرفع العميل الأجزاء الناقصة | +| `DIGEST_INVALID` | البايتات لا تطابق الملخص | ادفع مرة أخرى. وإذا تكرر ذلك، فافحص الوكيل (proxy). | +| `TOOMANYREQUESTS` (503 أو 429) | عمليات نقل كثيرة جدًا لهذا المفتاح في الوقت نفسه، أو الخادم مشغول | انتظر وأعد المحاولة. قلّل عمليات الرفع المتوازية للعميل، مثل `"max-concurrent-uploads": 1` في إعدادات خدمة Docker، أو اطلب من المسؤول رفع حدود النقل. | | `http: server gave HTTP response to HTTPS client` | ليس للخادم HTTPS | أعدّ [HTTPS](../install/https)، أو استخدم `insecure-registries` لخادم اختبار | | `x509: certificate signed by unknown authority` | لا يثق Docker بالشهادة | ثبّت شهادة جهة الإصدار (CA) كما هو موضح أعلاه | -| `413 Request Entity Too Large` | يحدّ الوكيل العكسي حجم الطلب | اضبط `client_max_body_size 0` في nginx | +| `413 Request Entity Too Large` | يحدّ الوكيل العكسي حجم الطلب | اضبط `client_max_body_size 0` في nginx | | طبقة كبيرة تتوقف بعد 30 دقيقة | مهلة الرفع لطلب واحد | استخدم شبكة أسرع، أو أبقِ هذه الملفات خارج الصور وارفعها بـ `arkvoryctl` | ## صفحات ذات صلة {#related-pages} diff --git a/wiki/ar/protocols/index.md b/wiki/ar/protocols/index.md index 1bfaa966..cdb8a449 100644 --- a/wiki/ar/protocols/index.md +++ b/wiki/ar/protocols/index.md @@ -13,14 +13,14 @@ title: العملاء والبروتوكولات | الطريقة | العنوان | تصلح لـ | بيانات الاعتماد | | ------------------------ | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------- | | وحدة التحكم على الويب | `https://arkvory.example/console/` | تصفح المستودعات، والرفع والتنزيل في المتصفح، وإدارة المستخدمين والمفاتيح والنسخ الاحتياطية | تسجيل الدخول باسم مستخدم وكلمة مرور، أو بمفتاح خدمة | -| سطر الأوامر `arkvoryctl` | `/api/v1` | نصوص CI البرمجية، والرفع والتنزيل القابلان للاستئناف، والملفات حسب المسار، والترقية، والنسخ الاحتياطية | مفتاح من ملف أو من متغير بيئة (يُرسل بصيغة Bearer) | -| TypeScript SDK | `/api/v1` | أدواتك الخاصة بـ TypeScript أو JavaScript، في Node.js أو في المتصفح | مفتاح من دالة استدعاء (callback) (يُرسل بصيغة Bearer) | +| سطر الأوامر `arkvoryctl` | `/api/v1` | نصوص CI البرمجية، والرفع والتنزيل القابلان للاستئناف، والملفات حسب المسار، والترقية، والنسخ الاحتياطية | مفتاح من ملف أو من متغير بيئة (يُرسل بصيغة Bearer) | +| TypeScript SDK | `/api/v1` | أدواتك الخاصة بـ TypeScript أو JavaScript، في Node.js أو في المتصفح | مفتاح من دالة استدعاء (callback) (يُرسل بصيغة Bearer) | | REST API | `/api/v1/...` | التكاملات بأي لغة | `Authorization: Bearer ` فقط | -| سجل الحاويات (OCI) | `/v2/` | Docker وPodman وBuildx وcontainerd ومخططات Helm ومُخرَجات ORAS | Basic مع المفتاح ككلمة مرور (`docker login`)، أو Bearer | +| سجل الحاويات (OCI) | `/v2/` | Docker وPodman وBuildx وcontainerd ومخططات Helm ومُخرَجات ORAS | Basic مع المفتاح ككلمة مرور (`docker login`)، أو Bearer | | Git LFS | `/lfs/` | الملفات الكبيرة لمستودع git، وقفل الملفات لـ Unity وUnreal | Basic مع المفتاح ككلمة مرور (git credential helper)، أو Bearer | | سجل npm | `/npm//` | السجلات محددة النطاق (scoped registries) في Unity Package Manager، و`npm publish` و`npm install` | Bearer (`_authToken` في `.npmrc`، و`token` في `.upmconfig.toml`)، أو Basic `_auth` | | الملفات الخام حسب المسار | `/api/v1/repositories//raw/` | طلب واحد بـ `curl -T` أو PowerShell | `Authorization: Bearer ` فقط | -| Webhook | عنوان URL للمستقبِل لديك | بدء نشر أو مهمة عندما يتغير مستودع | توقيع HMAC لكل طلب | +| Webhook | عنوان URL للمستقبِل لديك | بدء نشر أو مهمة عندما يتغير مستودع | توقيع HMAC لكل طلب | تتبع المسارات تحت `/v2` و`/lfs` و`/npm` مواصفات بروتوكولاتها. وهي ليست جزءًا من وثيقة OpenAPI الخاصة بـ `/api/v1`، وتبلّغ عن الأخطاء بالصيغة التي يتوقعها عملاؤها. @@ -28,13 +28,13 @@ title: العملاء والبروتوكولات يحتاج كل طلب إلى بيانات اعتماد، عدا فحوص السلامة العامة. ويقبل Arkvory الأنواع التالية: -| النوع | يبدو هكذا | مصدره | الاستخدام المعتاد | -| ------------- | ---------------------- | ---------------------------------------------------------------------------------------------------------- | ----------------------------------------- | +| النوع | يبدو هكذا | مصدره | الاستخدام المعتاد | +| ------------- | ---------------------- | -------------------------------------------------------------------------------------------------------- | ----------------------------------------- | | رمز وصول شخصي | `pat_...` | ينشئه مستخدم في وحدة التحكم. النطاق `read` أو `read-write`. ينتهي (بعد 90 يومًا افتراضيًا، وبحد أقصى 365). | المطورون: Unity وgit وDocker على محطة عمل | -| مفتاح خدمة | `arkvory_...` | يصدره مسؤول لحساب خدمة، بإجراءات محددة لكل مستودع | CI/CD ووكلاء النشر وخوادم البناء | -| مفتاح ملف | أي سر | ملف مفاتيح الخادم (`ARKVORY_KEYS_FILE`)، مع `read` أو `write` لكل مستودع؛ ويدير مفتاح المالك أيضًا | مالك التثبيت والتكاملات القديمة | -| جلسة | `dps_...` | تسجيل الدخول إلى وحدة التحكم؛ صالحة 12 ساعة | العمل التفاعلي في وحدة التحكم | -| رابط تنزيل | عنوان URL مع `?token=` | يُنشأ لمُخرَج واحد؛ من 60 ثانية إلى 24 ساعة | تسليم ملف واحد لشخص لا يملك مفتاحًا | +| مفتاح خدمة | `arkvory_...` | يصدره مسؤول لحساب خدمة، بإجراءات محددة لكل مستودع | CI/CD ووكلاء النشر وخوادم البناء | +| مفتاح ملف | أي سر | ملف مفاتيح الخادم (`ARKVORY_KEYS_FILE`)، مع `read` أو `write` لكل مستودع؛ ويدير مفتاح المالك أيضًا | مالك التثبيت والتكاملات القديمة | +| جلسة | `dps_...` | تسجيل الدخول إلى وحدة التحكم؛ صالحة 12 ساعة | العمل التفاعلي في وحدة التحكم | +| رابط تنزيل | عنوان URL مع `?token=` | يُنشأ لمُخرَج واحد؛ من 60 ثانية إلى 24 ساعة | تسليم ملف واحد لشخص لا يملك مفتاحًا | تختلف البروتوكولات فقط في طريقة إرسال المفتاح: @@ -48,7 +48,7 @@ title: العملاء والبروتوكولات | المهمة | الطريقة الموصى بها | | ------------------------------------------------------------------- | -------------------------------------------------------------------- | -| رفع مُخرَج بناء من CI واستئنافه بعد انقطاع الشبكة | [`arkvoryctl upload`](./cli) أو [`arkvoryctl put`](./cli) | +| رفع مُخرَج بناء من CI واستئنافه بعد انقطاع الشبكة | [`arkvoryctl upload`](./cli) أو [`arkvoryctl put`](./cli) | | نشر حزمة UPack من CI | [`arkvoryctl packages publish`](./cli) | | نشر «أحدث إصدار 1.4» على خادم | [`arkvoryctl packages download --range ^1.4 --stage release`](./cli) | | وضع ملف صغير أو متوسط حسب المسار من نص shell برمجي دون تثبيت أي شيء | [الملفات الخام](./raw-files) مع `curl -T` أو PowerShell | @@ -73,13 +73,13 @@ title: العملاء والبروتوكولات **بوابات القراءة والمرايا.** لا تقبل بوابة القراءة سوى `GET` و`HEAD`. والمرآة نسخة للقراءة فقط من مستودع على تثبيت آخر. -| الطريقة | على بوابة قراءة | على مرآة | -| ------------------- | -------------------------------- | ------------------------------------------------------- | +| الطريقة | على بوابة قراءة | على مرآة | +| ------------------- | -------------------------------- | ------------------------------------------------------ | | `/api/v1` وCLI وSDK | قراءة فقط | قراءة؛ وتُرفض التغييرات (`409 mirror_read_only`) | | سجل الحاويات | السحب (pull) | السحب؛ ويُرفض الدفع (push) | | Git LFS | غير مدعوم (طلب الدفعة هو `POST`) | الاستنساخ (clone) والجلب (fetch)؛ ويُرفض الدفع والأقفال | | سجل npm | التثبيت والبحث | التثبيت والبحث؛ ويُرفض النشر | -| الملفات الخام | `GET` و`HEAD` | `GET` و`HEAD` | +| الملفات الخام | `GET` و`HEAD` | `GET` و`HEAD` | راجع [بوابات القراءة](../operate/read-gateways) و[المرايا](../operate/mirrors). diff --git a/wiki/ar/protocols/sdk.md b/wiki/ar/protocols/sdk.md index 682b60c5..59d1bd64 100644 --- a/wiki/ar/protocols/sdk.md +++ b/wiki/ar/protocols/sdk.md @@ -32,15 +32,15 @@ const releases = client.inRepository('releases'); - **دالة الرمز (token callback).** يستدعيها SDK مع كل طلب ولا يخزّن نتيجتها أبدًا. ويمكنك تدوير المفاتيح دون إنشاء عميل جديد. - **`inRepository(id)`** يعيد عميلًا مرتبطًا بمستودع واحد. وهو وسيلة راحة، لا حدًّا أمنيًا. -| الخيار | الافتراضي | المعنى | -| ------------------ | --------- | --------------------------------------------------------------------------------------------------------- | -| `signal` | لا شيء | يلغي كل طلبات هذا العميل | -| `requestTimeoutMs` | لا شيء | مهلة الطلب الذي ليس له signal خاص (من 1 إلى 3600000) | -| `maxAttempts` | 5 | محاولات طلب نقل واحد، بما فيها الأولى (من 1 إلى 10) | -| `maxRetries` | 20 | إعادات المحاولة المشتركة لعملية رفع أو تنزيل واحدة (من 0 إلى 100) | -| `attemptTimeoutMs` | 120000 | حد محاولة نقل واحدة (من 1 إلى 1800000) | -| `baseDelayMs` | 500 | أول تأخير للتراجع (backoff) (من 1 إلى 60000) | -| `maxDelayMs` | 60000 | أطول تأخير، بما فيه `Retry-After` | +| الخيار | الافتراضي | المعنى | +| ------------------ | --------- | ------------------------------------------------------------------------------------------------------ | +| `signal` | لا شيء | يلغي كل طلبات هذا العميل | +| `requestTimeoutMs` | لا شيء | مهلة الطلب الذي ليس له signal خاص (من 1 إلى 3600000) | +| `maxAttempts` | 5 | محاولات طلب نقل واحد، بما فيها الأولى (من 1 إلى 10) | +| `maxRetries` | 20 | إعادات المحاولة المشتركة لعملية رفع أو تنزيل واحدة (من 0 إلى 100) | +| `attemptTimeoutMs` | 120000 | حد محاولة نقل واحدة (من 1 إلى 1800000) | +| `baseDelayMs` | 500 | أول تأخير للتراجع (backoff) (من 1 إلى 60000) | +| `maxDelayMs` | 60000 | أطول تأخير، بما فيه `Retry-After` | | `onRequest` | لا شيء | يُستدعى مرة لكل طلب HTTP مع الطريقة والمسار والحالة والمدة ومعرّف الطلب. ولا يتلقى بيانات الاعتماد أبدًا. | لا تنطبق إعادة المحاولة التلقائية إلا على عمليات النقل: `create` والخطوات داخل `resume` و`downloadVerified`. وهي تعيد المحاولة عند أعطال الشبكة وأخطاء HTTP 408 و429 و502 و503 و504، مع تراجع أُسّي (exponential backoff)، ولا تعيدها قبل `Retry-After` أبدًا. أما بقية الاستدعاءات فتُنفَّذ مرة واحدة. والتغييرات المحمية بمراجعة لا تُكرَّر تلقائيًا أبدًا. @@ -177,7 +177,7 @@ try { | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ArkvoryHttpError` | أجاب الخادم بخطأ. الحقول: `status` و`code` و`reason` و`details` و`requestId` و`retryAfterMs` و`retryAfterSeconds` و`serverMessage`. يكون `code` هو `http_error` عندما يجيب وكيل (proxy) دون صيغة Arkvory. | | `ArkvoryNetworkError` | فشل الاتصال أو انتهت مهلته بعد كل إعادات المحاولة | -| `ArkvoryIntegrityError` | البايتات المنزَّلة لا تطابق المُخرَج | +| `ArkvoryIntegrityError` | البايتات المنزَّلة لا تطابق المُخرَج | | `ArkvoryClientError` | فشل محلي مع `code`: `invalid_argument` و`insecure_url` و`invalid_response` و`response_too_large` و`size_mismatch` و`file_changed` و`upload_cancelled` و`completion_failed` | قرّر بحسب `code` و`reason`، لا بنص الرسالة. وعالج الرموز غير المعروفة بحسب حالة HTTP. ولا يحتوي `Error.message` على نص من الخادم أبدًا. راجع [الأخطاء](../api/errors). diff --git a/wiki/ar/reference/environment.md b/wiki/ar/reference/environment.md index 4a95a9f1..a8bc9f92 100644 --- a/wiki/ar/reference/environment.md +++ b/wiki/ar/reference/environment.md @@ -40,71 +40,71 @@ Restart-Service Arkvoryapi, Arkvoryworker, Arkvorybackup ## الأساسيات {#core} -| المتغير | يقرؤه | الافتراضي | المعنى | -| --------------------------------- | ---------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `ARKVORY_DATABASE_URL` | API، العامل، الوكيل، الترحيل | مطلوب | عنوان اتصال PostgreSQL (`postgres://` أو `postgresql://`). استخدم قاعدة بيانات منفصلة لكل تثبيت. | -| `ARKVORY_DATA_DIR` | API، العامل، الوكيل | مطلوب | دليل التخزين المحلي: منطقة التجهيز (staging) والمحتوى وملف `storage-id`. لا تستخدم مشاركة شبكية. | -| `ARKVORY_HOST` | API | `127.0.0.1` | العنوان الذي يُستمع إليه. تكتب برامج التثبيت `127.0.0.1`؛ وفي Docker Compose يكون `0.0.0.0` داخل الحاوية، وينشر المنفذ على الحلقة المحلية للمضيف فقط. | -| `ARKVORY_PORT` | API | `8080` | منفذ TCP، من 1 إلى 65535. | -| `ARKVORY_WEB_DIR` | API | `apps/web/public` | دليل ملفات وحدة التحكم على الويب. يضبطه المشغّل على الإصدار الحالي عند كل بدء. | +| المتغير | يقرؤه | الافتراضي | المعنى | +| --------------------------------- | ---------------------------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `ARKVORY_DATABASE_URL` | API، العامل، الوكيل، الترحيل | مطلوب | عنوان اتصال PostgreSQL (`postgres://` أو `postgresql://`). استخدم قاعدة بيانات منفصلة لكل تثبيت. | +| `ARKVORY_DATA_DIR` | API، العامل، الوكيل | مطلوب | دليل التخزين المحلي: منطقة التجهيز (staging) والمحتوى وملف `storage-id`. لا تستخدم مشاركة شبكية. | +| `ARKVORY_HOST` | API | `127.0.0.1` | العنوان الذي يُستمع إليه. تكتب برامج التثبيت `127.0.0.1`؛ وفي Docker Compose يكون `0.0.0.0` داخل الحاوية، وينشر المنفذ على الحلقة المحلية للمضيف فقط. | +| `ARKVORY_PORT` | API | `8080` | منفذ TCP، من 1 إلى 65535. | +| `ARKVORY_WEB_DIR` | API | `apps/web/public` | دليل ملفات وحدة التحكم على الويب. يضبطه المشغّل على الإصدار الحالي عند كل بدء. | | `ARKVORY_DATABASE_POOL_SIZE` | API | `20` | حجم مجمّع استعلامات واجهة API، من 4 إلى 200. تستخدم الجلسات الطويلة مجمّعًا منفصلًا من 3 اتصالات. | | `ARKVORY_MODULES_FILE` | API، العامل، الوكيل | غير مضبوط | المسار المطلق لملف JSON يختار الوحدات المدمجة، مثل `{"format": 1, "modules": {"npm": {"enabled": false}}}`. لا يمكن إطفاء إلا `oci` و`lfs` و`npm`؛ أما `upack` و`raw` و`local-storage` فهي النواة. تضيف إعدادات `local-storage` [وحدات تخزين](../operate/storage#volumes). توقف وحدة أو حقل غير معروف بدء التشغيل. يجب أن تقرأ واجهة API وبوابات القراءة والعامل ووكيل النسخ الاحتياطي الملف نفسه: بوابة القراءة أو العامل بخطة مختلفة لا يكون جاهزًا. لا تعمل وحدة موقّعة مثبّتة إلا إذا فعّلها هذا الملف ([الوحدات](../operate/modules#load)). | -| `ARKVORY_MODULES_DIR` | API، العامل | يضبطه المشغّل | المسار المطلق لدليل `modules` في جذر التثبيت، حيث تجد الخدمات الوحدات الموقّعة المثبّتة. إذا لم يُضبط (Docker Compose) فلا تُحمّل أي وحدة موقّعة. | -| `ARKVORY_MODULE_REVOCATIONS_FILE` | API، العامل | يضبطه المشغّل | المسار المطلق لقائمة إلغاء الوحدات المحفوظة، `config/module-revocations.json` في جذر التثبيت. | +| `ARKVORY_MODULES_DIR` | API، العامل | يضبطه المشغّل | المسار المطلق لدليل `modules` في جذر التثبيت، حيث تجد الخدمات الوحدات الموقّعة المثبّتة. إذا لم يُضبط (Docker Compose) فلا تُحمّل أي وحدة موقّعة. | +| `ARKVORY_MODULE_REVOCATIONS_FILE` | API، العامل | يضبطه المشغّل | المسار المطلق لقائمة إلغاء الوحدات المحفوظة، `config/module-revocations.json` في جذر التثبيت. | ## التخزين والحدود {#storage-and-limits} -| المتغير | يقرؤه | الافتراضي | المعنى | -| --------------------------------- | ------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `ARKVORY_CAPACITY_BYTES` | API، العامل | 10 TiB | الحد الأعلى، بالبايت، لكل المحتوى المحجوز: المنشور وعمليات الرفع غير المكتملة والمحتوى الذي ينتظر التنظيف. وهو ليس فحصًا للقرص. ولا يقرؤه العامل إلا لنسخ المرايا. | +| المتغير | يقرؤه | الافتراضي | المعنى | +| --------------------------------- | ------------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `ARKVORY_CAPACITY_BYTES` | API، العامل | 10 TiB | الحد الأعلى، بالبايت، لكل المحتوى المحجوز: المنشور وعمليات الرفع غير المكتملة والمحتوى الذي ينتظر التنظيف. وهو ليس فحصًا للقرص. ولا يقرؤه العامل إلا لنسخ المرايا. | | `ARKVORY_STORAGE_RESERVE_BYTES` | API، العامل، الوكيل | `1073741824` | المساحة الحرة، بالبايت، التي لا تستخدمها عمليات الرفع أبدًا. وتُحفظ لقاعدة البيانات والسجلات والنظام. و`0` توقف الاحتياطي. | | `ARKVORY_STORAGE_RESERVE_INODES` | API، العامل | `100000` | عقد الفهرسة (inodes) الحرة التي لا تستخدمها عمليات الكتابة أبدًا على كل وحدة تخزين. وأنظمة الملفات التي لا تعدّ عقد الفهرسة، مثل NTFS، تتخطى هذا الفحص. و`0` توقفه. | -| `ARKVORY_REHOME_BYTES_PER_SECOND` | العامل | `0` (بلا حد) | سرعة النسخ، بالبايت في الثانية، لعمليات [النقل بين وحدات التخزين](../operate/storage#rehome). | -| `ARKVORY_MAX_OBJECT_BYTES` | API | نحو 10 TiB | أكبر كائن، بالبايت. أعلى قيمة مسموحة هي 10 000 جزء بحجم 1 GiB. اضبط قيمة أقل لتحديد حجم الملف. | +| `ARKVORY_REHOME_BYTES_PER_SECOND` | العامل | `0` (بلا حد) | سرعة النسخ، بالبايت في الثانية، لعمليات [النقل بين وحدات التخزين](../operate/storage#rehome). | +| `ARKVORY_MAX_OBJECT_BYTES` | API | نحو 10 TiB | أكبر كائن، بالبايت. أعلى قيمة مسموحة هي 10 000 جزء بحجم 1 GiB. اضبط قيمة أقل لتحديد حجم الملف. | ## عمليات النقل وعرض النطاق {#transfers-and-bandwidth} تنتمي هذه الحدود إلى عملية API واحدة. المعدلات بالبايت في الثانية: `0` تعني بلا حد، وأي قيمة أخرى يجب أن تكون من 65 536 إلى 1 TiB. -| المتغير | يقرؤه | الافتراضي | المعنى | -| ------------------------------------------------- | ----- | --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `ARKVORY_MAX_UPLOADS` | API | `8` | عمليات الرفع التي تعمل في الوقت نفسه، من 1 إلى 32. | -| `ARKVORY_MAX_DOWNLOADS` | API | `16` | عمليات التنزيل التي تعمل في الوقت نفسه، من 1 إلى 256. | -| `ARKVORY_MAX_UPLOADS_PER_PRINCIPAL` | API | `4` | عمليات رفع حساب أو مفتاح واحد في الوقت نفسه، حتى حد الرفع الإجمالي. | -| `ARKVORY_MAX_DOWNLOADS_PER_PRINCIPAL` | API | `4` | عمليات تنزيل حساب أو مفتاح واحد في الوقت نفسه، حتى حد التنزيل الإجمالي. | +| المتغير | يقرؤه | الافتراضي | المعنى | +| ------------------------------------------------- | ----- | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `ARKVORY_MAX_UPLOADS` | API | `8` | عمليات الرفع التي تعمل في الوقت نفسه، من 1 إلى 32. | +| `ARKVORY_MAX_DOWNLOADS` | API | `16` | عمليات التنزيل التي تعمل في الوقت نفسه، من 1 إلى 256. | +| `ARKVORY_MAX_UPLOADS_PER_PRINCIPAL` | API | `4` | عمليات رفع حساب أو مفتاح واحد في الوقت نفسه، حتى حد الرفع الإجمالي. | +| `ARKVORY_MAX_DOWNLOADS_PER_PRINCIPAL` | API | `4` | عمليات تنزيل حساب أو مفتاح واحد في الوقت نفسه، حتى حد التنزيل الإجمالي. | | `ARKVORY_DOWNLOAD_STRATEGY` | API | `ordered` | كيف يرتّب طابور التنزيل عمليات التنزيل الكاملة للكائنات الأكبر من `ARKVORY_DOWNLOAD_SESSION_MIN_BYTES`: `ordered` (فئات أولوية، والحسابات والمفاتيح بالتناوب)، أو `smallest-first` (الكائنات الصغيرة أولًا)، أو `shared` (بلا طابور: يُقبل كل طلب وحده). الافتراضي في بوابات القراءة `shared`. | -| `ARKVORY_MAX_DOWNLOAD_SESSIONS` | API | `ARKVORY_MAX_DOWNLOADS` | عمليات التنزيل التي تشغل مكانًا في الوقت نفسه، من 1 إلى 1024. | -| `ARKVORY_DOWNLOAD_RESERVE` | API | `1` | أماكن محجوزة للأشخاص (جلسات وحدة التحكم والرموز الشخصية) أثناء التحديث الجماعي. الافتراضي `0` إذا كانت الأماكن أقل من أربعة. | -| `ARKVORY_DOWNLOAD_WEIGHTS` | API | `interactive=8,release=4,bulk=2,background=1` | حصة الأماكن الشاغرة لكل فئة. اذكر الفئات التي تغيّرها فقط. | -| `ARKVORY_DOWNLOAD_SESSION_MIN_BYTES` | API | `16777216` | الكائنات حتى هذا الحجم لا تدخل الطابور وتُقبل لكل طلب. | -| `ARKVORY_DOWNLOAD_IDLE_SECONDS` | API | `30` | التوقف بين النطاقات لمدة أطول من هذه يحرّر المكان. يحتفظ التنزيل بدوره عشر دقائق. | -| `ARKVORY_DOWNLOAD_AGING_MINUTES` | API | `15` | كل انتظار بهذه المدة يرفع التنزيل فئة واحدة حتى `release` كحد أقصى. القيمة `0` توقف التقادم. | -| `ARKVORY_DOWNLOAD_PREEMPT` | API | `true` | عملاء بروتوكول الطابور (SDK و`arkvoryctl`) يتنازلون عن مكانهم عند حد نطاق لفئة أعلى أو لمفتاح دون حصته، بعد أن يشغلوه دقيقة. | -| `ARKVORY_DOWNLOAD_RANGES_PER_SESSION` | API | `4` | الطلبات المتزامنة لتنزيل واحد: نطاقات متوازية، أو عملاء خلف عنوان واحد. | -| `ARKVORY_DOWNLOAD_QUEUE_LIMIT` | API | `65536` | إجمالي التنزيلات النشطة والمنتظرة. بعد ذلك يُطلب من العميل العودة بعد دقيقة. | -| `ARKVORY_DOWNLOAD_QUEUE_PER_PRINCIPAL` | API | `4096` | إجمالي تنزيلات حساب أو مفتاح أو رابط واحد. | -| `ARKVORY_DOWNLOAD_HOLD_SECONDS` | API | `20` | مدة احتجاز طلب أداة خارج بروتوكول الطابور (docker وnpm وcurl والمتصفح) حتى يحين دورها قبل الرد 503. الافتراضي: `ARKVORY_TRANSFER_QUEUE_TIMEOUT_MS`. القيمة `0` ترد فورًا. | -| `ARKVORY_SITE_NAME` | API | — | اسم هذا التثبيت في صفحة المواقع لدى التثبيتات الأخرى، من 1 إلى 63 حرفًا. | -| `ARKVORY_FLEET_KEY_FILE` | API | `fleet.key` | المفتاح الذي يختم مفاتيح المواقع التي يديرها هذا التثبيت. تنشئه عملية الكتابة عند أول تشغيل؛ احمه كما تحمي دليل البيانات. ليس في قاعدة البيانات ولا في النسخ الاحتياطية. | -| `ARKVORY_TRANSFER_QUEUE_LIMIT` | API | `64` | عمليات النقل التي يجوز أن تنتظر فتحة شاغرة، من 1 إلى 1024. | -| `ARKVORY_TRANSFER_QUEUE_PER_PRINCIPAL` | API | `8` | عمليات النقل المنتظرة لحساب أو مفتاح واحد، حتى حد القائمة. | -| `ARKVORY_TRANSFER_QUEUE_TIMEOUT_MS` | API | `20000` | المدة التي يجوز أن ينتظرها النقل في القائمة، من 1 إلى 120 000 مللي ثانية. | +| `ARKVORY_MAX_DOWNLOAD_SESSIONS` | API | `ARKVORY_MAX_DOWNLOADS` | عمليات التنزيل التي تشغل مكانًا في الوقت نفسه، من 1 إلى 1024. | +| `ARKVORY_DOWNLOAD_RESERVE` | API | `1` | أماكن محجوزة للأشخاص (جلسات وحدة التحكم والرموز الشخصية) أثناء التحديث الجماعي. الافتراضي `0` إذا كانت الأماكن أقل من أربعة. | +| `ARKVORY_DOWNLOAD_WEIGHTS` | API | `interactive=8,release=4,bulk=2,background=1` | حصة الأماكن الشاغرة لكل فئة. اذكر الفئات التي تغيّرها فقط. | +| `ARKVORY_DOWNLOAD_SESSION_MIN_BYTES` | API | `16777216` | الكائنات حتى هذا الحجم لا تدخل الطابور وتُقبل لكل طلب. | +| `ARKVORY_DOWNLOAD_IDLE_SECONDS` | API | `30` | التوقف بين النطاقات لمدة أطول من هذه يحرّر المكان. يحتفظ التنزيل بدوره عشر دقائق. | +| `ARKVORY_DOWNLOAD_AGING_MINUTES` | API | `15` | كل انتظار بهذه المدة يرفع التنزيل فئة واحدة حتى `release` كحد أقصى. القيمة `0` توقف التقادم. | +| `ARKVORY_DOWNLOAD_PREEMPT` | API | `true` | عملاء بروتوكول الطابور (SDK و`arkvoryctl`) يتنازلون عن مكانهم عند حد نطاق لفئة أعلى أو لمفتاح دون حصته، بعد أن يشغلوه دقيقة. | +| `ARKVORY_DOWNLOAD_RANGES_PER_SESSION` | API | `4` | الطلبات المتزامنة لتنزيل واحد: نطاقات متوازية، أو عملاء خلف عنوان واحد. | +| `ARKVORY_DOWNLOAD_QUEUE_LIMIT` | API | `65536` | إجمالي التنزيلات النشطة والمنتظرة. بعد ذلك يُطلب من العميل العودة بعد دقيقة. | +| `ARKVORY_DOWNLOAD_QUEUE_PER_PRINCIPAL` | API | `4096` | إجمالي تنزيلات حساب أو مفتاح أو رابط واحد. | +| `ARKVORY_DOWNLOAD_HOLD_SECONDS` | API | `20` | مدة احتجاز طلب أداة خارج بروتوكول الطابور (docker وnpm وcurl والمتصفح) حتى يحين دورها قبل الرد 503. الافتراضي: `ARKVORY_TRANSFER_QUEUE_TIMEOUT_MS`. القيمة `0` ترد فورًا. | +| `ARKVORY_SITE_NAME` | API | — | اسم هذا التثبيت في صفحة المواقع لدى التثبيتات الأخرى، من 1 إلى 63 حرفًا. | +| `ARKVORY_FLEET_KEY_FILE` | API | `fleet.key` | المفتاح الذي يختم مفاتيح المواقع التي يديرها هذا التثبيت. تنشئه عملية الكتابة عند أول تشغيل؛ احمه كما تحمي دليل البيانات. ليس في قاعدة البيانات ولا في النسخ الاحتياطية. | +| `ARKVORY_TRANSFER_QUEUE_LIMIT` | API | `64` | عمليات النقل التي يجوز أن تنتظر فتحة شاغرة، من 1 إلى 1024. | +| `ARKVORY_TRANSFER_QUEUE_PER_PRINCIPAL` | API | `8` | عمليات النقل المنتظرة لحساب أو مفتاح واحد، حتى حد القائمة. | +| `ARKVORY_TRANSFER_QUEUE_TIMEOUT_MS` | API | `20000` | المدة التي يجوز أن ينتظرها النقل في القائمة، من 1 إلى 120 000 مللي ثانية. | | `ARKVORY_MAX_REQUESTS` | API | `128` | الطلبات الموثَّقة في الوقت نفسه، من 1 إلى 4096. يجب أن يكون أكبر من مجموع عمليات الرفع والتنزيل. وعندما لا يُضبط وتكون حدود النقل مرتفعة، تكون القيمة الافتراضية مجموع عمليات الرفع والتنزيل زائد 64. | -| `ARKVORY_UPLOAD_BYTES_PER_SECOND` | API | `0` | معدل الرفع الإجمالي للعملية. | -| `ARKVORY_DOWNLOAD_BYTES_PER_SECOND` | API | `0` | معدل التنزيل الإجمالي للعملية. | -| `ARKVORY_UPLOAD_BYTES_PER_SECOND_PER_PRINCIPAL` | API | `0` | معدل رفع حساب أو مفتاح واحد، عبر كل اتصالاته. | -| `ARKVORY_DOWNLOAD_BYTES_PER_SECOND_PER_PRINCIPAL` | API | `0` | معدل تنزيل حساب أو مفتاح واحد، عبر كل اتصالاته. | -| `ARKVORY_UPLOAD_IDLE_TIMEOUT_MS` | API | `30000` | يُوقَف طلب الرفع الذي لا يرسل بيانات خلال هذه المدة، من 1 إلى 1 800 000 مللي ثانية. | -| `ARKVORY_UPLOAD_DEADLINE_MS` | API | `1800000` | أطول مدة لطلب رفع واحد، من 1 إلى 1 800 000 مللي ثانية. ولا يمكن أن تكون أقصر من مهلة الخمول. | +| `ARKVORY_UPLOAD_BYTES_PER_SECOND` | API | `0` | معدل الرفع الإجمالي للعملية. | +| `ARKVORY_DOWNLOAD_BYTES_PER_SECOND` | API | `0` | معدل التنزيل الإجمالي للعملية. | +| `ARKVORY_UPLOAD_BYTES_PER_SECOND_PER_PRINCIPAL` | API | `0` | معدل رفع حساب أو مفتاح واحد، عبر كل اتصالاته. | +| `ARKVORY_DOWNLOAD_BYTES_PER_SECOND_PER_PRINCIPAL` | API | `0` | معدل تنزيل حساب أو مفتاح واحد، عبر كل اتصالاته. | +| `ARKVORY_UPLOAD_IDLE_TIMEOUT_MS` | API | `30000` | يُوقَف طلب الرفع الذي لا يرسل بيانات خلال هذه المدة، من 1 إلى 1 800 000 مللي ثانية. | +| `ARKVORY_UPLOAD_DEADLINE_MS` | API | `1800000` | أطول مدة لطلب رفع واحد، من 1 إلى 1 800 000 مللي ثانية. ولا يمكن أن تكون أقصر من مهلة الخمول. | ## الشبكة وHTTPS والمتصفحات {#network-https-and-browsers} -| المتغير | يقرؤه | الافتراضي | المعنى | -| ---------------------------- | ----- | --------- | ----------------------------------------------------------------------------------------------------------------------- | -| `ARKVORY_TLS_CERT_FILE` | API | غير مضبوط | شهادة PEM (مع سلسلتها) لـ HTTPS المضمَّن. اضبطها مع ملف المفتاح. | -| `ARKVORY_TLS_KEY_FILE` | API | غير مضبوط | مفتاح خاص بصيغة PEM دون كلمة مرور. | -| `ARKVORY_TLS_MIN_VERSION` | API | `TLSv1.2` | `TLSv1.2` أو `TLSv1.3`. | -| `ARKVORY_TLS_RELOAD_SECONDS` | API | `300` | الفاصل بين قراءتين لملفات الشهادة المجدَّدة: من 30 إلى 86 400 ثانية، أو `0` لقراءتها عند البدء فقط. | +| المتغير | يقرؤه | الافتراضي | المعنى | +| ---------------------------- | ----- | --------- | ---------------------------------------------------------------------------------------------------------------------- | +| `ARKVORY_TLS_CERT_FILE` | API | غير مضبوط | شهادة PEM (مع سلسلتها) لـ HTTPS المضمَّن. اضبطها مع ملف المفتاح. | +| `ARKVORY_TLS_KEY_FILE` | API | غير مضبوط | مفتاح خاص بصيغة PEM دون كلمة مرور. | +| `ARKVORY_TLS_MIN_VERSION` | API | `TLSv1.2` | `TLSv1.2` أو `TLSv1.3`. | +| `ARKVORY_TLS_RELOAD_SECONDS` | API | `300` | الفاصل بين قراءتين لملفات الشهادة المجدَّدة: من 30 إلى 86 400 ثانية، أو `0` لقراءتها عند البدء فقط. | | `ARKVORY_CORS_ORIGINS` | API | فارغ | قائمة مفصولة بفواصل تضم حتى 16 أصلًا (origin) للمتصفح، لوحدة تحكم على عنوان آخر. HTTPS فقط، أو HTTP على الحلقة المحلية. | | `ARKVORY_TRUSTED_PROXIES` | API | فارغ | حتى 32 عنوانًا لوكلاء عكسيين (IP أو CIDR). وهذه العناوين وحدها يجوز لها ضبط عنوان العميل عبر `X-Forwarded-For`. | @@ -112,31 +112,31 @@ HTTPS المضمَّن مخصص للتثبيتات الأصلية. ومع Docker ## الهوية والمفاتيح {#identity-and-keys} -| المتغير | يقرؤه | الافتراضي | المعنى | -| ---------------------------- | ----------- | --------- | -------------------------------------------------------------------------------------------------------------------- | +| المتغير | يقرؤه | الافتراضي | المعنى | +| ---------------------------- | ----------- | --------- | ----------------------------------------------------------------------------------------------------------------- | | `ARKVORY_KEYS_FILE` | API، العامل | مطلوب | ملف JSON فيه مفاتيح الملفات، مثل مفتاح الاسترداد ومفتاح فحص السلامة. يخزّن تجزئات SHA-256، ولا يخزّن المفاتيح أبدًا. | -| `ARKVORY_ALLOW_REGISTRATION` | API | متوقف | `true` يتيح للناس إنشاء حساباتهم بأنفسهم في صفحة تسجيل الدخول. وأي قيمة أخرى تُبقيه متوقفًا. | +| `ARKVORY_ALLOW_REGISTRATION` | API | متوقف | `true` يتيح للناس إنشاء حساباتهم بأنفسهم في صفحة تسجيل الدخول. وأي قيمة أخرى تُبقيه متوقفًا. | ## النسخ الاحتياطية {#backups} -| المتغير | يقرؤه | الافتراضي | المعنى | -| --------------------------------- | ------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | -| `ARKVORY_BACKUP_VAULT` | الوكيل | غير مضبوط | دليل مخزن مهيَّأ. بدونه يعمل الوكيل ويبلّغ بأنه لا يوجد مخزن مضبوط. ويكتبه `arkvory configure --backup-vault`. | +| المتغير | يقرؤه | الافتراضي | المعنى | +| --------------------------------- | ------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | +| `ARKVORY_BACKUP_VAULT` | الوكيل | غير مضبوط | دليل مخزن مهيَّأ. بدونه يعمل الوكيل ويبلّغ بأنه لا يوجد مخزن مضبوط. ويكتبه `arkvory configure --backup-vault`. | | `ARKVORY_BACKUP_VAULT_KEY_FILE` | الوكيل | غير مضبوط | ملف يحوي مفتاح الخدمة لـ vault مشفّر (`AK1-…`)، أو حزمة استرداد. تقبله الأوامر أيضًا بصيغة `--key-file`. يكتبه `arkvory configure --vault-key-file`. | -| `ARKVORY_BACKUP_BYTES_PER_SECOND` | الوكيل | بلا حد | حد معدل النسخ في النسخة الاحتياطية، 65 536 على الأقل. | -| `ARKVORY_BACKUP_POLL_SECONDS` | الوكيل | `15` | الفاصل الذي يتحقق فيه الوكيل من مهام النسخ الاحتياطي الجديدة، من 1 إلى 3600 ثانية. | +| `ARKVORY_BACKUP_BYTES_PER_SECOND` | الوكيل | بلا حد | حد معدل النسخ في النسخة الاحتياطية، 65 536 على الأقل. | +| `ARKVORY_BACKUP_POLL_SECONDS` | الوكيل | `15` | الفاصل الذي يتحقق فيه الوكيل من مهام النسخ الاحتياطي الجديدة، من 1 إلى 3600 ثانية. | | `ARKVORY_BACKUP_LEASE_SECONDS` | الوكيل | `60` | مدة الحجز (lease) التي تمنع وكيلًا ثانيًا من العمل في الوقت نفسه، من 2 إلى 3600 ثانية. | -| `ARKVORY_BACKUP_SNAPSHOT_SECONDS` | الوكيل | `1800` | الحد الزمني لجزء لقطة قاعدة البيانات في النسخة الاحتياطية، من 60 إلى 86 400 ثانية. | -| `ARKVORY_BACKUP_BARRIER_SECONDS` | الوكيل | `30` | المدة التي تنتظر فيها النسخة الاحتياطية خطوة تنظيف جارية، من 1 إلى 600 ثانية. | -| `ARKVORY_RESTORE_DATABASE_URL` | أمر الاستعادة | غير مضبوط | قاعدة البيانات الهدف للاستعادة. وهو أكثر أمانًا من `--database-url`، لأن المستخدمين الآخرين لا يرونه في قائمة العمليات. | +| `ARKVORY_BACKUP_SNAPSHOT_SECONDS` | الوكيل | `1800` | الحد الزمني لجزء لقطة قاعدة البيانات في النسخة الاحتياطية، من 60 إلى 86 400 ثانية. | +| `ARKVORY_BACKUP_BARRIER_SECONDS` | الوكيل | `30` | المدة التي تنتظر فيها النسخة الاحتياطية خطوة تنظيف جارية، من 1 إلى 600 ثانية. | +| `ARKVORY_RESTORE_DATABASE_URL` | أمر الاستعادة | غير مضبوط | قاعدة البيانات الهدف للاستعادة. وهو أكثر أمانًا من `--database-url`، لأن المستخدمين الآخرين لا يرونه في قائمة العمليات. | راجع [النسخ الاحتياطية](../operate/backups). ## المرايا {#mirrors} -| المتغير | يقرؤه | الافتراضي | المعنى | -| ------------------------- | ----------- | --------- | ---------------------------------------------------------------------------------------- | -| `ARKVORY_MIRRORS_FILE` | API، العامل | غير مضبوط | ملف JSON يسرد المستودعات المنسوخة بمرآة (حتى 64). ويكتبه `arkvory configure --mirror`. | +| المتغير | يقرؤه | الافتراضي | المعنى | +| ------------------------- | ----------- | --------- | -------------------------------------------------------------------------------------- | +| `ARKVORY_MIRRORS_FILE` | API، العامل | غير مضبوط | ملف JSON يسرد المستودعات المنسوخة بمرآة (حتى 64). ويكتبه `arkvory configure --mirror`. | | `ARKVORY_MIRRORS_CA_FILE` | العامل | غير مضبوط | مسار مطلق إلى ملف PEM يضم جهات إصدار شهادات إضافية لخوادم المصدر. ويُتحقق من TLS دائمًا. | راجع [المرايا](../operate/mirrors). @@ -145,36 +145,36 @@ HTTPS المضمَّن مخصص للتثبيتات الأصلية. ومع Docker | المتغير | يقرؤه | الافتراضي | المعنى | | -------------------------------- | ------ | --------- | ------------------------------------------------------------------------------------------------------------- | -| `ARKVORY_WEBHOOKS_FILE` | العامل | غير مضبوط | ملف JSON يسرد اشتراكات Webhook (حتى 16). من دونه لا تُرسَل أي Webhook. | +| `ARKVORY_WEBHOOKS_FILE` | العامل | غير مضبوط | ملف JSON يسرد اشتراكات Webhook (حتى 16). من دونه لا تُرسَل أي Webhook. | | `ARKVORY_WEBHOOKS_ALLOW_PRIVATE` | العامل | غير مضبوط | شبكات بصيغة CIDR مفصولة بفواصل (حتى 32) يجوز أن تستقبل Webhook إضافة إلى العناوين العامة، مثل `10.20.0.0/16`. | -| `ARKVORY_WEBHOOKS_CA_FILE` | العامل | غير مضبوط | المسار المطلق لملف PEM يحوي سلطات شهادات إضافية للمستقبِلين. يُتحقَّق من TLS دائمًا. | +| `ARKVORY_WEBHOOKS_CA_FILE` | العامل | غير مضبوط | المسار المطلق لملف PEM يحوي سلطات شهادات إضافية للمستقبِلين. يُتحقَّق من TLS دائمًا. | راجع [Webhook](../protocols/webhooks). ## الأحداث {#events} -| المتغير | يقرؤه | الافتراضي | المعنى | -| -------------------------------- | ------ | --------- | -------------------------------------------------------------------------------------------------------------------------- | +| المتغير | يقرؤه | الافتراضي | المعنى | +| -------------------------------- | ------ | --------- | ------------------------------------------------------------------------------------------------------------------------- | | `ARKVORY_EVENTS_RETENTION_HOURS` | العامل | 168 | عدد الساعات التي تحتفظ فيها تغذية الأحداث بالحدث، من 1 إلى 8760. تُحذف الأحداث الأقدم، ويتلقى المؤشر السابق لها الرمز 410. | -| `ARKVORY_EVENTS_MAX_ROWS` | العامل | 5000000 | أقصى عدد من الأحداث تحتفظ به التغذية، من 1000 إلى 1000000000. يُحذف الأقدم أولًا. | +| `ARKVORY_EVENTS_MAX_ROWS` | العامل | 5000000 | أقصى عدد من الأحداث تحتفظ به التغذية، من 1000 إلى 1000000000. يُحذف الأقدم أولًا. | راجع [الأحداث](../protocols/events). ## عنقود عالي التوفر {#cluster} -| المتغير | يقرؤه | الافتراضي | المعنى | -| ------------------------ | ----- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `ARKVORY_REPLICA_SOCKET` | API | غير معيّن | مقبس خدمة `arkvory-replica`. يعيّنه `arkvory configure --cluster`. عند تعيينه لا تحصل الكتابة على 2xx إلا عندما تكتمل النسخ المطلوبة. إن لم يُعيَّن فهو خادم مستقل. | +| المتغير | يقرؤه | الافتراضي | المعنى | +| ------------------------ | ----- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `ARKVORY_REPLICA_SOCKET` | API | غير معيّن | مقبس خدمة `arkvory-replica`. يعيّنه `arkvory configure --cluster`. عند تعيينه لا تحصل الكتابة على 2xx إلا عندما تكتمل النسخ المطلوبة. إن لم يُعيَّن فهو خادم مستقل. | راجع [High availability cluster](../operate/cluster). ## التحديثات والمركز (hub) {#updates-and-the-hub} -| المتغير | يقرؤه | الافتراضي | المعنى | -| ---------------------------- | ----- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| المتغير | يقرؤه | الافتراضي | المعنى | +| ---------------------------- | ----- | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ARKVORY_HUB_URL` | API | `https://hub.proanima.net` | عنوان مركز ProAnimaStudio، تستخدمه ملاحظات وحدة التحكم فقط (مركز التحديثات محفوظ في `config/hub.json` ويُغيَّر بالأمر `arkvory configure`). والقيمة الفارغة توقف الملاحظات. HTTPS فقط، أو HTTP على الحلقة المحلية. | -| `ARKVORY_HUB_PROJECT` | API | `arkvory` | اسم المشروع في المركز. | -| `ARKVORY_UPDATE_CONTROL_DIR` | API | غير مضبوط | الدليل الذي يشاركه API مع برنامج التحديث على المضيف. تضبطه برامج التثبيت. وبدونه لا تستطيع وحدة التحكم طلب التحديثات. | +| `ARKVORY_HUB_PROJECT` | API | `arkvory` | اسم المشروع في المركز. | +| `ARKVORY_UPDATE_CONTROL_DIR` | API | غير مضبوط | الدليل الذي يشاركه API مع برنامج التحديث على المضيف. تضبطه برامج التثبيت. وبدونه لا تستطيع وحدة التحكم طلب التحديثات. | راجع [التحديثات](../install/updates). @@ -183,7 +183,7 @@ HTTPS المضمَّن مخصص للتثبيتات الأصلية. ومع Docker | المتغير | يقرؤه | الافتراضي | المعنى | | -------------------------- | ------------------- | --------- | ---------------------------------------------------------------------------------------- | | `ARKVORY_LOG_LEVEL` | API، العامل، الوكيل | `info` | `debug` أو `info` أو `warning` أو `error`. | -| `ARKVORY_ACCESS_LOG` | API | `true` | `true` يكتب سطر JSON واحدًا لكل طلب HTTP؛ و`false` يوقفه. | +| `ARKVORY_ACCESS_LOG` | API | `true` | `true` يكتب سطر JSON واحدًا لكل طلب HTTP؛ و`false` يوقفه. | | `ARKVORY_DRAIN_TIMEOUT_MS` | API | `30000` | بعد إشارة الإيقاف، المدة المتاحة لانتهاء الطلبات الجارية، من 0 إلى 3 600 000 مللي ثانية. | ## بوابات القراءة {#read-gateways} @@ -200,21 +200,21 @@ HTTPS المضمَّن مخصص للتثبيتات الأصلية. ومع Docker ## المراقب الذاتي (Watchdog) {#watchdog} -| المتغير | يقرؤه | الافتراضي | المعنى | -| -------------------------- | ------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | +| المتغير | يقرؤه | الافتراضي | المعنى | +| -------------------------- | ------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | `ARKVORY_WATCHDOG_SECONDS` | API، العامل، الوكيل | `60` | العملية التي تبقى محجوبة هذه المدة تنهي نفسها، ويبدأها مدير الخدمات مرة أخرى. و`0` توقفه (لأجل مصحّح الأخطاء)؛ وإلا فالقيمة من 10 إلى 3600 ثانية. | راجع [الإصلاح الذاتي](../operate/self-healing). ## عميل سطر الأوامر {#command-line-client} -| المتغير | يقرؤه | الافتراضي | المعنى | -| --------------------- | ----- | --------------------------------------- | ------------------------------------------------------------ | +| المتغير | يقرؤه | الافتراضي | المعنى | +| --------------------- | ----- | --------------------------------------- | ----------------------------------------------------------- | | `ARKVORY_BASE_URL` | CLI | ملف التعريف، ثم `http://127.0.0.1:8080` | عنوان الخادم. وعند ضبطه يجب أن يأتي المفتاح أيضًا من البيئة. | -| `ARKVORY_TOKEN` | CLI | غير مضبوط | المفتاح نفسه. له الأولوية على ملف المفتاح. | -| `ARKVORY_TOKEN_FILE` | CLI | ملف المفتاح في ملف التعريف | مسار ملف يحتوي على المفتاح. | -| `ARKVORY_CLI_HOME` | CLI | `~/.config/arkvory` | دليل الملف `profiles.json`. | -| `ARKVORY_CLI_VERSION` | CLI | `development` | الإصدار الذي يطبعه `--version`. وتحتويه حزم الإصدار. | +| `ARKVORY_TOKEN` | CLI | غير مضبوط | المفتاح نفسه. له الأولوية على ملف المفتاح. | +| `ARKVORY_TOKEN_FILE` | CLI | ملف المفتاح في ملف التعريف | مسار ملف يحتوي على المفتاح. | +| `ARKVORY_CLI_HOME` | CLI | `~/.config/arkvory` | دليل الملف `profiles.json`. | +| `ARKVORY_CLI_VERSION` | CLI | `development` | الإصدار الذي يطبعه `--version`. وتحتويه حزم الإصدار. | راجع [عميل سطر الأوامر](../protocols/cli). @@ -222,22 +222,22 @@ HTTPS المضمَّن مخصص للتثبيتات الأصلية. ومع Docker يقرأ `install.sh` على Linux هذه المتغيرات. أما على Windows فيستخدم `install.ps1` معاملات مثل `-Root` و`-Artifact` بدلًا منها. -| المتغير | الافتراضي | المعنى | -| ------------------------- | ----------------------- | ----------------------------------------------------------------- | +| المتغير | الافتراضي | المعنى | +| ------------------------- | ----------------------- | --------------------------------------------------------------- | | `ARKVORY_INSTALL_ROOT` | `/opt/proanima-arkvory` | جذر التثبيت. لا تضع تثبيتًا أصليًا في دليل منزلي (home). | | `ARKVORY_ARTIFACT_DIR` | غير مضبوط | دليل إصدار مفكوك الضغط. يثبّته النص البرمجي بدلًا من تنزيل إصدار. | -| `ARKVORY_RELEASE_VERSION` | أحدث إصدار مستقر | الإصدار المستقر المحدد الذي يُثبَّت، مثل `1.2.3`. | +| `ARKVORY_RELEASE_VERSION` | أحدث إصدار مستقر | الإصدار المستقر المحدد الذي يُثبَّت، مثل `1.2.3`. | ## ما يضبطه برنامج التثبيت {#set-by-the-installer} يضبط برنامج التثبيت هذه المتغيرات لعملياته المساعدة. لا تضبطها بنفسك. -| المتغير | المعنى | -| ------------------------- | ---------------------------------------------------------------------------- | -| `ARKVORY_IMAGE` | صورة الحاوية للإصدار الحالي، في `config/compose.env`. | +| المتغير | المعنى | +| ------------------------- | --------------------------------------------------------------------------- | +| `ARKVORY_IMAGE` | صورة الحاوية للإصدار الحالي، في `config/compose.env`. | | `ARKVORY_SERVICE_WRAPPER` | مسار غلاف خدمة النسخ الاحتياطي في Windows، يُستخدم عندما تكون الخدمة متوقفة. | | `ARKVORY_PROTECT_ROOT` | جذر التثبيت الذي تُضبط قواعد الوصول إليه في Windows. | -| `ARKVORY_ENGINE_USER` | على Windows مع Docker Desktop، يمنح المستخدم الحالي حق الوصول إلى الجذر. | +| `ARKVORY_ENGINE_USER` | على Windows مع Docker Desktop، يمنح المستخدم الحالي حق الوصول إلى الجذر. | ## صفحات ذات صلة {#related-pages} diff --git a/wiki/ar/use/trees.md b/wiki/ar/use/trees.md index 04f1af5f..94bab509 100644 --- a/wiki/ar/use/trees.md +++ b/wiki/ar/use/trees.md @@ -15,12 +15,12 @@ description: انشر دليلًا بوصفه أرشيفًا واحدًا، وا arkvoryctl tree push ./Build/Game --name game-1.4.zip --label release ``` -| الخيار | المعنى | -| ---------------------- | ---------------------------------------------------------------------------- | +| الخيار | المعنى | +| ---------------------- | -------------------------------------------------------------------------- | | `--name NAME.zip` | اسم المُخرَج. الافتراضي: اسم المجلد مع `.zip`. يجب أن ينتهي الاسم بـ `.zip`. | | `--label TAG` | تسمية للمُخرَج | -| `--file METADATA.json` | التسميات وبيانات التعريف، كما في `upload` | -| `--compress` | ضغط الإدخالات (deflate). ودونه تُخزَّن الملفات كما هي. | +| `--file METADATA.json` | التسميات وبيانات التعريف، كما في `upload` | +| `--compress` | ضغط الإدخالات (deflate). ودونه تُخزَّن الملفات كما هي. | تعرض النتيجة `id` المُخرَج و`size` و`sha256` وعدد الملفات في `entries`. @@ -64,10 +64,10 @@ arkvoryctl tree repair 3b0c0b8e-6a4e-4f5f-9d3b-5a6c1c9b0f11 ./Game | `reason` | المعنى | | -------------------- | ------------------------------------------------- | -| `not_archive` | اسم المُخرَج لا ينتهي بـ `.zip` أو `.upack` | -| `invalid_archive` | الملف ليس أرشيف ZIP قابلًا للقراءة | +| `not_archive` | اسم المُخرَج لا ينتهي بـ `.zip` أو `.upack` | +| `invalid_archive` | الملف ليس أرشيف ZIP قابلًا للقراءة | | `unsafe_entry` | مسار يخرج من الأرشيف، أو إدخال هو رابط أو ملف خاص | -| `encrypted_entry` | إدخال مشفّر | +| `encrypted_entry` | إدخال مشفّر | | `duplicate_entry` | لإدخالين المسار نفسه، ولو عند تجاهل حالة الأحرف | | `unsupported_method` | إدخال يستخدم طريقة ضغط غير stored أو deflate | | `crc_mismatch` | بايتات إدخال لا تطابق مجموعه الاختباري في الأرشيف | diff --git a/wiki/hi/api/authentication.md b/wiki/hi/api/authentication.md index 64fc7e74..1120d1df 100644 --- a/wiki/hi/api/authentication.md +++ b/wiki/hi/api/authentication.md @@ -9,13 +9,13 @@ description: Arkvory HTTP API में प्रमाणीकरण के ## एक नज़र में क्रेडेंशियल {#credentials} -| क्रेडेंशियल | कैसा दिखता है | यह कैसे मिलता है | जीवनकाल | किसके लिए इस्तेमाल करें | -| --------------------- | ------------------- | ------------------------------------------------------ | ---------------------------------- | ------------------------------------------------------------- | -| कंसोल सत्र | `dps_…` | नाम और पासवर्ड से साइन इन करना | 12 घंटे | कंसोल में कोई व्यक्ति, या साइन इन करने वाली स्क्रिप्ट | -| व्यक्तिगत एक्सेस टोकन | `pat_…` | सत्र से इसे बनाना | डिफ़ॉल्ट रूप से 90 दिन, अधिकतम 365 | एक व्यक्ति की स्क्रिप्ट और टूल | -| सेवा कुंजी | `arkvory_…` | सेवा खाते के लिए जारी करना, फिर उसे सक्रिय करना | डिफ़ॉल्ट रूप से 90 दिन, अधिकतम 365 | CI/CD, डिप्लॉयमेंट एजेंट, अन्य सिस्टम | -| पुनर्प्राप्ति कुंजी | 64 हेक्साडेसिमल अंक | इंस्टॉलर इसे `config/bootstrap-token.txt` में लिखता है | समाप्त नहीं होती | स्वामी बनाना, सेवा खातों का प्रबंधन, एक्सेस पुनर्प्राप्त करना | -| डाउनलोड लिंक | `dtl_…` | एक आर्टिफ़ैक्ट के लिए इसे बनाना | 60 सेकंड से 24 घंटे | बिना कुंजी वाले किसी व्यक्ति को एक आर्टिफ़ैक्ट देना | +| क्रेडेंशियल | कैसा दिखता है | यह कैसे मिलता है | जीवनकाल | किसके लिए इस्तेमाल करें | +| ----------------- | --------------- | ------------------------------------------------ | ------------------------------ | -------------------------------------------------- | +| कंसोल सत्र | `dps_…` | नाम और पासवर्ड से साइन इन करना | 12 घंटे | कंसोल में कोई व्यक्ति, या साइन इन करने वाली स्क्रिप्ट | +| व्यक्तिगत एक्सेस टोकन | `pat_…` | सत्र से इसे बनाना | डिफ़ॉल्ट रूप से 90 दिन, अधिकतम 365 | एक व्यक्ति की स्क्रिप्ट और टूल | +| सेवा कुंजी | `arkvory_…` | सेवा खाते के लिए जारी करना, फिर उसे सक्रिय करना | डिफ़ॉल्ट रूप से 90 दिन, अधिकतम 365 | CI/CD, डिप्लॉयमेंट एजेंट, अन्य सिस्टम | +| पुनर्प्राप्ति कुंजी | 64 हेक्साडेसिमल अंक | इंस्टॉलर इसे `config/bootstrap-token.txt` में लिखता है | समाप्त नहीं होती | स्वामी बनाना, सेवा खातों का प्रबंधन, एक्सेस पुनर्प्राप्त करना | +| डाउनलोड लिंक | `dtl_…` | एक आर्टिफ़ैक्ट के लिए इसे बनाना | 60 सेकंड से 24 घंटे | बिना कुंजी वाले किसी व्यक्ति को एक आर्टिफ़ैक्ट देना | ऑटोमेशन के लिए सेवा कुंजी और किसी व्यक्ति के टूल के लिए व्यक्तिगत एक्सेस टोकन इस्तेमाल करें। रोज़मर्रा के काम के लिए पुनर्प्राप्ति कुंजी का उपयोग न करें। @@ -95,9 +95,9 @@ curl -fsS -X POST "$ARKVORY_URL/api/v1/auth/tokens" \ कंसोल में [[ui:connection]] कार्ड में [[ui:personalAccessTokens]] खोलें, [[ui:tokenName]] दर्ज करें, [[ui:tokenScope]] और [[ui:tokenExpiry]] चुनें, और [[ui:generateToken]] चुनें। -| फ़ील्ड | नियम | -| ----------- | -------------------------------------------------------------------------------------------------------------- | -| `name` | 1 से 64 अक्षर। | +| फ़ील्ड | नियम | +| ----------- | ----------------------------------------------------------------------------------------------------- | +| `name` | 1 से 64 अक्षर। | | `scope` | `read` या `read-write`। छोड़ने पर API `read-write` इस्तेमाल करता है; कंसोल पहले [[ui:tokenScopeRead]] देता है। | | `expiresAt` | भविष्य का RFC 3339 समय, अधिकतम 365 दिन दूर। डिफ़ॉल्ट 90 दिन है। बिना अंत वाले टोकन नहीं होते। | @@ -152,15 +152,15 @@ curl -fsS -X POST "$ARKVORY_URL/api/v1/auth/activate-key" -H "Authorization: Bea पुनर्प्राप्ति कुंजी प्रबंधन का कुछ हिस्सा किसी **ऑपरेटर** को सौंप सकती है: ऐसा सेवा खाता जिसकी कुंजी अन्य सेवा खातों का प्रबंधन कर सकती है। **प्रत्यायोजन** ऑपरेटर की कुंजी, लक्ष्य खाता, उस पर ऑपरेटर द्वारा इस्तेमाल होने योग्य **प्रबंधन कार्रवाइयाँ**, और एक **सीमा** बताता है, यानी वे रिपॉज़िटरी कार्रवाइयाँ जो वह दे सकता है। सात प्रबंधन कार्रवाइयाँ हैं: -| कार्रवाई | क्या अनुमति देती है | -| ------------------------ | ---------------------------------------------- | -| `service-account.read` | सूचियों में खाता देखना और उसका कार्ड पढ़ना। | -| `service-account.manage` | खाता चालू या बंद करना। | -| `policy.read` | खाते की नीति पढ़ना। | -| `policy.manage` | खाते की नीति बदलना। | -| `credential.read` | खाते की कुंजियाँ सूचीबद्ध करना और कुंजी पढ़ना। | +| कार्रवाई | क्या अनुमति देती है | +| ------------------------ | ----------------------------------------- | +| `service-account.read` | सूचियों में खाता देखना और उसका कार्ड पढ़ना। | +| `service-account.manage` | खाता चालू या बंद करना। | +| `policy.read` | खाते की नीति पढ़ना। | +| `policy.manage` | खाते की नीति बदलना। | +| `credential.read` | खाते की कुंजियाँ सूचीबद्ध करना और कुंजी पढ़ना। | | `credential.manage` | कुंजियाँ जारी करना, रोटेट करना और निरस्त करना। | -| `service-audit.read` | खाते की कुंजी इतिहास पढ़ना। | +| `service-audit.read` | खाते की कुंजी इतिहास पढ़ना। | नियम: ऑपरेटर की कुंजी वह होनी चाहिए जिसे पुनर्प्राप्ति कुंजी ने जारी किया हो; ऑपरेटर कभी अपना खाता प्रबंधित नहीं करता; वह अपनी सीमा से बाहर या खाते की नीति से परे कुछ नहीं दे सकता; उसकी जारी की गई कुंजी अपनी कुंजी से अधिक नहीं जी सकती; और प्रत्यायोजन समाप्त करने से पहले से सक्रिय किए गए कुंजी निरस्त नहीं होते। केवल पुनर्प्राप्ति कुंजी खाते बनाती है और प्रत्यायोजन सेट करती है (`PUT` और `DELETE /api/v1/api-keys/{id}/delegations/{accountId}`)। एक ऑपरेटर कुंजी में 64 तक प्रत्यायोजन हो सकते हैं। कंसोल में [[ui:delegations]] इस्तेमाल करें। अपने प्रत्यायोजन से बाहर कुछ चाहने वाले ऑपरेटर को ऐसे खाते के लिए `404` मिलता है जिसे वह प्रबंधित नहीं करता, या `403`। @@ -199,19 +199,19 @@ rm reset.json संदर्भ में हर ऑपरेशन की एक **Access** पंक्ति होती है। नियमों के प्रकार ये हैं: -| संदर्भ में नियम | यह क्या माँगता है | -| ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| कोई भी, बिना कुंजी | कुछ नहीं। Liveness, readiness स्थिति, साइन-इन विकल्प, साइन-इन और पंजीकरण। | -| कोई भी मान्य कुंजी या सत्र | कोई भी मान्य क्रेडेंशियल। उदाहरण: क्षमताएँ, ऑपरेशन सूची, आपकी अपनी पहचान, readiness विवरण और मेट्रिक्स। | -| साइन-इन किया खाता सत्र (कुंजी नहीं) | किसी व्यक्ति का सत्र। व्यक्तिगत टोकन और कुंजियाँ अस्वीकार कर दी जाती हैं (`session_required`)। उदाहरण: अपने टोकन बनाना और निरस्त करना, अपना पासवर्ड बदलना। | -| व्यवस्थापक | व्यवस्थापक खाते का सत्र, या व्यवस्थापक फ़्लैग वाली फ़ाइल कुंजी, जैसे पुनर्प्राप्ति कुंजी। व्यक्तिगत टोकन और सेवा कुंजियाँ अस्वीकार कर दी जाती हैं (`administrator_required`)। उदाहरण: खाते, समूह, सुरक्षा ऑडिट, अपडेट। | -| Bootstrap कुंजी (इंस्टॉलेशन पुनर्प्राप्ति कुंजी) | सेवा-प्रबंधन फ़्लैग वाली फ़ाइल कुंजी। पुनर्प्राप्ति कुंजी में यह होता है। उदाहरण: सेवा खाते बनाना और प्रत्यायोजन सेट करना। | -| Bootstrap कुंजी, या कुंजी स्वयं | पुनर्प्राप्ति कुंजी, या वह कुंजी जिसके प्रत्यायोजन सूचीबद्ध हैं। | -| जारी की गई कुंजी, सक्रियण से पहले या बाद | एकमात्र ऑपरेशन जो pending कुंजी स्वीकार करता है: सक्रियण। | -| जो रिपॉज़िटरी कॉलर देख सकता है | उस रिपॉज़िटरी पर कार्रवाई `repository.read`, या सत्र/फ़ाइल कुंजी के लिए उस तक कोई भी पहुँच। जिस रिपॉज़िटरी को कॉलर नहीं देख सकता वह सूचियों से बाहर रहती है और `404` उत्तर देती है। | -| सिस्टम अनुमति `backup.read` या `backup.manage` | व्यवस्थापक सत्रों और व्यवस्थापक फ़्लैग वाली फ़ाइल कुंजियों के पास होती है। सेवा कुंजियों और व्यक्तिगत टोकन के पास कभी नहीं होती। `backup.manage` में `backup.read` शामिल है। | -| सेवा प्रबंधन अनुमति | लक्ष्य खाते पर सात [प्रबंधन कार्रवाइयों](#delegation) में से एक, किसी प्रत्यायोजन से, या पुनर्प्राप्ति कुंजी। | -| रिपॉज़िटरी अनुमति | पथ में नामित रिपॉज़िटरी पर सूचीबद्ध रिपॉज़िटरी कार्रवाइयों में से **सभी**। कई एक्सेस नियम शर्तें जोड़ते हैं: अपलोड, जॉब या संदर्भ कॉलर का होना चाहिए। | +| संदर्भ में नियम | यह क्या माँगता है | +| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| कोई भी, बिना कुंजी | कुछ नहीं। Liveness, readiness स्थिति, साइन-इन विकल्प, साइन-इन और पंजीकरण। | +| कोई भी मान्य कुंजी या सत्र | कोई भी मान्य क्रेडेंशियल। उदाहरण: क्षमताएँ, ऑपरेशन सूची, आपकी अपनी पहचान, readiness विवरण और मेट्रिक्स। | +| साइन-इन किया खाता सत्र (कुंजी नहीं) | किसी व्यक्ति का सत्र। व्यक्तिगत टोकन और कुंजियाँ अस्वीकार कर दी जाती हैं (`session_required`)। उदाहरण: अपने टोकन बनाना और निरस्त करना, अपना पासवर्ड बदलना। | +| व्यवस्थापक | व्यवस्थापक खाते का सत्र, या व्यवस्थापक फ़्लैग वाली फ़ाइल कुंजी, जैसे पुनर्प्राप्ति कुंजी। व्यक्तिगत टोकन और सेवा कुंजियाँ अस्वीकार कर दी जाती हैं (`administrator_required`)। उदाहरण: खाते, समूह, सुरक्षा ऑडिट, अपडेट। | +| Bootstrap कुंजी (इंस्टॉलेशन पुनर्प्राप्ति कुंजी) | सेवा-प्रबंधन फ़्लैग वाली फ़ाइल कुंजी। पुनर्प्राप्ति कुंजी में यह होता है। उदाहरण: सेवा खाते बनाना और प्रत्यायोजन सेट करना। | +| Bootstrap कुंजी, या कुंजी स्वयं | पुनर्प्राप्ति कुंजी, या वह कुंजी जिसके प्रत्यायोजन सूचीबद्ध हैं। | +| जारी की गई कुंजी, सक्रियण से पहले या बाद | एकमात्र ऑपरेशन जो pending कुंजी स्वीकार करता है: सक्रियण। | +| जो रिपॉज़िटरी कॉलर देख सकता है | उस रिपॉज़िटरी पर कार्रवाई `repository.read`, या सत्र/फ़ाइल कुंजी के लिए उस तक कोई भी पहुँच। जिस रिपॉज़िटरी को कॉलर नहीं देख सकता वह सूचियों से बाहर रहती है और `404` उत्तर देती है। | +| सिस्टम अनुमति `backup.read` या `backup.manage` | व्यवस्थापक सत्रों और व्यवस्थापक फ़्लैग वाली फ़ाइल कुंजियों के पास होती है। सेवा कुंजियों और व्यक्तिगत टोकन के पास कभी नहीं होती। `backup.manage` में `backup.read` शामिल है। | +| सेवा प्रबंधन अनुमति | लक्ष्य खाते पर सात [प्रबंधन कार्रवाइयों](#delegation) में से एक, किसी प्रत्यायोजन से, या पुनर्प्राप्ति कुंजी। | +| रिपॉज़िटरी अनुमति | पथ में नामित रिपॉज़िटरी पर सूचीबद्ध रिपॉज़िटरी कार्रवाइयों में से **सभी**। कई एक्सेस नियम शर्तें जोड़ते हैं: अपलोड, जॉब या संदर्भ कॉलर का होना चाहिए। | रिपॉज़िटरी पंक्ति का दूसरा भाग, जैसे "file keys: `read`, `write`", वह मोटा अनुदान है जिसकी लोगों और फ़ाइल कुंजियों को सटीक कार्रवाइयों के बजाय ज़रूरत होती है। [समूह अनुदान](#group-grants) देखें। @@ -229,32 +229,32 @@ rm reset.json सेवा कुंजी सटीक कार्रवाइयाँ ले जाती है, रिपॉज़िटरी-दर-रिपॉज़िटरी। 24 हैं: -| कार्रवाई | क्या अनुमति देती है | -| ------------------ | ------------------------------------------------------------------------------------------------------------------------------- | -| `repository.read` | रिपॉज़िटरी और उसकी मिरर स्थिति देखना। | -| `artifact.read` | आर्टिफ़ैक्ट का विवरण, स्टेज और प्रमोशन पढ़ना। आर्टिफ़ैक्ट में हर बदलाव के साथ भी चाहिए। | -| `artifact.list` | आर्टिफ़ैक्ट सूचीबद्ध और खोजना, स्टेज किए गए आर्टिफ़ैक्ट सूचीबद्ध करना, प्रमोशन जर्नल और परिवर्तन फ़ीड पढ़ना। | -| `artifact.promote` | स्टेज सेट और हटाना, और किसी दूसरी रिपॉज़िटरी में प्रमोट करना (कॉपी या स्थानांतरण)। | +| कार्रवाई | क्या अनुमति देती है | +| ------------------ | --------------------------------------------------------------------------------------------------------------- | +| `repository.read` | रिपॉज़िटरी और उसकी मिरर स्थिति देखना। | +| `artifact.read` | आर्टिफ़ैक्ट का विवरण, स्टेज और प्रमोशन पढ़ना। आर्टिफ़ैक्ट में हर बदलाव के साथ भी चाहिए। | +| `artifact.list` | आर्टिफ़ैक्ट सूचीबद्ध और खोजना, स्टेज किए गए आर्टिफ़ैक्ट सूचीबद्ध करना, प्रमोशन जर्नल और परिवर्तन फ़ीड पढ़ना। | +| `artifact.promote` | स्टेज सेट और हटाना, और किसी दूसरी रिपॉज़िटरी में प्रमोट करना (कॉपी या स्थानांतरण)। | | `artifact.delete` | आर्टिफ़ैक्ट हटाना, प्रतिधारण का पूर्वावलोकन और उसे लागू करना, और कंटेनर इमेज हटाना तथा Git LFS फ़ाइलों का ज़बरदस्ती अनलॉक करना। | -| `content.read` | ID, पैकेज या पथ से बाइट डाउनलोड करना, और डाउनलोड लिंक बनाना। | -| `upload.create` | अपलोड सत्र बनाना। रजिस्ट्री में पुश और Git LFS इसे इस्तेमाल करते हैं। | -| `upload.read` | अपने ही अपलोड सत्र और उनके भाग पढ़ना। | -| `upload.write` | अपने ही अपलोड के भाग या पूरी सामग्री भेजना। | -| `upload.complete` | अपना ही अपलोड पूरा करना, या उसकी पूर्णता को कतार में लगाना। | -| `upload.cancel` | अपना ही pending अपलोड रद्द करना। | -| `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` | स्टोरेज इवेंट पढ़ना। | +| `content.read` | ID, पैकेज या पथ से बाइट डाउनलोड करना, और डाउनलोड लिंक बनाना। | +| `upload.create` | अपलोड सत्र बनाना। रजिस्ट्री में पुश और Git LFS इसे इस्तेमाल करते हैं। | +| `upload.read` | अपने ही अपलोड सत्र और उनके भाग पढ़ना। | +| `upload.write` | अपने ही अपलोड के भाग या पूरी सामग्री भेजना। | +| `upload.complete` | अपना ही अपलोड पूरा करना, या उसकी पूर्णता को कतार में लगाना। | +| `upload.cancel` | अपना ही pending अपलोड रद्द करना। | +| `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` | स्टोरेज इवेंट पढ़ना। | किसी ऑपरेशन को जिनकी ज़रूरत होती है वह सटीक समूह संदर्भ में उसकी पंक्ति पर होता है, उदाहरण के लिए `putUploadContent` के लिए `upload.write` और `upload.complete`। रिपॉज़िटरी में बदलाव के लिए उससे मेल खाती `read` कार्रवाई भी चाहिए, जैसे `annotation.write` के साथ `artifact.read`। @@ -268,13 +268,13 @@ rm reset.json सर्वर कोई भी पासवर्ड जाँचने से पहले पासवर्ड का अनुमान लगाना धीमा कर देता है। काउंटर हर API प्रोसेस की मेमोरी में रहते हैं और रीस्टार्ट के बाद फिर से शुरू होते हैं। वे प्रति क्लाइंट पते लागू होते हैं, और IPv6 पते को उसके /64 प्रीफ़िक्स से गिना जाता है। रिवर्स प्रॉक्सी के पीछे `ARKVORY_TRUSTED_PROXIES` सेट करें, वरना हर क्लाइंट प्रॉक्सी के रूप में दिखता है। -| सीमा | मान | -| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| प्रति पते साइन-इन प्रयास | 10 का बर्स्ट, फिर हर 15 सेकंड में एक और। सफल साइन-इन कोई प्रयास नहीं लेता। | -| प्रति खाता विफल पासवर्ड | हर गलत पासवर्ड एक ऐसे कर्ज़ में 1 जोड़ता है जो हर 6 सेकंड में 1 घटता है। 20 से ऊपर, खाता 1 सेकंड के लिए प्रयास अस्वीकार करता है, जो हर अगली विफलता के साथ दुगना होकर 2 मिनट तक जाता है; उस समय सही पासवर्ड को भी `429` मिलता है। सफल साइन-इन या रीसेट कर्ज़ माफ़ कर देता है। | -| प्रति पते पंजीकरण | 3, फिर हर 20 मिनट में एक और। | -| प्रति सर्वर पंजीकरण | 20, फिर हर 3 मिनट में एक और। | -| प्रगति में साइन-इन अनुरोध | प्रति API प्रोसेस 16, और बॉडी को आने के लिए 10 सेकंड हैं। अधिक होने पर कोड `busy` के साथ `503` लौटता है। | +| सीमा | मान | +| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| प्रति पते साइन-इन प्रयास | 10 का बर्स्ट, फिर हर 15 सेकंड में एक और। सफल साइन-इन कोई प्रयास नहीं लेता। | +| प्रति खाता विफल पासवर्ड | हर गलत पासवर्ड एक ऐसे कर्ज़ में 1 जोड़ता है जो हर 6 सेकंड में 1 घटता है। 20 से ऊपर, खाता 1 सेकंड के लिए प्रयास अस्वीकार करता है, जो हर अगली विफलता के साथ दुगना होकर 2 मिनट तक जाता है; उस समय सही पासवर्ड को भी `429` मिलता है। सफल साइन-इन या रीसेट कर्ज़ माफ़ कर देता है। | +| प्रति पते पंजीकरण | 3, फिर हर 20 मिनट में एक और। | +| प्रति सर्वर पंजीकरण | 20, फिर हर 3 मिनट में एक और। | +| प्रगति में साइन-इन अनुरोध | प्रति API प्रोसेस 16, और बॉडी को आने के लिए 10 सेकंड हैं। अधिक होने पर कोड `busy` के साथ `503` लौटता है। | अस्वीकृत प्रयास `429` लौटाता है, कोड `rate_limited`, कारण `login_attempts`, `registration_attempts` या `password_attempts`, और `Retry-After` सेकंड में। उतनी प्रतीक्षा करें; लूप में दोबारा न आज़माएँ। पासवर्ड बदलने या रीसेट करने का अपना गेट और कारण `password_attempts` है। सभी साइन-इन, पंजीकरण, पासवर्ड परिवर्तन और टोकन परिवर्तन सुरक्षा ऑडिट (`GET /api/v1/security/audit`, केवल व्यवस्थापक) में लिखे जाते हैं, जो 365 दिन रखता है। diff --git a/wiki/hi/api/index.md b/wiki/hi/api/index.md index 2aaa3df7..415e470b 100644 --- a/wiki/hi/api/index.md +++ b/wiki/hi/api/index.md @@ -31,14 +31,14 @@ HTTP API वह इंटरफ़ेस है जिसका उपयोग क्लाइंट अनुमान लगाने के बजाय सर्वर से पूछ सकता है कि वह क्या समर्थन करता है। इन सभी के लिए क्रेडेंशियल चाहिए। -| अनुरोध | उत्तर | -| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `GET /api/v1/capabilities` | API संस्करण (`v1`), गेटवे की भूमिका (`api` या `reader`), फ़ीचर फ़्लैग और इस सर्वर की सीमाएँ: `maxObjectBytes`, `partBytes` (सबसे छोटा भाग, 8 MiB), `maxPartBytes` (1 GiB), `maxParts` (10,000) और `maxPageSize` (100)। | +| अनुरोध | उत्तर | +| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `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` | राइटर API का OpenAPI 3.0.3 दस्तावेज़। केवल एक surface पाने के लिए `?surface=` जोड़ें। | -| `GET /api/v1/auth/permissions` | कॉल करने वाले क्रेडेंशियल की प्रति-रिपॉज़िटरी कार्रवाइयाँ। | -| `GET /api/v1/auth/me` | क्रेडेंशियल कौन है, उसका प्रकार और उसके मोटे `read`/`write` अनुदान। | -| `GET /api/v1/repositories` | वे रिपॉज़िटरी जो क्रेडेंशियल देख सकता है। | +| `GET /api/v1/openapi.json` | राइटर API का OpenAPI 3.0.3 दस्तावेज़। केवल एक surface पाने के लिए `?surface=` जोड़ें। | +| `GET /api/v1/auth/permissions` | कॉल करने वाले क्रेडेंशियल की प्रति-रिपॉज़िटरी कार्रवाइयाँ। | +| `GET /api/v1/auth/me` | क्रेडेंशियल कौन है, उसका प्रकार और उसके मोटे `read`/`write` अनुदान। | +| `GET /api/v1/repositories` | वे रिपॉज़िटरी जो क्रेडेंशियल देख सकता है। | सीमाओं को हार्ड-कोड करने के बजाय उन्हें पढ़ने के लिए `capabilities` इस्तेमाल करें। जिस फ़ीचर फ़्लैग को आप नहीं जानते उसे `false` मानें। @@ -46,14 +46,14 @@ HTTP API वह इंटरफ़ेस है जिसका उपयोग ऑपरेशन छह **surface** में समूहित हैं। वे कॉन्ट्रैक्ट के लेबल हैं, अलग सेवाएँ नहीं; URL नहीं बदलते। -| Surface | इसमें क्या शामिल है | -| ---------------- | ---------------------------------------------------------------------- | -| `discovery` | क्षमताएँ, ऑपरेशन कैटलॉग, OpenAPI और रिपॉज़िटरी | -| `identity` | साइन-इन, कॉलर की अपनी पहचान, टोकन और कुंजी सक्रियण | +| Surface | इसमें क्या शामिल है | +| ---------------- | ------------------------------------------------------ | +| `discovery` | क्षमताएँ, ऑपरेशन कैटलॉग, OpenAPI और रिपॉज़िटरी | +| `identity` | साइन-इन, कॉलर की अपनी पहचान, टोकन और कुंजी सक्रियण | | `catalog` | आर्टिफ़ैक्ट, एनोटेशन, पैकेज, पथ वाली फ़ाइलें, स्टेज, प्रमोशन, अटैचमेंट | -| `transfers` | अपलोड सत्र, भाग, पूर्णता जॉब और डाउनलोड | -| `administration` | खाते, समूह, सेवा खाते, कुंजियाँ, प्रत्यायोजन, अपडेट और बैकअप | -| `operations` | Liveness, readiness, मेट्रिक्स और फ़ीडबैक | +| `transfers` | अपलोड सत्र, भाग, पूर्णता जॉब और डाउनलोड | +| `administration` | खाते, समूह, सेवा खाते, कुंजियाँ, प्रत्यायोजन, अपडेट और बैकअप | +| `operations` | Liveness, readiness, मेट्रिक्स और फ़ीडबैक | हेल्थ चेक बिना क्रेडेंशियल वाले `GET /health/live` (प्रोसेस चल रहा है) और `GET /health/status` (सार्वजनिक; `{"status":"ready"}` या `unavailable`) हैं, और क्रेडेंशियल वाले `GET /health/ready` और `GET /health/metrics` हैं। वे अनुरोध बजट का उपयोग नहीं करते, इसलिए लोड के कारण बैलेंसर सर्वर को हटा नहीं देता। @@ -79,11 +79,11 @@ HTTP API वह इंटरफ़ेस है जिसका उपयोग `Idempotency-Key` हेडर दोहराए गए अनुरोध को एक बार प्रभावी बनाता है। अक्षरों, अंकों और `_ . : -` से बना 1 से 128 अक्षरों का मान इस्तेमाल करें, और पहले अनुरोध से पहले उसे जॉब स्थिति के साथ रखें, ताकि रीस्टार्ट हुआ जॉब वही कुंजी दोहराए। इन लेखों के लिए एक चाहिए: -| ऑपरेशन | समान कुंजी और समान बॉडी के साथ दोहराव | -| ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | -| `createUpload` | वही अपलोड सत्र लौटाता है। | +| ऑपरेशन | समान कुंजी और समान बॉडी के साथ दोहराव | +| ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | +| `createUpload` | वही अपलोड सत्र लौटाता है। | | `issueServiceKey` और `rotateServiceKey` | कुंजी का मेटाडेटा `200` के साथ लौटाता है, बिना सीक्रेट। यदि सीक्रेट खो गया है तो कुंजी निरस्त करें और दूसरी जारी करें। | -| `requestBackupRun`, `requestBackupVerify`, `requestBackupRetention` | दूसरा कतार में लगाने के बजाय वही अनुरोध लौटाता है। | +| `requestBackupRun`, `requestBackupVerify`, `requestBackupRetention` | दूसरा कतार में लगाने के बजाय वही अनुरोध लौटाता है। | अलग बॉडी के साथ वही कुंजी `409` और कारण `idempotency_mismatch` के साथ अस्वीकार कर दी जाती है। कुंजी कॉलर और लक्ष्य तक सीमित होती है, इसलिए दो कॉलर एक ही मान इस्तेमाल कर सकते हैं। @@ -93,15 +93,15 @@ HTTP API वह इंटरफ़ेस है जिसका उपयोग हर ऑपरेशन की एक **रीट्राई श्रेणी** होती है। श्रेणी क्लाइंट को बताती है कि जब उसे उत्तर न मिले तो क्या करे। संदर्भ इसे हर ऑपरेशन पर "Retry" के रूप में दिखाता है। -| श्रेणी | अर्थ | क्या करें | -| ------------------ | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `read` | पढ़ने से कुछ नहीं बदलता। | बैकऑफ़ के साथ दोहराएँ। | -| `idempotent` | वही अनुरोध का वही प्रभाव होता है। | दोहराएँ। उत्तर विवरण में भिन्न हो सकता है: दो बार हटाने पर बताया जा सकता है कि ऑब्जेक्ट जा चुका है। | -| `idempotency-key` | केवल कुंजी के साथ सुरक्षित। | उसी `Idempotency-Key` और उसी बॉडी के साथ दोहराएँ। | -| `compare-and-swap` | संशोधन पर निर्भर बदलाव। | स्थिति पढ़ें, फिर से निर्णय लें, और जो संशोधन पढ़ा था उसी के साथ दोहराएँ। `409` पार करने के लिए कभी `expectedRevision` न बढ़ाएँ। | -| `reconcile-upload` | अपलोड सत्र का एक चरण। | पहले अपलोड और उसके भाग पढ़ें (`getUpload`, `listUploadParts`), फिर जो छूट गया है वह भेजें। पूरी-फ़ाइल वाला `PUT` बीच से जारी नहीं हो सकता: वह बाइट शून्य से फिर शुरू होता है। | -| `reconcile-job` | पूर्णता जॉब को कतार में लगाना। | पहले जॉब पढ़ें (`getCompletionJob`)। विफल जॉब को फिर से कतार में लगाया जा सकता है। | -| `never-automatic` | दोहराव कार्रवाई दो बार कर सकता है। | स्वतः दोहराएँ नहीं। परिणाम जाँचें, फिर निर्णय लें। उदाहरण: खाता, टोकन या डाउनलोड लिंक बनाना, स्टोरेज नीति चलाना, फ़ीडबैक भेजना। | +| श्रेणी | अर्थ | क्या करें | +| ------------------ | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `read` | पढ़ने से कुछ नहीं बदलता। | बैकऑफ़ के साथ दोहराएँ। | +| `idempotent` | वही अनुरोध का वही प्रभाव होता है। | दोहराएँ। उत्तर विवरण में भिन्न हो सकता है: दो बार हटाने पर बताया जा सकता है कि ऑब्जेक्ट जा चुका है। | +| `idempotency-key` | केवल कुंजी के साथ सुरक्षित। | उसी `Idempotency-Key` और उसी बॉडी के साथ दोहराएँ। | +| `compare-and-swap` | संशोधन पर निर्भर बदलाव। | स्थिति पढ़ें, फिर से निर्णय लें, और जो संशोधन पढ़ा था उसी के साथ दोहराएँ। `409` पार करने के लिए कभी `expectedRevision` न बढ़ाएँ। | +| `reconcile-upload` | अपलोड सत्र का एक चरण। | पहले अपलोड और उसके भाग पढ़ें (`getUpload`, `listUploadParts`), फिर जो छूट गया है वह भेजें। पूरी-फ़ाइल वाला `PUT` बीच से जारी नहीं हो सकता: वह बाइट शून्य से फिर शुरू होता है। | +| `reconcile-job` | पूर्णता जॉब को कतार में लगाना। | पहले जॉब पढ़ें (`getCompletionJob`)। विफल जॉब को फिर से कतार में लगाया जा सकता है। | +| `never-automatic` | दोहराव कार्रवाई दो बार कर सकता है। | स्वतः दोहराएँ नहीं। परिणाम जाँचें, फिर निर्णय लें। उदाहरण: खाता, टोकन या डाउनलोड लिंक बनाना, स्टोरेज नीति चलाना, फ़ीडबैक भेजना। | नेटवर्क विफलता और स्टेटस `408`, `429`, `502`, `503` और `504` अस्थायी हैं: श्रेणी के अनुसार दोहराएँ, कम से कम `Retry-After` जितनी प्रतीक्षा करें, और प्रयासों की सीमा के साथ एक्सपोनेंशियल बैकऑफ़ जोड़ें। अनुरोध बदले बिना `401`, `403` और अन्य `4xx` उत्तर दोहराएँ नहीं। `500` को अंधाधुंध दोहराएँ नहीं; सहायता को अनुरोध ID दें। किसी बदलाव पर `503` के बाद परिणाम अज्ञात होता है, इसलिए श्रेणी का उपयोग करके पता लगाएँ कि क्या हुआ। SDK और कमांड-लाइन क्लाइंट इन नियमों को लागू करते हैं। diff --git a/wiki/hi/guide/agents.md b/wiki/hi/guide/agents.md index 7f48dbe0..600e21df 100644 --- a/wiki/hi/guide/agents.md +++ b/wiki/hi/guide/agents.md @@ -36,13 +36,13 @@ claude mcp add arkvory -- arkvoryctl mcp --profile agent --root ~/work 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` | एजेंट द्वारा पढ़े गए संशोधन पर लेबल और मेटाडेटा बदलता है | +| `arkvory_publish_package` | UPack अपलोड करता है और उसे पैकेज संस्करण के रूप में पंजीकृत करता है | +| `arkvory_promote` | स्टेज जोड़ता है; `sha256` के साथ, केवल ठीक उन्हीं बाइट वाले आर्टिफ़ैक्ट में | +| `arkvory_stage_remove` | स्टेज हटाता है; आर्टिफ़ैक्ट बना रहता है | +| `arkvory_annotate` | एजेंट द्वारा पढ़े गए संशोधन पर लेबल और मेटाडेटा बदलता है | - `--write-repositories` में न होने वाली रिपॉज़िटरी में लिखना कुछ भी भेजे जाने से पहले अस्वीकार हो जाता है (`repository_not_allowed`)। सर्वर फिर भी कुंजी की अनुमतियाँ जाँचता है। - कुछ भी हटाया या पुनर्स्थापित नहीं किया जा सकता, और कोई डाउनलोड लिंक नहीं बनाया जाता। ये काम कंसोल में किसी व्यक्ति के ही रहते हैं। @@ -74,11 +74,11 @@ arkvoryctl skill install ## समस्या निवारण {#troubleshooting} -| त्रुटि | कारण और समाधान | -| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| लिखने वाले टूल नहीं हैं | सर्वर `--write` के बिना शुरू हुआ, या कुंजी के पास अनुमति नहीं है। | -| `repository_not_allowed` | रिपॉज़िटरी `--write-repositories` में नहीं है। MCP कॉन्फ़िगरेशन बदलें। | -| `forbidden` | कुंजी के पास अनुमति नहीं है। अनुमतियाँ देखने के लिए `arkvoryctl doctor` चलाएँ। | -| `path_outside_root` | फ़ाइल `--root` के बाहर है या सामान्य फ़ाइल नहीं है। | +| त्रुटि | कारण और समाधान | +| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| लिखने वाले टूल नहीं हैं | सर्वर `--write` के बिना शुरू हुआ, या कुंजी के पास अनुमति नहीं है। | +| `repository_not_allowed` | रिपॉज़िटरी `--write-repositories` में नहीं है। MCP कॉन्फ़िगरेशन बदलें। | +| `forbidden` | कुंजी के पास अनुमति नहीं है। अनुमतियाँ देखने के लिए `arkvoryctl doctor` चलाएँ। | +| `path_outside_root` | फ़ाइल `--root` के बाहर है या सामान्य फ़ाइल नहीं है। | | `state_locked` | वही अपलोड किसी दूसरे कॉल में अभी चल रहा है। क्रैश के बाद पक्का करें कि कोई `arkvoryctl mcp` वह फ़ाइल अपलोड नहीं कर रहा, फिर CLI निर्देशिका (`~/.config/arkvory`) के `mcp-uploads` में `.lock` फ़ाइल हटाएँ। | -| `skill_modified` | आपने स्किल की फ़ाइल बदली है। अपनी प्रति रखें या `--force` के साथ `arkvoryctl skill install` दोहराएँ। | +| `skill_modified` | आपने स्किल की फ़ाइल बदली है। अपनी प्रति रखें या `--force` के साथ `arkvoryctl skill install` दोहराएँ। | diff --git a/wiki/hi/guide/concepts.md b/wiki/hi/guide/concepts.md index b9364c98..b07835c4 100644 --- a/wiki/hi/guide/concepts.md +++ b/wiki/hi/guide/concepts.md @@ -11,12 +11,12 @@ description: 'वे विचार जो बाकी दस्तावे एक इंस्टॉलेशन एक सर्वर है। यह एक PostgreSQL डेटाबेस के साथ तीन Arkvory सेवाएँ चलाता है: -| भाग | यह क्या करता है | -| ----------- | -------------------------------------------------------------------------------------------------------------------------------------- | -| API | HTTP सर्वर: HTTP API, [वेब कंसोल](./console), और कंटेनर, Git LFS व npm के लिए रजिस्ट्रियाँ। यह प्रतिधारण और भौतिक क्लीनअप भी चलाता है। | -| वर्कर | पृष्ठभूमि के काम: बड़े अपलोड पूरे करता है और मिरर सिंक्रनाइज़ करता है। | -| बैकअप एजेंट | बैकअप स्टोरेज (vault) में निर्धारित बैकअप। | -| PostgreSQL | कैटलॉग: आर्टिफ़ैक्ट, पैकेज, संशोधन, खाते, कुंजियाँ और जॉब। | +| भाग | यह क्या करता है | +| ---------- | -------------------------------------------------------------------------------------------------------------------------- | +| API | HTTP सर्वर: HTTP API, [वेब कंसोल](./console), और कंटेनर, Git LFS व npm के लिए रजिस्ट्रियाँ। यह प्रतिधारण और भौतिक क्लीनअप भी चलाता है। | +| वर्कर | पृष्ठभूमि के काम: बड़े अपलोड पूरे करता है और मिरर सिंक्रनाइज़ करता है। | +| बैकअप एजेंट | बैकअप स्टोरेज (vault) में निर्धारित बैकअप। | +| PostgreSQL | कैटलॉग: आर्टिफ़ैक्ट, पैकेज, संशोधन, खाते, कुंजियाँ और जॉब। | फ़ाइल की सामग्री सर्वर की एक स्थानीय डायरेक्टरी में रहती है, डेटाबेस में नहीं। सभी भाग **इंस्टॉलेशन रूट** में रहते हैं (Windows पर `C:\ProgramData\ProAnima\Arkvory`, Linux पर `/opt/proanima-arkvory`)। सेवाएँ किसी साइन-इन किए हुए उपयोगकर्ता के बिना शुरू होती हैं और क्रैश या हैंग के बाद फिर से शुरू हो जाती हैं ([स्वतः पुनर्प्राप्ति](../operate/self-healing))। @@ -61,12 +61,12 @@ description: 'वे विचार जो बाकी दस्तावे आप किसी आर्टिफ़ैक्ट के बाइट को छुए बिना उसका वर्णन कर सकते हैं: -| मद | नियम | -| -------- | ------------------------------------------------------------------------------------------------------------------------------------- | -| लेबल | `nightly` या `tested` जैसे अधिकतम 32 छोटे टैग। | -| मेटाडेटा | अधिकतम 32 टेक्स्ट फ़ील्ड; एक कुंजी में अधिकतम 64 अक्षर, एक मान में अधिकतम 1,024। | -| संग्रह | आर्टिफ़ैक्ट को समूहित करने वाले नामित सेट। | -| अटैचमेंट | एक बिल्ड से उसी रिपॉज़िटरी के अन्य आर्टिफ़ैक्ट तक अधिकतम 32 लिंक: एक मैनिफ़ेस्ट, एक SBOM, एक हस्ताक्षर, एक रिपोर्ट या कोई अन्य फ़ाइल। | +| मद | नियम | +| ------ | ------------------------------------------------------------------------------------------------------------------ | +| लेबल | `nightly` या `tested` जैसे अधिकतम 32 छोटे टैग। | +| मेटाडेटा | अधिकतम 32 टेक्स्ट फ़ील्ड; एक कुंजी में अधिकतम 64 अक्षर, एक मान में अधिकतम 1,024। | +| संग्रह | आर्टिफ़ैक्ट को समूहित करने वाले नामित सेट। | +| अटैचमेंट | एक बिल्ड से उसी रिपॉज़िटरी के अन्य आर्टिफ़ैक्ट तक अधिकतम 32 लिंक: एक मैनिफ़ेस्ट, एक SBOM, एक हस्ताक्षर, एक रिपोर्ट या कोई अन्य फ़ाइल। | लेबल, मेटाडेटा और संग्रह एक संशोधित सेट के रूप में बदलते हैं। अटैचमेंट का अपना संशोधन और इतिहास होता है। @@ -86,13 +86,13 @@ description: 'वे विचार जो बाकी दस्तावे हर अनुरोध के साथ एक क्रेडेंशियल होता है। चार प्रकार आप बनाते हैं, और एक अंतर्निहित है: -| क्रेडेंशियल | किसके लिए | अवधि | -| ------------------------- | ----------------------------------------------------- | -------------------------------------------- | -| कंसोल **सत्र** | नाम और पासवर्ड से साइन-इन किया हुआ व्यक्ति | 12 घंटे | -| **व्यक्तिगत एक्सेस टोकन** | एक व्यक्ति की स्क्रिप्ट और टूल | डिफ़ॉल्ट रूप से 90 दिन, अधिकतम 365 | -| **सेवा कुंजी** | CI/CD और डिप्लॉयमेंट एजेंट | डिफ़ॉल्ट रूप से 90 दिन, अधिकतम 365 | -| **डाउनलोड लिंक** | बिना कुंजी वाले किसी व्यक्ति को एक आर्टिफ़ैक्ट सौंपना | 60 सेकंड से 24 घंटे (डिफ़ॉल्ट रूप से 1 घंटा) | -| **पुनर्प्राप्ति कुंजी** | इंस्टॉलेशन स्वयं | समाप्त नहीं होती | +| क्रेडेंशियल | किसके लिए | अवधि | +| --------------------- | ------------------------------------------- | ---------------------------------- | +| कंसोल **सत्र** | नाम और पासवर्ड से साइन-इन किया हुआ व्यक्ति | 12 घंटे | +| **व्यक्तिगत एक्सेस टोकन** | एक व्यक्ति की स्क्रिप्ट और टूल | डिफ़ॉल्ट रूप से 90 दिन, अधिकतम 365 | +| **सेवा कुंजी** | CI/CD और डिप्लॉयमेंट एजेंट | डिफ़ॉल्ट रूप से 90 दिन, अधिकतम 365 | +| **डाउनलोड लिंक** | बिना कुंजी वाले किसी व्यक्ति को एक आर्टिफ़ैक्ट सौंपना | 60 सेकंड से 24 घंटे (डिफ़ॉल्ट रूप से 1 घंटा) | +| **पुनर्प्राप्ति कुंजी** | इंस्टॉलेशन स्वयं | समाप्त नहीं होती | एक सेवा कुंजी एक बार जारी होती है, एक बार दिखाई जाती है, और **सक्रिय** होने के बाद ही उपयोग योग्य बनती है। आप इसे **रोटेट** कर सकते हैं (नई जारी करें, फिर पुरानी सेवानिवृत्त करें) और हमेशा के लिए **निरस्त** कर सकते हैं। [प्रमाणीकरण](../api/authentication) देखें। diff --git a/wiki/hi/guide/console.md b/wiki/hi/guide/console.md index 4f4ea923..302f898e 100644 --- a/wiki/hi/guide/console.md +++ b/wiki/hi/guide/console.md @@ -12,7 +12,7 @@ title: वेब कंसोल साइडबार अनुभागों को समूहों में बाँटता है। संकरी स्क्रीन पर साइडबार [[ui:navigationMenu]] बटन बन जाता है। -| समूह | अनुभाग | +| समूह | अनुभाग | | ------------------- | ------------------------------------------------------------------------------------------------------------------------- | | [[ui:navLibrary]] | [[ui:catalog]], [[ui:packages]], [[ui:history]], [[ui:metadata]] | | [[ui:navTransfers]] | [[ui:upload]], [[ui:downloads]] | @@ -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} diff --git a/wiki/hi/guide/index.md b/wiki/hi/guide/index.md index ca94f6e9..70fe6287 100644 --- a/wiki/hi/guide/index.md +++ b/wiki/hi/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) देखें। | -| कंटेनर इमेज | Docker, Podman, Helm और ORAS के लिए OCI रजिस्ट्री। [कंटेनर इमेज](../protocols/containers) देखें। | -| Git LFS ऑब्जेक्ट | फ़ाइल लॉकिंग वाला Git LFS सर्वर। [Git LFS](../protocols/git-lfs) देखें। | -| npm और Unity पैकेज | npm रजिस्ट्री, जिसे Unity Package Manager इस्तेमाल कर सकता है। [Unity और npm](../protocols/unity-npm) देखें। | +| सामग्री | आप इसके साथ कैसे काम करते हैं | +| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | +| आर्टिफ़ैक्ट (कोई भी फ़ाइल) | कंसोल, [कमांड-लाइन क्लाइंट](../protocols/cli), [SDK](../protocols/sdk) या HTTP API से अपलोड करें | +| UPack पैकेज | समूह, नाम और SemVer संस्करण वाले संस्करणित पैकेज। [पैकेज](../use/packages) देखें। | +| पथ वाली फ़ाइलें | `builds/game/1.4/Setup.exe` जैसा पथ, जो हर पिछला संस्करण सँभालकर रखता है। [फ़ाइलें और पथ](../use/files) और [रॉ फ़ाइलें](../protocols/raw-files) देखें। | +| कंटेनर इमेज | Docker, Podman, Helm और ORAS के लिए OCI रजिस्ट्री। [कंटेनर इमेज](../protocols/containers) देखें। | +| Git LFS ऑब्जेक्ट | फ़ाइल लॉकिंग वाला Git LFS सर्वर। [Git LFS](../protocols/git-lfs) देखें। | +| npm और Unity पैकेज | npm रजिस्ट्री, जिसे Unity Package Manager इस्तेमाल कर सकता है। [Unity और npm](../protocols/unity-npm) देखें। | सहेजी गई हर फ़ाइल SHA-256 चेकसम वाला एक अपरिवर्तनीय **आर्टिफ़ैक्ट** है। नई सामग्री पुराने बाइट कभी नहीं बदलती; वह एक नया आर्टिफ़ैक्ट बनाती है। [अवधारणाएँ](./concepts) देखें। @@ -49,19 +49,19 @@ Arkvory सभी के लिए मुफ़्त है, कंपनिय Arkvory एक सर्वर पर चलता है। कैटलॉग के लिए यह PostgreSQL और सामग्री के लिए एक स्थानीय डायरेक्टरी इस्तेमाल करता है। तीन सेवाएँ मिलकर काम करती हैं: -| सेवा | उद्देश्य | -| ----------- | ---------------------------------------------------------------------------------- | -| API | HTTP सर्वर: API, कंसोल और रजिस्ट्रियाँ। यह प्रतिधारण और भौतिक क्लीनअप भी चलाता है। | -| वर्कर | पृष्ठभूमि के काम: बड़े अपलोड पूरे करना और मिरर सिंक्रनाइज़ करना | -| बैकअप एजेंट | बैकअप स्टोरेज में निर्धारित बैकअप | +| सेवा | उद्देश्य | +| -------- | -------------------------------------------------------------------------- | +| API | HTTP सर्वर: API, कंसोल और रजिस्ट्रियाँ। यह प्रतिधारण और भौतिक क्लीनअप भी चलाता है। | +| वर्कर | पृष्ठभूमि के काम: बड़े अपलोड पूरे करना और मिरर सिंक्रनाइज़ करना | +| बैकअप एजेंट | बैकअप स्टोरेज में निर्धारित बैकअप | आप इसे तीन तरीकों से इंस्टॉल कर सकते हैं: -| प्लेटफ़ॉर्म | इंस्टॉलर | विवरण | -| ----------------------------- | ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| प्लेटफ़ॉर्म | इंस्टॉलर | विवरण | +| ----------------------------- | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 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) सेट करें। diff --git a/wiki/hi/install/configuration.md b/wiki/hi/install/configuration.md index 65049521..c31a03a8 100644 --- a/wiki/hi/install/configuration.md +++ b/wiki/hi/install/configuration.md @@ -16,19 +16,19 @@ Arkvory में दो तरह की सेटिंग्स होती इंस्टॉलेशन रूट में सब कुछ रहता है। यह Windows पर `C:\ProgramData\ProAnima\Arkvory` और Linux पर `/opt/proanima-arkvory` है। 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` | एक यादृच्छिक इंस्टॉलेशन ID, जो हब को केवल सांख्यिकी चालू होने पर भेजा जाता है | न बदलें | -| `config/mirrors/` | मिरर सूची और वे कुंजियाँ जो वर्कर स्रोतों के लिए इस्तेमाल करता है | `configure --mirror` से | -| `config/webhooks/` | सब्सक्रिप्शन की सूची, हस्ताक्षर सीक्रेट और रिसीवरों के प्रमाणन प्राधिकरण जिन्हें worker इस्तेमाल करता है | `configure --webhook` से | -| `installation.json` | मोड, इंजन, स्वचालित अपडेट सेटिंग, संस्करण पिन और इंस्टॉल किया गया रिलीज़ | केवल कमांड से | -| `github-token.txt` | रिलीज़ डाउनलोड के लिए वैकल्पिक GitHub टोकन। [अपडेट](./updates#hub-unreachable) देखें | हाथ से | -| `config/compose.env`, `config/compose.vault.yml`, `config/compose.mirrors.yml` | केवल 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` | एक यादृच्छिक इंस्टॉलेशन ID, जो हब को केवल सांख्यिकी चालू होने पर भेजा जाता है | न बदलें | +| `config/mirrors/` | मिरर सूची और वे कुंजियाँ जो वर्कर स्रोतों के लिए इस्तेमाल करता है | `configure --mirror` से | +| `config/webhooks/` | सब्सक्रिप्शन की सूची, हस्ताक्षर सीक्रेट और रिसीवरों के प्रमाणन प्राधिकरण जिन्हें worker इस्तेमाल करता है | `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) देखें। इंस्टॉलर ने जो स्वामी और मोड सेट किए हैं, उन्हें वैसे ही रखें। @@ -36,24 +36,24 @@ Arkvory में दो तरह की सेटिंग्स होती सभी कमांड के लिए व्यवस्थापक अधिकार और इंस्टॉलेशन रूट के साथ `--root` विकल्प चाहिए। -| इंस्टॉलेशन | कमांड कैसे चलाएँ | -| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Linux पैकेज | `sudo arkvory --root /opt/proanima-arkvory` | -| Windows, ग्राफ़िकल इंस्टॉलर | उन्नत PowerShell में: `& 'C:\Program Files\ProAnima\Arkvory\arkvory.ps1' --root C:\ProgramData\ProAnima\Arkvory` | +| इंस्टॉलेशन | कमांड कैसे चलाएँ | +| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 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.21.0-linux-x64/bin/node /manage.mjs --root `. Windows पर `runtime\node-v24.21.0-win-x64\node.exe` इस्तेमाल करें | `arkvory help` बिना विशेष अधिकार के कमांड की सूची दिखाता है। इस साइट के उदाहरण छोटा रूप `arkvory ` इस्तेमाल करते हैं। -| कमांड | उपयोग | -| ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- | -| `status` | इंस्टॉलेशन मोड, इंजन, स्वचालित अपडेट सेटिंग, पिन और इंस्टॉल किया गया रिलीज़ दिखाता है | -| `configure` | कोई नीति बदलता है। [configure कमांड](#configure-command) देखें | -| `update` | अभी कोई नया स्थिर रिलीज़ इंस्टॉल करता है। [अपडेट](./updates) देखें | -| `upgrade` | डेटाबेस स्कीमा बदलने वाला रिलीज़ आपके अपने बैकअप रिकॉर्ड के साथ इंस्टॉल करता है। [अपडेट](./updates#manual-upgrade) देखें | -| `recover` | बाधित अपडेट पूरा करता है। [अपडेट](./updates#recover-update) देखें | -| `finish-install` | बाधित पहला इंस्टॉलेशन जारी रखता है | +| कमांड | उपयोग | +| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | +| `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) देखें | +| `updates-poll`, `updates-reset`, `changes-reset` | अपडेट टाइमर द्वारा और रिकवरी के लिए चलाए जाते हैं। [अपडेट](./updates#recover-update) देखें | | `volume-init` | एक खाली डायरेक्टरी को नए स्टोरेज वॉल्यूम के रूप में चिह्नित करता है। `--root` की ज़रूरत नहीं। [कई वॉल्यूम](../operate/storage#volumes) देखें | एक समय पर केवल एक कमांड चलता है। दूसरा कमांड `Installation is locked` के साथ रुक जाता है। किसी कमांड विकल्प में कभी कुंजी या पासवर्ड न डालें: फ़ाइलों का इस्तेमाल करें। @@ -62,14 +62,14 @@ Arkvory में दो तरह की सेटिंग्स होती एक कॉल एक तरह की सेटिंग बदलती है। छहों तरह की चीज़ें एक कॉल में नहीं मिलाई जा सकतीं। -| प्रकार | विकल्प | प्रभाव | -| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | -| 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 | `--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` फिर से लिखते हैं; वे कुछ भी रीस्टार्ट नहीं करते। फ़ाइल पथ निरपेक्ष होते हैं। @@ -77,10 +77,10 @@ HTTPS, बैकअप स्टोरेज और मिरर के बद ### पता और पोर्ट {#address-and-port} -| वेरिएबल | डिफ़ॉल्ट | अर्थ | -| -------------- | ----------- | -------------------------- | +| वेरिएबल | डिफ़ॉल्ट | अर्थ | +| -------------- | ----------- | ------------------------ | | `ARKVORY_HOST` | `127.0.0.1` | वह पता जिस पर API सुनता है | -| `ARKVORY_PORT` | `8080` | TCP पोर्ट | +| `ARKVORY_PORT` | `8080` | TCP पोर्ट | डिफ़ॉल्ट के साथ केवल सर्वर पर मौजूद प्रोग्राम जुड़ सकते हैं। दूसरे कंप्यूटर स्वीकार करने के लिए, दो में से एक तरीका चुनें: @@ -105,21 +105,21 @@ Linux पर सेवाएँ एक अपरिविलेज्ड खा ### डेटाबेस {#database} -| वेरिएबल | डिफ़ॉल्ट | अर्थ | -| ---------------------------- | ------------------- | ----------------------------------------------------------------------------------------------------- | +| वेरिएबल | डिफ़ॉल्ट | अर्थ | +| ---------------------------- | --------------- | -------------------------------------------------------------------------------------- | | `ARKVORY_DATABASE_URL` | इंस्टॉलर द्वारा सेट | PostgreSQL कनेक्शन URL। प्रबंधित डेटाबेस `127.0.0.1` पर इंस्टॉलेशन के दौरान चुने गए पोर्ट पर सुनता है | -| `ARKVORY_DATABASE_POOL_SIZE` | `10` | API कनेक्शन पूल का आकार, 4 से 200 तक | +| `ARKVORY_DATABASE_POOL_SIZE` | `10` | API कनेक्शन पूल का आकार, 4 से 200 तक | किसी इंस्टॉलेशन को दूसरे डेटाबेस की ओर न इंगित करें। सहेजी गई फ़ाइलें और कैटलॉग साथ-साथ रहते हैं। नए डेटाबेस पर जाना बैकअप से पुनर्स्थापना है: [बैकअप](../operate/backups) देखें। किसी बाहरी PostgreSQL के लिए, API पूल के लिए `max_connections` पर्याप्त ऊँचा सेट करें, write लॉक के लिए हर समवर्ती अपलोड पर एक कनेक्शन, वर्कर के लिए 5 और बैकअप एजेंट के कनेक्शन। ### स्टोरेज डायरेक्टरी और खाली जगह {#storage} -| वेरिएबल | डिफ़ॉल्ट | अर्थ | -| ------------------------------- | ------------- | -------------------------------------------------------------------------------------------- | -| `ARKVORY_DATA_DIR` | `/data` | जहाँ फ़ाइल सामग्री सहेजी जाती है। इंस्टॉलर द्वारा सेट। स्थानीय डिस्क इस्तेमाल करें | +| वेरिएबल | डिफ़ॉल्ट | अर्थ | +| ------------------------------- | ------------- | ---------------------------------------------------------------------------------- | +| `ARKVORY_DATA_DIR` | `/data` | जहाँ फ़ाइल सामग्री सहेजी जाती है। इंस्टॉलर द्वारा सेट। स्थानीय डिस्क इस्तेमाल करें | | `ARKVORY_CAPACITY_BYTES` | 10 TiB | वह अधिकतम जो सभी आरक्षित सामग्री इस्तेमाल कर सकती है। यह आरक्षणों की सीमा है, डिस्क माप नहीं | -| `ARKVORY_STORAGE_RESERVE_BYTES` | 1 GiB | खाली जगह जो अपलोड कभी इस्तेमाल नहीं करते। `0` रिज़र्व बंद कर देता है | -| `ARKVORY_MAX_OBJECT_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) देखें। @@ -127,17 +127,17 @@ Linux पर सेवाएँ एक अपरिविलेज्ड खा सीमाएँ एक API प्रोसेस की होती हैं। दर `0` का अर्थ कोई सीमा नहीं। -| वेरिएबल | डिफ़ॉल्ट | अर्थ | -| ------------------------------------- | --------- | --------------------------------------------------------------------------------------------------- | -| `ARKVORY_MAX_UPLOADS` | `2` | एक ही समय पर अपलोड, 1 से 32 | -| `ARKVORY_MAX_DOWNLOADS` | `16` | एक ही समय पर डाउनलोड, 1 से 256 | -| `ARKVORY_MAX_UPLOADS_PER_PRINCIPAL` | `1` | एक खाते या कुंजी के एक ही समय पर अपलोड | -| `ARKVORY_MAX_DOWNLOADS_PER_PRINCIPAL` | `4` | एक खाते या कुंजी के एक ही समय पर डाउनलोड | +| वेरिएबल | डिफ़ॉल्ट | अर्थ | +| ------------------------------------- | --------- | ---------------------------------------------------------------------------------------------- | +| `ARKVORY_MAX_UPLOADS` | `2` | एक ही समय पर अपलोड, 1 से 32 | +| `ARKVORY_MAX_DOWNLOADS` | `16` | एक ही समय पर डाउनलोड, 1 से 256 | +| `ARKVORY_MAX_UPLOADS_PER_PRINCIPAL` | `1` | एक खाते या कुंजी के एक ही समय पर अपलोड | +| `ARKVORY_MAX_DOWNLOADS_PER_PRINCIPAL` | `4` | एक खाते या कुंजी के एक ही समय पर डाउनलोड | | `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` | इतने समय तक कोई डेटा न भेजने वाला अपलोड अनुरोध रुक जाता है | +| `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) में हैं। @@ -153,11 +153,11 @@ API के सामने वाले प्रॉक्सी को कम ### लॉग और शटडाउन {#logs-and-shutdown} -| वेरिएबल | डिफ़ॉल्ट | अर्थ | -| -------------------------- | -------- | -------------------------------------------------------------------------------------------- | -| `ARKVORY_LOG_LEVEL` | `info` | `debug`, `info`, `warning` या `error`। स्तर `warning` और `error` एक्सेस लॉग भी छिपा देते हैं | -| `ARKVORY_ACCESS_LOG` | `true` | हर HTTP अनुरोध के लिए एक JSON रिकॉर्ड। क्वेरी स्ट्रिंग कभी नहीं लिखी जाती | -| `ARKVORY_DRAIN_TIMEOUT_MS` | `30000` | रोकने के अनुरोध के बाद, चल रहे अनुरोधों के पूरा होने का समय | +| वेरिएबल | डिफ़ॉल्ट | अर्थ | +| -------------------------- | ------- | ------------------------------------------------------------------------------------- | +| `ARKVORY_LOG_LEVEL` | `info` | `debug`, `info`, `warning` या `error`। स्तर `warning` और `error` एक्सेस लॉग भी छिपा देते हैं | +| `ARKVORY_ACCESS_LOG` | `true` | हर HTTP अनुरोध के लिए एक JSON रिकॉर्ड। क्वेरी स्ट्रिंग कभी नहीं लिखी जाती | +| `ARKVORY_DRAIN_TIMEOUT_MS` | `30000` | रोकने के अनुरोध के बाद, चल रहे अनुरोधों के पूरा होने का समय | सुपरवाइज़र किसी सेवा को रुकने के लिए 120 सेकंड देते हैं। यदि आप लगभग 90 सेकंड से अधिक ड्रेन समय सेट करते हैं, तो सेवा प्रबंधक का स्टॉप टाइमआउट भी बढ़ाएँ: systemd यूनिट्स में `TimeoutStopSec`, Windows सेवाओं का स्टॉप टाइमआउट, और Compose में `stop_grace_period`। [मॉनिटरिंग](../operate/monitoring) देखें। diff --git a/wiki/hi/install/docker.md b/wiki/hi/install/docker.md index 189b6411..922eddfd 100644 --- a/wiki/hi/install/docker.md +++ b/wiki/hi/install/docker.md @@ -11,14 +11,14 @@ Compose में अंतर्निहित HTTPS नहीं है। ## आवश्यकताएँ {#requirements} -| मद | आवश्यकता | -| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| इंजन | Compose प्लगइन के साथ Docker Engine (`docker compose`)। संगत compose प्रोवाइडर वाला Podman `--engine podman` के साथ संभव है, पर उसकी जाँच नहीं की गई | -| खाता | `root`, या `docker` समूह का कोई उपयोगकर्ता | -| बूट पर शुरू | कंटेनर इंजन बूट पर शुरू होना चाहिए, वरना रीस्टार्ट के बाद Arkvory वापस नहीं आता। `systemctl is-enabled docker` से जाँचें | -| होस्ट | प्रति कंटेनर होस्ट एक Arkvory इंस्टॉलेशन। प्रोजेक्ट नाम और पोर्ट तय हैं | -| खाली पोर्ट | `127.0.0.1` पर 8080 | -| कंटेनर | केवल Linux कंटेनर। Windows कंटेनर समर्थित नहीं हैं | +| मद | आवश्यकता | +| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| इंजन | Compose प्लगइन के साथ Docker Engine (`docker compose`)। संगत compose प्रोवाइडर वाला Podman `--engine podman` के साथ संभव है, पर उसकी जाँच नहीं की गई | +| खाता | `root`, या `docker` समूह का कोई उपयोगकर्ता | +| बूट पर शुरू | कंटेनर इंजन बूट पर शुरू होना चाहिए, वरना रीस्टार्ट के बाद Arkvory वापस नहीं आता। `systemctl is-enabled docker` से जाँचें | +| होस्ट | प्रति कंटेनर होस्ट एक Arkvory इंस्टॉलेशन। प्रोजेक्ट नाम और पोर्ट तय हैं | +| खाली पोर्ट | `127.0.0.1` पर 8080 | +| कंटेनर | केवल Linux कंटेनर। Windows कंटेनर समर्थित नहीं हैं | | इंटरनेट | `nodejs.org` (इंस्टॉलर Node.js 24.21.0 डाउनलोड करता है और उसका SHA-256 जाँचता है), अपडेट हब या GitHub (रिलीज़), और Docker Hub (`node:24.21.0-bookworm-slim` और `postgres:18.4`) | इंस्टॉलर कंटेनर इंजन, हाइपरवाइज़र या WSL इंस्टॉल या बदलता नहीं है। @@ -31,14 +31,14 @@ Compose में अंतर्निहित HTTPS नहीं है। ## कंटेनर {#containers} -| सेवा | इमेज | भूमिका | -| ------------- | ---------------------------- | --------------------------------------------------------------------------------------------------- | -| `database` | `postgres:18.4` | PostgreSQL। हर 5 सेकंड में `pg_isready` के साथ तैयार बताता है | -| `api` | `proanima-arkvory:` | HTTP API और कंसोल। `127.0.0.1:8080` पर प्रकाशित। हर 10 सेकंड में हेल्थ चेक | -| `worker` | `proanima-arkvory:` | अपलोड पूरा करता है और पृष्ठभूमि जॉब चलाता है। API के स्वस्थ होने के बाद शुरू होता है | +| सेवा | इमेज | भूमिका | +| ------------- | ---------------------------- | --------------------------------------------------------------------------------------- | +| `database` | `postgres:18.4` | PostgreSQL। हर 5 सेकंड में `pg_isready` के साथ तैयार बताता है | +| `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:` | एकबारगी: डेटाबेस माइग्रेशन चलाता है | +| `initialize` | `proanima-arkvory:` | एकबारगी, root के रूप में: स्टोरेज वॉल्यूम पर उपयोगकर्ता 1000 को स्वामित्व देता है | +| `migrate` | `proanima-arkvory:` | एकबारगी: डेटाबेस माइग्रेशन चलाता है | | `vault-owner` | `proanima-arkvory:` | एकबारगी, केवल `maintenance` प्रोफ़ाइल के साथ: बैकअप स्टोरेज पर उपयोगकर्ता 1000 को स्वामित्व देता है | लंबे समय तक चलने वाली सेवाएँ तब तक रीस्टार्ट होती हैं जब तक आप उन्हें न रोकें। Arkvory के कंटेनर इमेज के `node` उपयोगकर्ता (उपयोगकर्ता 1000) के रूप में चलते हैं, रीड-ओनली रूट फ़ाइल सिस्टम, मेमोरी में 64 MiB `/tmp`, सभी क्षमताएँ हटाई गईं, `no-new-privileges` और रुकने के लिए 120 सेकंड के साथ। Docker प्रत्येक कंटेनर के लिए 20 MiB की अधिकतम पाँच JSON लॉग फ़ाइलें रखता है। @@ -47,43 +47,43 @@ Compose में अंतर्निहित HTTPS नहीं है। ### Docker वॉल्यूम {#docker-volumes} -| वॉल्यूम | यहाँ माउंट | सामग्री | -| -------------------------- | ------------------------------------ | ----------------------------------------------------------------------- | -| `proanima-arkvory_storage` | `/var/lib/arkvory` | फ़ाइल सामग्री और अपलोड स्टेजिंग। बैकअप एजेंट इसे रीड-ओनली माउंट करता है | -| `proanima-arkvory_catalog` | `database` में `/var/lib/postgresql` | PostgreSQL डेटा | +| वॉल्यूम | यहाँ माउंट | सामग्री | +| -------------------------- | ---------------------------------- | ------------------------------------------------------------ | +| `proanima-arkvory_storage` | `/var/lib/arkvory` | फ़ाइल सामग्री और अपलोड स्टेजिंग। बैकअप एजेंट इसे रीड-ओनली माउंट करता है | +| `proanima-arkvory_catalog` | `database` में `/var/lib/postgresql` | 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 (केवल जब कोई रिपॉज़िटरी मिरर हो) | +| होस्ट पथ | कंटेनर में | मोड | यहाँ माउंट | +| ------------------------- | ------------------------------- | -------- | ---------------------------------------------------- | +| `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` | वह एकमात्र डायरेक्टरी जिसे कंटेनर होस्ट पर लिखता है। कंटेनर उपयोगकर्ता और होस्ट अपडेटर के user ID अलग हो सकते हैं | -| `updates/status` | `0755` | होस्ट अपडेटर द्वारा लिखा जाता है; कंटेनर इसे केवल पढ़ता है | -| स्टोरेज वॉल्यूम | उपयोगकर्ता 1000 | `initialize` इसे इंस्टॉल और अपडेट पर सेट करता है | -| बैकअप स्टोरेज | उपयोगकर्ता 1000 | बैकअप स्टोरेज जोड़ने पर `vault-owner` इसे सेट करता है। फिर बैकअप स्टोरेज ID 1000 वाले होस्ट उपयोगकर्ता का होता है | +| पथ | स्वामी और मोड | क्यों | +| ------------------------------------------------------ | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | +| इंस्टॉलेशन रूट | इंस्टॉल करने वाला उपयोगकर्ता, `0700` | रूट में पुनर्प्राप्ति कुंजी और डेटाबेस पासवर्ड रहता है। केवल इंस्टॉल करने वाला उपयोगकर्ता इसमें प्रवेश कर सकता है | +| `config/runtime.json`, `keys.json`, `health-token.txt` | `0644` | कंटेनर में उपयोगकर्ता 1000 को उन्हें पढ़ना है। `runtime.json` में डेटाबेस पासवर्ड रहता है; `0700` रूट दूसरे उपयोगकर्ताओं को इन फ़ाइलों से दूर रखता है | +| `updates/inbox` | `0777` | वह एकमात्र डायरेक्टरी जिसे कंटेनर होस्ट पर लिखता है। कंटेनर उपयोगकर्ता और होस्ट अपडेटर के user ID अलग हो सकते हैं | +| `updates/status` | `0755` | होस्ट अपडेटर द्वारा लिखा जाता है; कंटेनर इसे केवल पढ़ता है | +| स्टोरेज वॉल्यूम | उपयोगकर्ता 1000 | `initialize` इसे इंस्टॉल और अपडेट पर सेट करता है | +| बैकअप स्टोरेज | उपयोगकर्ता 1000 | बैकअप स्टोरेज जोड़ने पर `vault-owner` इसे सेट करता है। फिर बैकअप स्टोरेज ID 1000 वाले होस्ट उपयोगकर्ता का होता है | ## पोर्ट {#ports} -| पोर्ट | सेवा | एक्सपोज़र | -| -------- | ------------ | ------------------------------------------------------- | -| 8080/TCP | API और कंसोल | होस्ट पर `127.0.0.1:8080`। पता तय है | -| 5432/TCP | PostgreSQL | प्रकाशित नहीं। केवल Compose नेटवर्क के भीतर पहुँच योग्य | +| पोर्ट | सेवा | एक्सपोज़र | +| -------- | ----------- | ---------------------------------------------- | +| 8080/TCP | API और कंसोल | होस्ट पर `127.0.0.1:8080`। पता तय है | +| 5432/TCP | PostgreSQL | प्रकाशित नहीं। केवल Compose नेटवर्क के भीतर पहुँच योग्य | Compose फ़ाइल रिलीज़ डायरेक्टरी की होती है, जिसे अपडेट बदल देते हैं, इसलिए आप वहाँ प्रकाशित पता नहीं बदल सकते। दूसरे कंप्यूटरों से कंसोल तक पहुँचने के लिए, होस्ट पर रिवर्स प्रॉक्सी इंस्टॉल करें जो `127.0.0.1:8080` पर अग्रेषित करे। @@ -150,11 +150,11 @@ done यदि आप मौजूद कोई फ़ाइल छोड़ देते हैं, तो `up` कंटेनर को बिना बैकअप स्टोरेज या मिरर माउंट के फिर से बना देता है। -| कार्य | कमांड | -| ----------------- | ------------------------------------------------------------------------------- | -| कंटेनर दिखाएँ | `"${compose[@]}" ps` | -| लॉग पढ़ें | `"${compose[@]}" logs --tail 100 api worker backup` | -| Arkvory रोकें | `"${compose[@]}" stop --timeout 120 backup worker api` | +| कार्य | कमांड | +| ------------- | ------------------------------------------------------------------------------- | +| कंटेनर दिखाएँ | `"${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` से फिर शुरू करें। diff --git a/wiki/hi/install/https.md b/wiki/hi/install/https.md index fe988294..5fc4b95d 100644 --- a/wiki/hi/install/https.md +++ b/wiki/hi/install/https.md @@ -9,13 +9,13 @@ description: 'Arkvory को दूसरे कंप्यूटरों स ## तरीका चुनें {#choose} -| | अंतर्निहित TLS | रिवर्स प्रॉक्सी | -| ------------------------- | --------------------------------------------- | ---------------------------------------------------------- | -| इंस्टॉलेशन | Windows सेवाएँ और Linux (नेटिव)। Compose नहीं | सभी, और Compose के लिए एकमात्र तरीका | -| सेटअप | रोलबैक के साथ एक `arkvory configure` कमांड | प्रॉक्सी विन्यास, और Arkvory में `ARKVORY_TRUSTED_PROXIES` | -| पोर्ट | API पोर्ट, डिफ़ॉल्ट रूप से 8080 | कोई भी, जैसे 443 | -| प्रमाणपत्र नवीनीकरण | API नवीनीकृत फ़ाइलें स्वयं पढ़ता है | प्रॉक्सी द्वारा संभाला जाता है | -| क्लाइंट प्रमाणपत्र (mTLS) | समर्थित नहीं | प्रॉक्सी में संभव | +| | अंतर्निहित TLS | रिवर्स प्रॉक्सी | +| --------------------- | ----------------------------------------- | ----------------------------------------------------- | +| इंस्टॉलेशन | Windows सेवाएँ और Linux (नेटिव)। Compose नहीं | सभी, और Compose के लिए एकमात्र तरीका | +| सेटअप | रोलबैक के साथ एक `arkvory configure` कमांड | प्रॉक्सी विन्यास, और Arkvory में `ARKVORY_TRUSTED_PROXIES` | +| पोर्ट | API पोर्ट, डिफ़ॉल्ट रूप से 8080 | कोई भी, जैसे 443 | +| प्रमाणपत्र नवीनीकरण | API नवीनीकृत फ़ाइलें स्वयं पढ़ता है | प्रॉक्सी द्वारा संभाला जाता है | +| क्लाइंट प्रमाणपत्र (mTLS) | समर्थित नहीं | प्रॉक्सी में संभव | ## शुरू करने से पहले {#before-you-start} @@ -82,9 +82,9 @@ Linux पर सेवा खाता सामान्यतः 1024 से `configure` फ़ाइलें और पता सेट करता है। दो और सेटिंग्स `runtime.json` में हाथ से जाती हैं। उन्हें बदलने के बाद सेवाएँ रीस्टार्ट करें: [बदलाव लागू करें](./configuration#apply-change) देखें। -| वेरिएबल | डिफ़ॉल्ट | अर्थ | -| ---------------------------- | --------- | ----------------------------------------------------------------------------------------------------------- | -| `ARKVORY_TLS_MIN_VERSION` | `TLSv1.2` | `TLSv1.2` या `TLSv1.3` | +| वेरिएबल | डिफ़ॉल्ट | अर्थ | +| ---------------------------- | --------- | ----------------------------------------------------------------------------------------- | +| `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` होता है। @@ -117,17 +117,17 @@ sudo arkvory configure --root /opt/proanima-arkvory --tls-off --listen-host 127. ### प्रॉक्सी को क्या करना चाहिए {#proxy-requirements} -| आवश्यकता | क्यों | -| --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | -| किसी भी आकार का अनुरोध बॉडी स्वीकार करें (nginx में `client_max_body_size 0`) | फ़ाइलें दसियों गीगाबाइट या अधिक होती हैं। एक भाग 1 GiB तक का हो सकता है | -| अनुरोध या उत्तर बॉडी बफ़र न करें (`proxy_request_buffering off`, `proxy_buffering off`) | बाइट स्ट्रीम होकर गुज़रते हैं। बफ़रिंग प्रॉक्सी की डिस्क भर देती है और ट्रांसफ़र विलंबित करती है | -| कम से कम 1900 सेकंड के अनुरोध अनुमत करें (`proxy_read_timeout`, `proxy_send_timeout`) | एक अपलोड अनुरोध में 30 मिनट तक लग सकते हैं (`ARKVORY_UPLOAD_DEADLINE_MS`, डिफ़ॉल्ट रूप से 1 800 000 ms) | -| API से HTTP/1.1 बोलें और कनेक्शन बनाए रखें | स्ट्रीमिंग के लिए ज़रूरी | -| `Host` में सार्वजनिक नाम अग्रेषित करें | सर्वर उससे निरपेक्ष लिंक बनाता है, जैसे Git LFS और npm उत्तरों के लिंक | -| `X-Forwarded-For` और `X-Forwarded-Proto: https` भेजें | लॉग और साइन-इन सीमा के लिए क्लाइंट पता, और निरपेक्ष लिंक की योजना | -| `X-Request-Id` को अपने ID से अधिलेखित करें | API भरोसेमंद प्रॉक्सी से ID रखता है। क्लाइंट इसे नहीं चुन सकता | -| क्वेरी स्ट्रिंग को अपने एक्सेस लॉग में न लिखें | डाउनलोड लिंक `?token=` में एक सीक्रेट रखते हैं | -| यदि आप चाहें तो `Strict-Transport-Security` स्वयं सेट करें | API इसे केवल अंतर्निहित लिसनर से भेजता है | +| आवश्यकता | क्यों | +| ---------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | +| किसी भी आकार का अनुरोध बॉडी स्वीकार करें (nginx में `client_max_body_size 0`) | फ़ाइलें दसियों गीगाबाइट या अधिक होती हैं। एक भाग 1 GiB तक का हो सकता है | +| अनुरोध या उत्तर बॉडी बफ़र न करें (`proxy_request_buffering off`, `proxy_buffering off`) | बाइट स्ट्रीम होकर गुज़रते हैं। बफ़रिंग प्रॉक्सी की डिस्क भर देती है और ट्रांसफ़र विलंबित करती है | +| कम से कम 1900 सेकंड के अनुरोध अनुमत करें (`proxy_read_timeout`, `proxy_send_timeout`) | एक अपलोड अनुरोध में 30 मिनट तक लग सकते हैं (`ARKVORY_UPLOAD_DEADLINE_MS`, डिफ़ॉल्ट रूप से 1 800 000 ms) | +| API से HTTP/1.1 बोलें और कनेक्शन बनाए रखें | स्ट्रीमिंग के लिए ज़रूरी | +| `Host` में सार्वजनिक नाम अग्रेषित करें | सर्वर उससे निरपेक्ष लिंक बनाता है, जैसे Git LFS और npm उत्तरों के लिंक | +| `X-Forwarded-For` और `X-Forwarded-Proto: https` भेजें | लॉग और साइन-इन सीमा के लिए क्लाइंट पता, और निरपेक्ष लिंक की योजना | +| `X-Request-Id` को अपने ID से अधिलेखित करें | API भरोसेमंद प्रॉक्सी से ID रखता है। क्लाइंट इसे नहीं चुन सकता | +| क्वेरी स्ट्रिंग को अपने एक्सेस लॉग में न लिखें | डाउनलोड लिंक `?token=` में एक सीक्रेट रखते हैं | +| यदि आप चाहें तो `Strict-Transport-Security` स्वयं सेट करें | API इसे केवल अंतर्निहित लिसनर से भेजता है | ### nginx {#nginx} @@ -251,15 +251,15 @@ curl -i -X OPTIONS https://arkvory.example.com/api/v1/auth/me \ ## समस्या निवारण {#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 | बॉडी सीमा बहुत कम है। nginx में `client_max_body_size 0` इस्तेमाल करें | -| स्टेटस 502 या 504, या मिनटों बाद टूटा हुआ अपलोड | प्रॉक्सी बॉडी बफ़र करता है, या उसके टाइमआउट 1900 सेकंड से कम हैं | -| साइन-इन पर सभी सीमित हैं, या `clientIp` हमेशा प्रॉक्सी है | प्रॉक्सी `ARKVORY_TRUSTED_PROXIES` में नहीं है | -| Git LFS या npm उत्तरों में लिंक `http` या कोई आंतरिक नाम दिखाते हैं | प्रॉक्सी `Host` या `X-Forwarded-Proto: https` अग्रेषित नहीं करता | -| ब्राउज़र एप्लिकेशन को 403 `origin_not_allowed` मिलता है | उसका ओरिजिन `ARKVORY_CORS_ORIGINS` में जोड़ें और रीस्टार्ट करें | +| `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 | बॉडी सीमा बहुत कम है। nginx में `client_max_body_size 0` इस्तेमाल करें | +| स्टेटस 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/hi/install/index.md b/wiki/hi/install/index.md index 29470c9c..bfaeaeb4 100644 --- a/wiki/hi/install/index.md +++ b/wiki/hi/install/index.md @@ -15,13 +15,13 @@ Arkvory एक सर्वर पर चलता है। हर इंस् ## इंस्टॉलेशन के विकल्प {#installation-options} -| विकल्प | प्लेटफ़ॉर्म | बिना साइन-इन के रीबूट के बाद शुरू होता है | डेटाबेस | इंस्टॉलेशन के बाद स्वचालित अपडेट | किसके लिए अनुशंसित | -| ---------------------------------------------------------------------------------------------- | -------------------------------------------- | --------------------------------------------------------------------------------- | -------------------------------------------------------------------- | --------------------------------------------------- | -------------------------------------------------------------- | -| [ग्राफ़िकल इंस्टॉलर](./windows) `Arkvory-Setup-x64.exe` | Windows x64 | हाँ (Windows सेवाएँ) | साथ में आने वाला PostgreSQL 18.4, जिसे Arkvory प्रबंधित करता है | बंद | Windows सर्वर और वर्कस्टेशन, इंटरनेट एक्सेस के बिना इंस्टॉलेशन | -| [Linux पैकेज](./linux) `Arkvory-amd64.deb`, `Arkvory-x86_64.rpm` | systemd वाला Linux x64 | हाँ (systemd यूनिट) | आपके डिस्ट्रीब्यूशन का समर्पित PostgreSQL क्लस्टर (संस्करण 16 से 19) | बंद | Debian, Ubuntu और RPM-आधारित सर्वर | -| स्क्रिप्ट, नेटिव सेवाएँ: `install.sh` ([Linux](./linux)), `install.ps1` ([Windows](./windows)) | systemd वाला Linux x64 या arm64, Windows x64 | हाँ | आपका मौजूदा PostgreSQL सर्वर | बंद, या `--automatic` / `-AutomaticUpdates` से चालू | ऑटोमेशन, मौजूदा PostgreSQL सर्वर, Linux arm64 | -| [Docker Compose](./docker) | Docker Engine वाला Linux | हाँ, अगर कंटेनर इंजन बूट पर शुरू होता है | 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.4, जिसे Arkvory प्रबंधित करता है | बंद | Windows सर्वर और वर्कस्टेशन, इंटरनेट एक्सेस के बिना इंस्टॉलेशन | +| [Linux पैकेज](./linux) `Arkvory-amd64.deb`, `Arkvory-x86_64.rpm` | systemd वाला Linux x64 | हाँ (systemd यूनिट) | आपके डिस्ट्रीब्यूशन का समर्पित PostgreSQL क्लस्टर (संस्करण 16 से 19) | बंद | Debian, Ubuntu और RPM-आधारित सर्वर | +| स्क्रिप्ट, नेटिव सेवाएँ: `install.sh` ([Linux](./linux)), `install.ps1` ([Windows](./windows)) | systemd वाला Linux x64 या arm64, Windows x64 | हाँ | आपका मौजूदा PostgreSQL सर्वर | बंद, या `--automatic` / `-AutomaticUpdates` से चालू | ऑटोमेशन, मौजूदा PostgreSQL सर्वर, Linux arm64 | +| [Docker Compose](./docker) | Docker Engine वाला Linux | हाँ, अगर कंटेनर इंजन बूट पर शुरू होता है | PostgreSQL 18.4 कंटेनर | बंद, या `--automatic` से चालू | कंटेनर होस्ट | +| [Docker Desktop](./docker) | Windows x64 | नहीं। कंटेनर तभी चलते हैं जब उपयोगकर्ता साइन इन करे और Docker Desktop शुरू हो जाए | PostgreSQL 18.4 कंटेनर | बंद, या `-AutomaticUpdates` से चालू | वर्कस्टेशन पर मूल्यांकन | सभी विकल्प एक ही API, वर्कर और बैकअप एजेंट इंस्टॉल करते हैं। बिल्ट-इन HTTPS केवल नेटिव इंस्टॉलेशन के लिए उपलब्ध है। Compose इंस्टॉलेशन में HTTPS के लिए रिवर्स प्रॉक्सी चाहिए। [HTTPS और रिवर्स प्रॉक्सी](./https) देखें। @@ -29,10 +29,10 @@ Arkvory एक सर्वर पर चलता है। हर इंस् **Arkvory Remote Setup** क्लाइंट पैकेजों का हिस्सा है। यह व्यवस्थापक के कंप्यूटर पर चलता है, SSH से सर्वर से जुड़ता है और वहाँ नेटिव Linux या Windows पैकेज इंस्टॉल करता है। फिर यह स्वामी खाता बनाता है और निजी SSH टनल के ज़रिए कंसोल खोलता है। -| सर्वर | आवश्यकताएँ | -| ----------- | ------------------------------------------------------------------------------------------------------------ | +| सर्वर | आवश्यकताएँ | +| ----------- | ------------------------------------------------------------------------------------------------------- | | Linux x64 | SSH और SFTP, systemd, `apt-get` या `dnf`, root या ऐसा उपयोगकर्ता जिसके पास `sudo -n` हो (पासवर्ड माँगे बिना) | -| Windows x64 | SFTP के साथ OpenSSH Server, Windows PowerShell, एक व्यवस्थापक खाता | +| Windows x64 | SFTP के साथ OpenSSH Server, Windows PowerShell, एक व्यवस्थापक खाता | टनल केवल तब तक काम करती है जब तक Remote Setup चल रहा है। यह Arkvory को दूसरे कंप्यूटरों के लिए प्रकाशित नहीं करती। पासवर्ड से सुरक्षित `sudo`, SSH एजेंट, जंप होस्ट और ARM सर्वर समर्थित नहीं हैं। @@ -40,28 +40,28 @@ Arkvory एक सर्वर पर चलता है। हर इंस् रिलीज़ [github.com/ProAnima/Arkvory/releases](https://github.com/ProAnima/Arkvory/releases) पर प्रकाशित होती हैं। -| फ़ाइल | उद्देश्य | -| ----------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | +| फ़ाइल | उद्देश्य | +| ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | | `Arkvory-Setup-x64.exe` | Windows का ग्राफ़िकल इंस्टॉलर। इसमें Node.js, PostgreSQL, WinSW और Microsoft Visual C++ रनटाइम शामिल हैं | -| `Arkvory-amd64.deb`, `Arkvory-x86_64.rpm` | Linux पैकेज। इनमें Node.js शामिल है | -| `install.sh`, `install.ps1` | नेटिव सेवाओं या Docker Compose के लिए कमांड-लाइन इंस्टॉलर | -| `Arkvory-Linux.tar.gz`, `Arkvory-Windows.zip` | ऑटोमेशन किट: कमांड-लाइन इंस्टॉलर और रिलीज़ फ़ाइलें, GitHub Releases तक पहुँच के बिना इंस्टॉलेशन के लिए | -| `Arkvory-CLI-Setup-x64.exe`, `Arkvory-CLI-amd64.deb`, `Arkvory-CLI-x86_64.rpm` | क्लाइंट पैकेज: कमांड-लाइन क्लाइंट `arkvoryctl` और Arkvory Remote Setup | -| `arkvoryctl.mjs`, `arkvory-remote.mjs` | Node.js 24 के लिए वही क्लाइंट टूल, एक-एक फ़ाइल के रूप में | -| `arkvory-runtime.zip`, `arkvory-setup.mjs`, `arkvory-release.json`, `arkvory-release.json.sig`, `release-checksums.json`, `native-*.json` | प्रोग्राम फ़ाइलें, मैनिफ़ेस्ट, चेकसम और हस्ताक्षर। इंस्टॉलर और अपडेटर इन्हें पढ़ते हैं | +| `Arkvory-amd64.deb`, `Arkvory-x86_64.rpm` | Linux पैकेज। इनमें Node.js शामिल है | +| `install.sh`, `install.ps1` | नेटिव सेवाओं या Docker Compose के लिए कमांड-लाइन इंस्टॉलर | +| `Arkvory-Linux.tar.gz`, `Arkvory-Windows.zip` | ऑटोमेशन किट: कमांड-लाइन इंस्टॉलर और रिलीज़ फ़ाइलें, GitHub Releases तक पहुँच के बिना इंस्टॉलेशन के लिए | +| `Arkvory-CLI-Setup-x64.exe`, `Arkvory-CLI-amd64.deb`, `Arkvory-CLI-x86_64.rpm` | क्लाइंट पैकेज: कमांड-लाइन क्लाइंट `arkvoryctl` और Arkvory Remote Setup | +| `arkvoryctl.mjs`, `arkvory-remote.mjs` | Node.js 24 के लिए वही क्लाइंट टूल, एक-एक फ़ाइल के रूप में | +| `arkvory-runtime.zip`, `arkvory-setup.mjs`, `arkvory-release.json`, `arkvory-release.json.sig`, `release-checksums.json`, `native-*.json` | प्रोग्राम फ़ाइलें, मैनिफ़ेस्ट, चेकसम और हस्ताक्षर। इंस्टॉलर और अपडेटर इन्हें पढ़ते हैं | ## आवश्यकताएँ {#requirements} -| मद | आवश्यकता | -| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | -| 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 | -| Docker Compose | Compose प्लगइन के साथ Docker Engine, या Linux कंटेनर मोड में Docker Desktop। संगत compose प्रोवाइडर के साथ Podman भी संभव है | -| PostgreSQL | एक Arkvory इंस्टॉलेशन के लिए एक डेटाबेस। दो इंस्टॉलेशन को कभी एक ही डेटाबेस से न जोड़ें | -| फ़ाइल स्टोरेज | हार्ड लिंक का समर्थन करने वाला स्थानीय फ़ाइल सिस्टम। फ़ाइल स्टोरेज के लिए नेटवर्क शेयर इस्तेमाल न करें | -| बैकअप स्टोरेज (vault) | अलग वॉल्यूम, जो सेवाएँ शुरू होने से पहले माउंट हो चुका हो। [बैकअप](../operate/backups) देखें | +| मद | आवश्यकता | +| ----------------------- | ----------------------------------------------------------------------------------------------------------------- | +| 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 | +| Docker Compose | Compose प्लगइन के साथ Docker Engine, या Linux कंटेनर मोड में Docker Desktop। संगत compose प्रोवाइडर के साथ Podman भी संभव है | +| PostgreSQL | एक Arkvory इंस्टॉलेशन के लिए एक डेटाबेस। दो इंस्टॉलेशन को कभी एक ही डेटाबेस से न जोड़ें | +| फ़ाइल स्टोरेज | हार्ड लिंक का समर्थन करने वाला स्थानीय फ़ाइल सिस्टम। फ़ाइल स्टोरेज के लिए नेटवर्क शेयर इस्तेमाल न करें | +| बैकअप स्टोरेज (vault) | अलग वॉल्यूम, जो सेवाएँ शुरू होने से पहले माउंट हो चुका हो। [बैकअप](../operate/backups) देखें | Arkvory प्रोसेसर या मेमोरी की कोई निश्चित न्यूनतम सीमा तय नहीं करता। डिस्क स्पेस की योजना अपनी फ़ाइलों, डेटाबेस और बैकअप स्टोरेज के हिसाब से बनाएँ। डिफ़ॉल्ट रूप से Arkvory स्टोरेज वॉल्यूम पर 1 GiB खाली जगह रखता है और 10 TiB तक के आरक्षित अपलोड स्वीकार करता है। आप दोनों सीमाएँ बदल सकते हैं। [कॉन्फ़िगरेशन](./configuration) देखें। @@ -69,22 +69,22 @@ Arkvory प्रोसेसर या मेमोरी की कोई न ग्राफ़िकल इंस्टॉलर इंटरनेट एक्सेस के बिना काम करता है। बाकी विकल्प HTTPS से फ़ाइलें डाउनलोड करते हैं: -| होस्ट | कौन इस्तेमाल करता है | -| --------------------------------------------------------- | ----------------------------------------------------------------------------------------- | -| `nodejs.org` | `install.sh` और `install.ps1` Node.js 24.21.0 डाउनलोड करते हैं और उसका 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` Node.js 24.21.0 डाउनलोड करते हैं और उसका SHA-256 जाँचते हैं | +| `api.github.com`, `github.com` और GitHub के डाउनलोड होस्ट | स्क्रिप्ट इंस्टॉलर, और अपडेट तब जब अपडेट हब तक पहुँचा न जा सके | +| `hub.proanima.net` | अपडेट की जाँच और डाउनलोड। [अपडेट](./updates) देखें | +| Docker Hub | Compose अपनी इमेज `node:24.21.0-bookworm-slim` से बनाता है और `postgres:18.4` चलाता है | इंटरनेट एक्सेस के बिना रिलीज़ की स्थानीय प्रति से इंस्टॉल और अपडेट करें। [अपडेट](./updates) देखें। ## पोर्ट {#ports} -| पोर्ट | सेवा | डिफ़ॉल्ट एक्सपोज़र | -| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| 8080/TCP | API और कंसोल (HTTP, या बिल्ट-इन TLS के साथ HTTPS) | केवल `127.0.0.1`। HTTPS कॉन्फ़िगर करने के बाद नेटिव इंस्टॉलेशन दूसरे पतों पर भी कनेक्शन स्वीकार कर सकता है। Compose इसे हमेशा `127.0.0.1:8080` पर प्रकाशित करता है | -| 54329/TCP या 45329-45348/TCP | ग्राफ़िकल इंस्टॉलर और Linux पैकेजों का प्रबंधित PostgreSQL; इंस्टॉलेशन के दौरान पहला खाली पोर्ट लिया जाता है, Windows पर 49152 से नीचे | केवल `127.0.0.1` | -| 5432/TCP | Compose इंस्टॉलेशन का PostgreSQL कंटेनर | प्रकाशित नहीं। केवल Compose नेटवर्क के भीतर पहुँचा जा सकता है | +| पोर्ट | सेवा | डिफ़ॉल्ट एक्सपोज़र | +| ---------------------------- | --------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | +| 8080/TCP | API और कंसोल (HTTP, या बिल्ट-इन TLS के साथ HTTPS) | केवल `127.0.0.1`। HTTPS कॉन्फ़िगर करने के बाद नेटिव इंस्टॉलेशन दूसरे पतों पर भी कनेक्शन स्वीकार कर सकता है। Compose इसे हमेशा `127.0.0.1:8080` पर प्रकाशित करता है | +| 54329/TCP या 45329-45348/TCP | ग्राफ़िकल इंस्टॉलर और Linux पैकेजों का प्रबंधित PostgreSQL; इंस्टॉलेशन के दौरान पहला खाली पोर्ट लिया जाता है, Windows पर 49152 से नीचे | केवल `127.0.0.1` | +| 5432/TCP | Compose इंस्टॉलेशन का PostgreSQL कंटेनर | प्रकाशित नहीं। केवल Compose नेटवर्क के भीतर पहुँचा जा सकता है | क्लाइंट नेटवर्क के लिए केवल HTTPS पोर्ट खोलें। डेटाबेस का पोर्ट कभी न खोलें। @@ -92,19 +92,19 @@ Arkvory प्रोसेसर या मेमोरी की कोई न इंस्टॉलेशन रूट Windows पर `C:\ProgramData\ProAnima\Arkvory` और Linux पर `/opt/proanima-arkvory` है। होम डायरेक्टरी और उपयोगकर्ता प्रोफ़ाइल के बाहर एक समर्पित, खाली डायरेक्टरी इस्तेमाल करें। -| रूट में पथ | सामग्री | -| -------------------------------- | --------------------------------------------------------------------------------- | +| रूट में पथ | सामग्री | +| -------------------------------- | -------------------------------------------------------------------- | | `installation.json` | इंस्टॉल किया गया संस्करण, इंस्टॉलेशन मोड, स्वचालित अपडेट की सेटिंग और संस्करण पिन | -| `journal.json`, `operation.lock` | पिछले अपडेट की स्थिति, और चल रहे ऑपरेशन का लॉक | +| `journal.json`, `operation.lock` | पिछले अपडेट की स्थिति, और चल रहे ऑपरेशन का लॉक | | `launcher.mjs`, `manage.mjs` | सेवाएँ शुरू करते हैं और प्रबंधन कमांड चलाते हैं | -| `releases//` | हर इंस्टॉल किए गए संस्करण का प्रोग्राम कोड। सेवाएँ यहाँ नहीं लिखतीं | -| `runtime/` | Node.js। ग्राफ़िकल इंस्टॉलर यहीं PostgreSQL और WinSW भी रखता है | -| `config/` | सेटिंग्स, कुंजियाँ और पुनर्प्राप्ति कुंजी। [कॉन्फ़िगरेशन](./configuration) देखें | -| `data/` | नेटिव इंस्टॉलेशन का फ़ाइल स्टोरेज | -| `database/` | प्रबंधित PostgreSQL क्लस्टर। Windows पर उसके लॉग भी | -| `logs/` | Windows सेवाओं के लॉग और Windows अपडेटर का लॉग | -| `service/` | Windows सेवा रैपर | -| `updates/` | कंसोल से आए अपडेट अनुरोध और अपडेटर की स्थिति | +| `releases//` | हर इंस्टॉल किए गए संस्करण का प्रोग्राम कोड। सेवाएँ यहाँ नहीं लिखतीं | +| `runtime/` | Node.js। ग्राफ़िकल इंस्टॉलर यहीं PostgreSQL और WinSW भी रखता है | +| `config/` | सेटिंग्स, कुंजियाँ और पुनर्प्राप्ति कुंजी। [कॉन्फ़िगरेशन](./configuration) देखें | +| `data/` | नेटिव इंस्टॉलेशन का फ़ाइल स्टोरेज | +| `database/` | प्रबंधित PostgreSQL क्लस्टर। Windows पर उसके लॉग भी | +| `logs/` | Windows सेवाओं के लॉग और Windows अपडेटर का लॉग | +| `service/` | Windows सेवा रैपर | +| `updates/` | कंसोल से आए अपडेट अनुरोध और अपडेटर की स्थिति | Compose इंस्टॉलेशन अपना डेटा `data/` में नहीं, Docker वॉल्यूम `proanima-arkvory_storage` (फ़ाइलें) और `proanima-arkvory_catalog` (डेटाबेस) में रखता है। diff --git a/wiki/hi/install/linux.md b/wiki/hi/install/linux.md index 9d934d12..8d6af47e 100644 --- a/wiki/hi/install/linux.md +++ b/wiki/hi/install/linux.md @@ -14,18 +14,18 @@ Docker के लिए, [Docker Compose](./docker) देखें। कंस ## आवश्यकताएँ {#requirements} -| मद | आवश्यकता | -| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| प्रोसेसर | पैकेजों के लिए x64। arm64 पैकेज नहीं हैं: arm64 पर `install.sh` इस्तेमाल करें | -| इनिट सिस्टम | systemd। OpenRC, runit और अन्य इनिट सिस्टम समर्थित नहीं हैं | -| C लाइब्रेरी | glibc 2.28 या बाद का। Alpine Linux (musl) समर्थित नहीं है | -| परीक्षित वितरण | `.deb` के लिए Ubuntu 24.04, `.rpm` के लिए Fedora 44। नीचे दी गई निर्भरताएँ पूरी करने वाले अन्य 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` | +| मद | आवश्यकता | +| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| प्रोसेसर | पैकेजों के लिए x64। arm64 पैकेज नहीं हैं: arm64 पर `install.sh` इस्तेमाल करें | +| इनिट सिस्टम | systemd। OpenRC, runit और अन्य इनिट सिस्टम समर्थित नहीं हैं | +| C लाइब्रेरी | glibc 2.28 या बाद का। Alpine Linux (musl) समर्थित नहीं है | +| परीक्षित वितरण | `.deb` के लिए Ubuntu 24.04, `.rpm` के लिए Fedora 44। नीचे दी गई निर्भरताएँ पूरी करने वाले अन्य 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` चला सके | -| खाली पोर्ट | `127.0.0.1` पर 8080, और 54329 या 45329-45348 में से एक | -| फ़ाइल स्टोरेज | हार्ड लिंक समर्थित करने वाला स्थानीय फ़ाइल सिस्टम। नेटवर्क शेयर इस्तेमाल न करें | +| खाता | `root`, या ऐसा उपयोगकर्ता जो `sudo` चला सके | +| खाली पोर्ट | `127.0.0.1` पर 8080, और 54329 या 45329-45348 में से एक | +| फ़ाइल स्टोरेज | हार्ड लिंक समर्थित करने वाला स्थानीय फ़ाइल सिस्टम। नेटवर्क शेयर इस्तेमाल न करें | पैकेज में Node.js 24 है। इसे इंस्टॉल करने के लिए आपके पैकेज प्रबंधक की निर्भरताओं के अलावा किसी इंटरनेट पहुँच की ज़रूरत नहीं। @@ -63,31 +63,31 @@ sudo dnf install ./Arkvory-x86_64.rpm ### फ़ाइलें और डायरेक्टरियाँ {#files} -| पथ | सामग्री | -| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | -| `/usr/lib/proanima-arkvory/` | पैकेज पेलोड: Node.js, रिलीज़ फ़ाइलें और इंस्टॉलर। पैकेज के स्वामित्व में | -| `/usr/bin/arkvory` | प्रबंधन कमांड। [arkvory कमांड](#arkvory-command) देखें | -| `/usr/share/applications/arkvory.desktop` | मेनू प्रविष्टि जो डेस्कटॉप पर कंसोल खोलती है। बिना डेस्कटॉप वाला सर्वर इसे इस्तेमाल नहीं करता | +| पथ | सामग्री | +| --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | +| `/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` | सेवा यूनिट्स और अपडेट टाइमर | +| `/etc/systemd/system/arkvory-*.service`, `arkvory-update.timer` | सेवा यूनिट्स और अपडेट टाइमर | रूट `root:arkvory` के साथ मोड `0711` है। इसके भीतर, `config/` `0750 root:arkvory` है, `data/` और `logs/` `arkvory` के हैं, और `database/` मोड `0700` के साथ `arkvory-db` का है। पुनर्प्राप्ति कुंजी और डेटाबेस पासवर्ड फ़ाइलें केवल `root` पढ़ सकता है। ### खाते {#accounts} -| खाता | चलाता है | नोट्स | -| ------------ | ----------------------- | ----------------------------------------------------------------------- | -| `arkvory` | API, वर्कर, बैकअप एजेंट | सिस्टम खाता, कोई लॉगिन शेल नहीं, होम `/opt/proanima-arkvory/data` | -| `arkvory-db` | डेटाबेस | सिस्टम खाता, कोई लॉगिन शेल नहीं। API खाता डेटाबेस फ़ाइलें नहीं पढ़ सकता | +| खाता | चलाता है | नोट्स | +| ------------ | ------------------- | -------------------------------------------------------------- | +| `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-database` | `arkvory-db` | `on-failure`, 10 सेकंड बाद | +| `arkvory-api` | `arkvory` | `always`, 10 सेकंड बाद | +| `arkvory-worker` | `arkvory` | `always`, 10 सेकंड बाद | +| `arkvory-backup` | `arkvory` | `always`, 10 सेकंड बाद | | `arkvory-update.timer` | `root` के रूप में `arkvory-update.service` शुरू करता है | हर मिनट। जॉब अपडेट अनुरोध और रिलीज़ जाँचता है | सभी यूनिट्स बूट पर शुरू होती हैं (`multi-user.target`)। वे रुकने के लिए 120 सेकंड देती हैं। वे `NoNewPrivileges`, निजी `/tmp`, अपनी डायरेक्टरियों के बाहर रीड-ओनली फ़ाइल सिस्टम और `/home` तक कोई पहुँच के बिना चलती हैं। API और वर्कर रूट के केवल `data/`, `logs/` और `updates/inbox/` में लिख सकते हैं। बैकअप एजेंट स्टोरेज पढ़ता है और केवल बैकअप स्टोरेज में लिखता है। चूँकि `/home` यूनिट्स से छिपा है, प्रमाणपत्र, बैकअप स्टोरेज या डेटा डायरेक्टरी कभी होम डायरेक्टरी के अंतर्गत न रखें। @@ -96,9 +96,9 @@ sudo dnf install ./Arkvory-x86_64.rpm ### पोर्ट {#ports} -| पोर्ट | उपयोग | एक्सपोज़र | -| --------- | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | -| 8080/TCP | API और कंसोल | केवल `127.0.0.1`, जब तक आप [HTTPS](./https) कॉन्फ़िगर न करें | +| पोर्ट | उपयोग | एक्सपोज़र | +| --------- | ----------------------- | --------------------------------------------------------------------------------------------------------------------------- | +| 8080/TCP | API और कंसोल | केवल `127.0.0.1`, जब तक आप [HTTPS](./https) कॉन्फ़िगर न करें | | 54329/TCP | प्रबंधित PostgreSQL क्लस्टर | केवल `127.0.0.1`। इंस्टॉलेशन के समय 54329 लिया हुआ हो तो 45329-45348 में से पहला खाली पोर्ट; यह `database/settings.json` में रखा जाता है | ## पहला शुरू और शुरुआती चरण {#first-start} @@ -140,14 +140,14 @@ sudo arkvory status --root /opt/proanima-arkvory `status` इंस्टॉलेशन मोड, इंस्टॉल किया गया संस्करण, स्वचालित अपडेट सेटिंग और संस्करण पिन छापता है। -| कमांड | उपयोग | -| ----------------- | ------------------------------------------------------------------------------ | -| `status` | इंस्टॉल किया गया संस्करण और अपडेट नीति दिखाएँ | -| `update` | अभी कोई नया स्थिर रिलीज़ इंस्टॉल करें। [अपडेट](./updates) देखें | +| कमांड | उपयोग | +| ----------------- | ---------------------------------------------------------------------- | +| `status` | इंस्टॉल किया गया संस्करण और अपडेट नीति दिखाएँ | +| `update` | अभी कोई नया स्थिर रिलीज़ इंस्टॉल करें। [अपडेट](./updates) देखें | | `configure` | HTTPS, बैकअप स्टोरेज, मिरर, अपडेट नीति और हब। [विन्यास](./configuration) देखें | | `recover` | बाधित अपडेट पूरा करें। [अपडेट](./updates#recover-update) देखें | -| `finish-install` | बाधित इंस्टॉलेशन जारी रखें | -| `updates-connect` | पुराने रिलीज़ से अपडेट किए गए इंस्टॉलेशन के कंसोल और अपडेट टाइमर को जोड़ें | +| `finish-install` | बाधित इंस्टॉलेशन जारी रखें | +| `updates-connect` | पुराने रिलीज़ से अपडेट किए गए इंस्टॉलेशन के कंसोल और अपडेट टाइमर को जोड़ें | ## लॉग {#logs} @@ -236,11 +236,11 @@ sudo userdel arkvory-db स्क्रिप्ट `nodejs.org` से Node.js 24.21.0 डाउनलोड करती है, उसका SHA-256 जाँचती है और नवीनतम स्थिर रिलीज़ इंस्टॉल करती है। स्वचालित अपडेट बंद रखने के लिए `--automatic` छोड़ दें। एनवायरनमेंट वेरिएबल डिफ़ॉल्ट बदलते हैं: -| वेरिएबल | अर्थ | डिफ़ॉल्ट | -| ------------------------- | ------------------------------------------------------------------------- | ----------------------- | +| वेरिएबल | अर्थ | डिफ़ॉल्ट | +| ------------------------- | ------------------------------------------------------------- | ----------------------- | | `ARKVORY_INSTALL_ROOT` | इंस्टॉलेशन रूट। `/home` के बाहर एक समर्पित, खाली डायरेक्टरी इस्तेमाल करें | `/opt/proanima-arkvory` | -| `ARKVORY_RELEASE_VERSION` | नवीनतम के बजाय यह स्थिर संस्करण इंस्टॉल करें | नवीनतम स्थिर | -| `ARKVORY_ARTIFACT_DIR` | GitHub के बजाय खोले गए `Arkvory-Linux.tar.gz` से इंस्टॉल करें | सेट नहीं | +| `ARKVORY_RELEASE_VERSION` | नवीनतम के बजाय यह स्थिर संस्करण इंस्टॉल करें | नवीनतम स्थिर | +| `ARKVORY_ARTIFACT_DIR` | GitHub के बजाय खोले गए `Arkvory-Linux.tar.gz` से इंस्टॉल करें | सेट नहीं | उन्हें `sudo env` के माध्यम से पास करें, उदाहरण के लिए `sudo env ARKVORY_INSTALL_ROOT=/srv/arkvory bash ./install.sh`। @@ -255,14 +255,14 @@ sudo "$root/runtime/node-v24.21.0-linux-x64/bin/node" "$root/manage.mjs" status ## समस्या निवारण {#troubleshooting} -| समस्या | क्या करें | -| ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `PostgreSQL 16–19 server binaries are required` | PostgreSQL प्रोग्राम गायब हैं या बहुत पुराने हैं। संस्करण 16 से 19 का PostgreSQL सर्वर इंस्टॉल करें और पैकेज फिर से इंस्टॉल करें | +| समस्या | क्या करें | +| ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `PostgreSQL 16–19 server binaries are required` | PostgreSQL प्रोग्राम गायब हैं या बहुत पुराने हैं। संस्करण 16 से 19 का PostgreSQL सर्वर इंस्टॉल करें और पैकेज फिर से इंस्टॉल करें | | `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` exists, but `database/initialized` does not | डेटाबेस निर्माण बाधित हुआ। क्लस्टर न हटाएँ और हाथ से SQL दोहराएँ नहीं। कारण ठीक करें और `sudo arkvory finish-install --root /opt/proanima-arkvory` चलाएँ | -| सेवा शुरू नहीं होती | `journalctl -u arkvory-api -n 100`. शुरू होने की विफलता सेटिंग का नाम बताने वाला, उसका मान कभी नहीं, एक JSON रिकॉर्ड `reason` के साथ छापती है | -| पोर्ट 8080 लिया हुआ | कोई दूसरा प्रोग्राम इसे इस्तेमाल कर रहा है। पोर्ट खाली करें, या `config/runtime.json` में `ARKVORY_PORT` सेट करें। [विन्यास](./configuration#address-and-port) देखें। डेटाबेस पोर्ट वही है जो इंस्टॉलेशन के समय चुना गया (54329 या 45329-45348); यह अपने आप नहीं बदलता | +| `Installation is locked` | कोई ऑपरेशन चल रहा है या क्रैश हो गया। अपडेट टाइमर रोकें, रूट में `journal.json` पढ़ें और स्थिति जानने से पहले `operation.lock` न हटाएँ। [अपडेट](./updates#recover-update) देखें | +| `database/bootstrap-started` exists, but `database/initialized` does not | डेटाबेस निर्माण बाधित हुआ। क्लस्टर न हटाएँ और हाथ से SQL दोहराएँ नहीं। कारण ठीक करें और `sudo arkvory finish-install --root /opt/proanima-arkvory` चलाएँ | +| सेवा शुरू नहीं होती | `journalctl -u arkvory-api -n 100`. शुरू होने की विफलता सेटिंग का नाम बताने वाला, उसका मान कभी नहीं, एक JSON रिकॉर्ड `reason` के साथ छापती है | +| पोर्ट 8080 लिया हुआ | कोई दूसरा प्रोग्राम इसे इस्तेमाल कर रहा है। पोर्ट खाली करें, या `config/runtime.json` में `ARKVORY_PORT` सेट करें। [विन्यास](./configuration#address-and-port) देखें। डेटाबेस पोर्ट वही है जो इंस्टॉलेशन के समय चुना गया (54329 या 45329-45348); यह अपने आप नहीं बदलता | यदि इंस्टॉलेशन `installation.json` लिखने के बाद रुका, तो आप पैकेज का विन्यास चरण भी दोहरा सकते हैं: Debian और Ubuntu पर `sudo dpkg --configure -a`, या RPM सिस्टम पर वही पैकेज फिर से इंस्टॉल करें। diff --git a/wiki/hi/install/updates.md b/wiki/hi/install/updates.md index 677f2799..5df976e5 100644 --- a/wiki/hi/install/updates.md +++ b/wiki/hi/install/updates.md @@ -67,12 +67,12 @@ sudo arkvory update --root /opt/proanima-arkvory --version 1.2.3 उन्हें कंसोल या `arkvory configure --root --disable-updates` से बंद करें। -| नियम | मान | -| ---------------- | ----------------------------------------------------------------------------------------------- | -| विंडो | चुना गया UTC घंटा। डिफ़ॉल्ट 03:00 से 03:59 UTC है। केवल कंसोल घंटा सेट करता है | -| प्रयास | प्रति UTC दिन अधिकतम एक, चाहे सफल हो या विफल। छूटी हुई विंडो की भरपाई दिन में बाद में नहीं होती | -| छोड़ा जाता है जब | संस्करण पिन हो, अंतिम जाँच विफल हो, या कोई नया रिलीज़ ज्ञात न हो | -| रिलीज़ | अंतिम जाँच पर हब द्वारा स्वीकृत नवीनतम रिलीज़ | +| नियम | मान | +| -------------- | ------------------------------------------------------------------------------------- | +| विंडो | चुना गया UTC घंटा। डिफ़ॉल्ट 03:00 से 03:59 UTC है। केवल कंसोल घंटा सेट करता है | +| प्रयास | प्रति UTC दिन अधिकतम एक, चाहे सफल हो या विफल। छूटी हुई विंडो की भरपाई दिन में बाद में नहीं होती | +| छोड़ा जाता है जब | संस्करण पिन हो, अंतिम जाँच विफल हो, या कोई नया रिलीज़ ज्ञात न हो | +| रिलीज़ | अंतिम जाँच पर हब द्वारा स्वीकृत नवीनतम रिलीज़ | अपने बैकअप अपडेट विंडो के बाहर शेड्यूल करें। अपडेट बैकअप एजेंट रोकता है, और चल रहा बैकअप बाधित होकर फिर कतार में लग जाता है। @@ -148,11 +148,11 @@ sudo arkvory configure --root --unpin ### सर्वर हब को क्या भेजता है {#hub-data} -| कब | क्या भेजा जाता है | -| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| अपडेट जाँच, हर 6 घंटे या अनुरोध पर | प्रोजेक्ट `arkvory` के अपडेट के लिए अनुरोध, साथ में इंस्टॉल किया गया संस्करण, ऑपरेटिंग सिस्टम (`linux` या `windows`), प्रोसेसर (`x86_64` या `aarch64`) और चैनल। सांख्यिकी चालू होने पर, एक यादृच्छिक इंस्टॉलेशन ID वाला हेडर `X-Install-Id` जोड़ा जाता है | -| अपडेट पूरा हुआ, सांख्यिकी चालू होने पर | इंस्टॉलेशन ID, नया संस्करण, ऑपरेटिंग सिस्टम, प्रोसेसर और चैनल वाला एक `updated` इवेंट | -| रिलीज़ का डाउनलोड | हब GitHub के लिंक के साथ उत्तर देता है। फ़ाइलें वहीं से आती हैं | +| कब | क्या भेजा जाता है | +| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| अपडेट जाँच, हर 6 घंटे या अनुरोध पर | प्रोजेक्ट `arkvory` के अपडेट के लिए अनुरोध, साथ में इंस्टॉल किया गया संस्करण, ऑपरेटिंग सिस्टम (`linux` या `windows`), प्रोसेसर (`x86_64` या `aarch64`) और चैनल। सांख्यिकी चालू होने पर, एक यादृच्छिक इंस्टॉलेशन ID वाला हेडर `X-Install-Id` जोड़ा जाता है | +| अपडेट पूरा हुआ, सांख्यिकी चालू होने पर | इंस्टॉलेशन ID, नया संस्करण, ऑपरेटिंग सिस्टम, प्रोसेसर और चैनल वाला एक `updated` इवेंट | +| रिलीज़ का डाउनलोड | हब GitHub के लिंक के साथ उत्तर देता है। फ़ाइलें वहीं से आती हैं | कोई कुंजी, खाता, होस्ट नाम या सहेजी गई सामग्री नहीं भेजी जाती, और कोई क्रेडेंशियल हब तक नहीं पहुँचता। इंस्टॉलेशन ID एक यादृच्छिक मान है जो इंस्टॉलेशन के अलावा और कुछ नहीं पहचानता। प्रोजेक्ट के अनुसार, हब कोई IP पते, नाम या सामग्री संग्रहीत नहीं करता। हब को वह फ़ीडबैक भी मिलता है जो उपयोगकर्ता कंसोल से भेजता है। वह उपयोगकर्ता की अलग कार्रवाई है। @@ -160,11 +160,11 @@ sudo arkvory configure --root --unpin ### विकल्प {#hub-options} -| सेटिंग | डिफ़ॉल्ट | इसे बदलें | -| --------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | -| सांख्यिकी | चालू | कंसोल: [[ui:updateSettings]] के अंतर्गत [[ui:updateStatistics]]। कमांड: `--statistics off` या `--statistics on` | -| चैनल | `stable` | ProAnimaStudio जो संस्करण पहले देता है उन्हें पाने के लिए `--update-channel beta`, लौटने के लिए `--update-channel stable` | -| हब पता | `https://hub.proanima.net` | अपने स्वयं के हब के लिए `--hub-url https://hub.example`, केवल GitHub इस्तेमाल करने के लिए `--hub-off`। पते में HTTPS होना चाहिए | +| सेटिंग | डिफ़ॉल्ट | इसे बदलें | +| ------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------ | +| सांख्यिकी | चालू | कंसोल: [[ui:updateSettings]] के अंतर्गत [[ui:updateStatistics]]। कमांड: `--statistics off` या `--statistics on` | +| चैनल | `stable` | ProAnimaStudio जो संस्करण पहले देता है उन्हें पाने के लिए `--update-channel beta`, लौटने के लिए `--update-channel stable` | +| हब पता | `https://hub.proanima.net` | अपने स्वयं के हब के लिए `--hub-url https://hub.example`, केवल GitHub इस्तेमाल करने के लिए `--hub-off`। पते में HTTPS होना चाहिए | ये सभी `arkvory configure --root ` के विकल्प हैं और बिना रीस्टार्ट के प्रभावी होते हैं। सेटिंग्स `config/hub.json` में संग्रहीत होती हैं। हब पते का बदलाव यह भी बदल देता है कि कंसोल फ़ीडबैक कहाँ भेजता है, सेवाओं के अगले रीस्टार्ट के बाद। @@ -226,19 +226,19 @@ sudo arkvory configure --root --unpin ## समस्या निवारण {#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` चलाएँ | +| आप क्या देखते हैं | क्या करें | +| ------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| पृष्ठ कहता है कि होस्ट अपडेटर जुड़ा नहीं है | रखरखाव विंडो में `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) में हैं। diff --git a/wiki/hi/install/windows.md b/wiki/hi/install/windows.md index fdf72628..e94e6dd1 100644 --- a/wiki/hi/install/windows.md +++ b/wiki/hi/install/windows.md @@ -48,18 +48,18 @@ Windows पर Arkvory चलाने के तीन तरीके है ## ग्राफ़िकल इंस्टॉलर क्या बनाता है {#what-the-graphical-installer-creates} -| मद | स्थान या मान | -| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -| प्रोग्राम फ़ाइलें | `C:\Program Files\ProAnima\Arkvory` | -| डेटा, कॉन्फ़िगरेशन और लॉग | `C:\ProgramData\ProAnima\Arkvory` (इंस्टॉलेशन रूट) | -| डेटाबेस | रूट के `database\` में PostgreSQL 18.4, `127.0.0.1` पर 45329-45348 के पहले खाली पोर्ट पर, जिसे Windows द्वारा बूट के समय आरक्षित पोर्ट से बाहर रखा गया है | -| कंसोल | `http://127.0.0.1:8080/console/` | -| पुनर्प्राप्ति कुंजी | रूट में `config\bootstrap-token.txt` | -| अपडेट टास्क | Task Scheduler में `ProAnimaArkvoryUpdate`। हर मिनट SYSTEM के रूप में चलता है | +| मद | स्थान या मान | +| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | +| प्रोग्राम फ़ाइलें | `C:\Program Files\ProAnima\Arkvory` | +| डेटा, कॉन्फ़िगरेशन और लॉग | `C:\ProgramData\ProAnima\Arkvory` (इंस्टॉलेशन रूट) | +| डेटाबेस | रूट के `database\` में PostgreSQL 18.4, `127.0.0.1` पर 45329-45348 के पहले खाली पोर्ट पर, जिसे Windows द्वारा बूट के समय आरक्षित पोर्ट से बाहर रखा गया है | +| कंसोल | `http://127.0.0.1:8080/console/` | +| पुनर्प्राप्ति कुंजी | रूट में `config\bootstrap-token.txt` | +| अपडेट टास्क | Task Scheduler में `ProAnimaArkvoryUpdate`। हर मिनट SYSTEM के रूप में चलता है | ### सेवाएँ {#services} -| सेवा का नाम | प्रदर्शित नाम | खाता | स्टार्टअप प्रकार | +| सेवा का नाम | प्रदर्शित नाम | खाता | स्टार्टअप प्रकार | | ----------------- | ------------------------- | ----------------------------- | ------------------------- | | `Arkvoryapi` | ProAnima Arkvory api | `NT AUTHORITY\LocalService` | Automatic (Delayed Start) | | `Arkvoryworker` | ProAnima Arkvory worker | `NT AUTHORITY\LocalService` | Automatic (Delayed Start) | @@ -96,16 +96,16 @@ Windows पर Arkvory चलाने के तीन तरीके है अगर PowerShell स्क्रिप्ट रोक दे, तो `powershell -ExecutionPolicy Bypass -File .\install.ps1` चलाएँ। इससे नीति केवल इसी प्रोसेस के लिए बदलती है। -| पैरामीटर | अर्थ | -| ---------------------------- | ------------------------------------------------------------- | -| `-Root ` | इंस्टॉलेशन रूट। डिफ़ॉल्ट: `C:\ProgramData\ProAnima\Arkvory` | -| `-Version ` | नवीनतम की जगह यह स्थिर संस्करण इंस्टॉल करें | -| `-Mode windows` या `compose` | Windows सेवाएँ (डिफ़ॉल्ट) या [Docker Compose](./docker) | -| `-Engine docker` या `podman` | Compose के लिए कंटेनर इंजन | -| `-Config ` | `ARKVORY_*` सेटिंग्स वाली JSON फ़ाइल, डेटाबेस URL सहित | +| पैरामीटर | अर्थ | +| ---------------------------- | -------------------------------------------------------- | +| `-Root ` | इंस्टॉलेशन रूट। डिफ़ॉल्ट: `C:\ProgramData\ProAnima\Arkvory` | +| `-Version ` | नवीनतम की जगह यह स्थिर संस्करण इंस्टॉल करें | +| `-Mode windows` या `compose` | Windows सेवाएँ (डिफ़ॉल्ट) या [Docker Compose](./docker) | +| `-Engine docker` या `podman` | Compose के लिए कंटेनर इंजन | +| `-Config ` | `ARKVORY_*` सेटिंग्स वाली JSON फ़ाइल, डेटाबेस URL सहित | | `-Artifact ` | GitHub की जगह निकाली गई `Arkvory-Windows.zip` से इंस्टॉल करें | | `-AutomaticUpdates` | स्वचालित अपडेट चालू करें | -| `-Pin` | इंस्टॉल किए गए संस्करण को पिन करें | +| `-Pin` | इंस्टॉल किए गए संस्करण को पिन करें | `-Root`, `-Config` और `-Artifact` को पूर्ण पथ के रूप में दें, उदाहरण के लिए `-Artifact $PWD.Path`। @@ -142,12 +142,12 @@ $root = 'C:\ProgramData\ProAnima\Arkvory' ## लॉग {#logs} -| रूट में स्थान | सामग्री | -| ------------------ | ---------------------------------------------------------------------------------------------------- | +| रूट में स्थान | सामग्री | +| ------------------ | ----------------------------------------------------------------------------------- | | `logs\` | API, वर्कर और बैकअप एजेंट का आउटपुट। फ़ाइलें 20 MiB पर रोटेट होती हैं; 5 पुरानी फ़ाइलें रखी जाती हैं | -| `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` नहीं है | डेटाबेस बनाने का काम बीच में रुक गया। क्लस्टर न हटाएँ और SQL हाथ से दोबारा न चलाएँ। कारण ठीक करें और `finish-install` कमांड चलाएँ | -| `Run installer as Administrator` | PowerShell को **Run as administrator** (व्यवस्थापक के रूप में चलाएँ) से शुरू करें | -| `Use a dedicated directory` | रूट में पहले से फ़ाइलें हैं। खाली डायरेक्टरी इस्तेमाल करें। मौजूदा इंस्टॉलेशन को उसके अपने कमांड से प्रबंधित करें | -| `Node.js runtime is incomplete after extraction` | अपने एंटीवायरस सॉफ़्टवेयर का क्वारंटीन जाँचें | -| `Another installation owns this service` | किसी दूसरे रूट के इंस्टॉलेशन की सेवाएँ मौजूद हैं। पहले उन्हें हटाएँ | +| `Run installer as Administrator` | PowerShell को **Run as administrator** (व्यवस्थापक के रूप में चलाएँ) से शुरू करें | +| `Use a dedicated directory` | रूट में पहले से फ़ाइलें हैं। खाली डायरेक्टरी इस्तेमाल करें। मौजूदा इंस्टॉलेशन को उसके अपने कमांड से प्रबंधित करें | +| `Node.js runtime is incomplete after extraction` | अपने एंटीवायरस सॉफ़्टवेयर का क्वारंटीन जाँचें | +| `Another installation owns this service` | किसी दूसरे रूट के इंस्टॉलेशन की सेवाएँ मौजूद हैं। पहले उन्हें हटाएँ | डेटा हटाए बिना अधूरा इंस्टॉलेशन पूरा करने के लिए: diff --git a/wiki/hi/operate/backups.md b/wiki/hi/operate/backups.md index fbbae872..94107445 100644 --- a/wiki/hi/operate/backups.md +++ b/wiki/hi/operate/backups.md @@ -47,14 +47,14 @@ description: 'बैकअप स्टोरेज (vault) कनेक्ट ### आवश्यकताएँ {#vault-requirements} -| आवश्यकता | क्यों | -| -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| एक नई या खाली डायरेक्टरी, सेवाएँ शुरू होने से पहले माउंट की गई | एजेंट वहाँ `vault.json` और पुनर्स्थापना बिंदु लिखता है | +| आवश्यकता | क्यों | +| ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| एक नई या खाली डायरेक्टरी, सेवाएँ शुरू होने से पहले माउंट की गई | एजेंट वहाँ `vault.json` और पुनर्स्थापना बिंदु लिखता है | | इंस्टॉलेशन डायरेक्टरी के बाहर और स्टोरेज डायरेक्टरी के बाहर, links, junctions और short names के ज़रिए भी | स्टोरेज के अंदर बना vault उसके साथ ही चला जाता है। जाँच ऐसे पथ को अस्वीकार करती है जो उन्हें समाहित करता है या उनके अंदर है। यही हर [स्टोरेज वॉल्यूम](./storage#volumes) पर लागू होता है। | -| सेवा खाते द्वारा लिखने योग्य | Linux पर `arkvory`। Windows पर `NT AUTHORITY\LocalService`। `arkvory configure` आपके लिए अधिकार सेट करता है | -| कॉपी किए जा रहे डेटा के अतिरिक्त कम से कम 1 GiB खाली जगह | vault यह आरक्षित जगह रखता है। भरा हुआ वॉल्यूम बैकअप को `vault_full` के साथ समाप्त करता है, और पहले के बिंदु बरकरार रहते हैं | -| Linux पर, `/home`, `/root`, `/run/user`, `/tmp` या `/var/tmp` के अंतर्गत नहीं | सेवा का sandbox इन वृक्षों को छिपा देता है | -| Windows पर, ड्राइव अक्षर वाला स्थानीय या iSCSI वॉल्यूम | `LocalService` SMB शेयर में साइन इन नहीं कर सकता, इसलिए `\\nas\share` जैसे पथ अस्वीकार कर दिए जाते हैं | +| सेवा खाते द्वारा लिखने योग्य | Linux पर `arkvory`। Windows पर `NT AUTHORITY\LocalService`। `arkvory configure` आपके लिए अधिकार सेट करता है | +| कॉपी किए जा रहे डेटा के अतिरिक्त कम से कम 1 GiB खाली जगह | vault यह आरक्षित जगह रखता है। भरा हुआ वॉल्यूम बैकअप को `vault_full` के साथ समाप्त करता है, और पहले के बिंदु बरकरार रहते हैं | +| Linux पर, `/home`, `/root`, `/run/user`, `/tmp` या `/var/tmp` के अंतर्गत नहीं | सेवा का sandbox इन वृक्षों को छिपा देता है | +| Windows पर, ड्राइव अक्षर वाला स्थानीय या iSCSI वॉल्यूम | `LocalService` SMB शेयर में साइन इन नहीं कर सकता, इसलिए `\\nas\share` जैसे पथ अस्वीकार कर दिए जाते हैं | किसी दूसरी डिस्क या NAS पर वॉल्यूम इस्तेमाल करें, ताकि स्टोरेज डिस्क विफल होने पर बैकअप साथ न चले जाएँ। स्टोरेज की उसी भौतिक डिस्क पर बना vault गलतियों से बचाता है, डिस्क विफलता से नहीं। @@ -86,12 +86,12 @@ arkvory-backup vault key verify --vault /mnt/backup/arkvory --key-file /root/ark हर कुंजी एक स्लॉट की होती है, और हर स्लॉट अपनी कुंजी से vault खोलता है। ये कमांड स्लॉट बदलती हैं। कोई भी कुंजी नहीं दिखाती: -| कमांड | प्रभाव | -| ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `vault key list --vault DIR` | स्लॉट सूचीबद्ध करती है: id, प्रकार (`agent` या `recovery`) और बनने का समय। कुंजी नहीं चाहिए। | -| `vault key add-recovery --vault DIR --key-file KEY --kit-file NEW` | रिकवरी स्लॉट जोड़ती है और उसका किट लिखती है, किसी दूसरे व्यक्ति या दूसरी तिजोरी के लिए। | +| कमांड | प्रभाव | +| ------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `vault key list --vault DIR` | स्लॉट सूचीबद्ध करती है: id, प्रकार (`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` | स्लॉट हटाती है। आख़िरी स्लॉट और आख़िरी रिकवरी स्लॉट बने रहते हैं। | +| `vault key remove --vault DIR --key-file KEY --slot ID` | स्लॉट हटाती है। आख़िरी स्लॉट और आख़िरी रिकवरी स्लॉट बने रहते हैं। | स्लॉट हटाने से वह vault उस व्यक्ति के लिए बंद हो जाता है जिसके पास केवल वही कुंजी है। इससे पुराने पॉइंट दोबारा एन्क्रिप्ट नहीं होते: जिसने पहले vault और कोई कुंजी कॉपी की थी, वह उस प्रति को अब भी पढ़ सकता है। यदि कोई कुंजी लीक हुई हो सकती है, तो नई कुंजियों के साथ नया vault बनाएँ और वहाँ नए पॉइंट शुरू करें। @@ -142,12 +142,12 @@ sudo mount -t cifs //nas/arkvory /mnt/backup/arkvory \ [[ui:backups]] खोलें और [[ui:backupPlan]] इस्तेमाल करें। आपको बैकअप प्रबंधित करने का अधिकार चाहिए। इसके बिना फ़ॉर्म [[ui:backupReadOnly]] दिखाता है। -| सेटिंग | अर्थ | डिफ़ॉल्ट | -| ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | -------- | -| [[ui:backupEnabled]] | दैनिक योजना चालू करता है। इसे चालू करने से बैकअप तुरंत शुरू नहीं होता | बंद | -| [[ui:backupTime]] | दैनिक बैकअप का स्थानीय समय, मिनट तक | 02:00 | -| [[ui:backupTimezone]] | उस स्थानीय समय का IANA समय क्षेत्र, जैसे `Europe/Moscow` या `UTC`। `+03:00` जैसे offsets स्वीकार नहीं किए जाते | `UTC` | -| [[ui:backupDaily]], [[ui:backupWeekly]], [[ui:backupMonthly]] | कितने दिनों, हफ़्तों और महीनों के पुनर्स्थापना बिंदु रखने हैं। [प्रतिधारण](#retention) देखें। सीमाएँ: 0–366, 0–260, 0–120 | 7, 4, 6 | +| सेटिंग | अर्थ | डिफ़ॉल्ट | +| ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | ------- | +| [[ui:backupEnabled]] | दैनिक योजना चालू करता है। इसे चालू करने से बैकअप तुरंत शुरू नहीं होता | बंद | +| [[ui:backupTime]] | दैनिक बैकअप का स्थानीय समय, मिनट तक | 02:00 | +| [[ui:backupTimezone]] | उस स्थानीय समय का IANA समय क्षेत्र, जैसे `Europe/Moscow` या `UTC`। `+03:00` जैसे offsets स्वीकार नहीं किए जाते | `UTC` | +| [[ui:backupDaily]], [[ui:backupWeekly]], [[ui:backupMonthly]] | कितने दिनों, हफ़्तों और महीनों के पुनर्स्थापना बिंदु रखने हैं। [प्रतिधारण](#retention) देखें। सीमाएँ: 0–366, 0–260, 0–120 | 7, 4, 6 | [[ui:backupPlanSave]] चुनें। अगर इस बीच किसी और ने योजना बदली हो, तो कंसोल वर्तमान योजना लोड करता है, और आप उसे देखकर फिर से सहेजते हैं। @@ -184,10 +184,10 @@ sudo mount -t cifs //nas/arkvory /mnt/backup/arkvory \ सत्यापन दो प्रकार के होते हैं: -| प्रकार | यह क्या जाँचता है | यह कब चलता है | -| ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| त्वरित (कंसोल [[ui:backupVerifyStructural]] कहता है) | बिंदु की हर फ़ाइल को उसके manifest के digest से मिलाता है, और यह कि हर संग्रहीत फ़ाइल सही आकार के साथ मौजूद है | हर बैकअप के बाद अपने-आप | -| पूर्ण ([[ui:backupVerifyDeep]]) | त्वरित जाँचें, और यह हर संग्रहीत फ़ाइल पढ़कर उसका SHA-256 जाँचता है | सबसे नए बिंदु के लिए हर 7 दिन में एक बार अपने-आप। अनुरोध पर [[ui:backupVerifyDeepAction]], `arkvoryctl backup verify POINT_ID` या `arkvory-backup verify --deep` के साथ | +| प्रकार | यह क्या जाँचता है | यह कब चलता है | +| ------------------------------------------------- | ------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| त्वरित (कंसोल [[ui:backupVerifyStructural]] कहता है) | बिंदु की हर फ़ाइल को उसके manifest के digest से मिलाता है, और यह कि हर संग्रहीत फ़ाइल सही आकार के साथ मौजूद है | हर बैकअप के बाद अपने-आप | +| पूर्ण ([[ui:backupVerifyDeep]]) | त्वरित जाँचें, और यह हर संग्रहीत फ़ाइल पढ़कर उसका SHA-256 जाँचता है | सबसे नए बिंदु के लिए हर 7 दिन में एक बार अपने-आप। अनुरोध पर [[ui:backupVerifyDeepAction]], `arkvoryctl backup verify POINT_ID` या `arkvory-backup verify --deep` के साथ | पूर्ण सत्यापन पूरा बिंदु पढ़ता है, इसलिए बड़े vault के साथ इसे समय और डिस्क throughput चाहिए। अगर कोई बिंदु विफल हो, तो कंसोल त्रुटि कोड के साथ [[ui:backupVerifyFailed]] दिखाता है, और चेतावनी `verify_failed` सक्रिय हो जाती है। कारण जानने तक vault न बदलें। @@ -223,18 +223,18 @@ sudo mount -t cifs //nas/arkvory /mnt/backup/arkvory \ ### चेतावनियाँ {#warnings} -| कोड | स्तर | क्या करें | -| ---------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `vault_not_configured` | चेतावनी | vault कनेक्ट करें। [vault कनेक्ट करें](#connect-vault) देखें | -| `agent_offline` | गंभीर | 2 मिनट से कोई संकेत नहीं। एजेंट सेवा शुरू करें और उसका log पढ़ें | -| `schedule_disabled` | चेतावनी | दैनिक बैकअप चाहिए तो योजना चालू करें | -| `no_backup_yet` | चेतावनी | पहला बैकअप बनाएँ | -| `backup_stale` | गंभीर | योजना चालू रहते हुए सबसे नया बिंदु 26 घंटे से पुराना है। जॉब के त्रुटि कोड और एजेंट log पढ़ें | -| `last_run_failed` | चेतावनी | अंतिम बैकअप विफल हुआ। त्रुटि कोड जॉब सूची में है | +| कोड | स्तर | क्या करें | +| ---------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `vault_not_configured` | चेतावनी | vault कनेक्ट करें। [vault कनेक्ट करें](#connect-vault) देखें | +| `agent_offline` | गंभीर | 2 मिनट से कोई संकेत नहीं। एजेंट सेवा शुरू करें और उसका log पढ़ें | +| `schedule_disabled` | चेतावनी | दैनिक बैकअप चाहिए तो योजना चालू करें | +| `no_backup_yet` | चेतावनी | पहला बैकअप बनाएँ | +| `backup_stale` | गंभीर | योजना चालू रहते हुए सबसे नया बिंदु 26 घंटे से पुराना है। जॉब के त्रुटि कोड और एजेंट log पढ़ें | +| `last_run_failed` | चेतावनी | अंतिम बैकअप विफल हुआ। त्रुटि कोड जॉब सूची में है | | `vault_unavailable` | गंभीर | वॉल्यूम माउंट नहीं है, `vault.json` नहीं है, vault में लिखा नहीं जा सकता, या एन्क्रिप्टेड vault की कोई वैध कुंजी नहीं है (एजेंट लॉग में `vault_key_missing` या `vault_key_invalid` दिखता है) | -| `vault_low_space` | चेतावनी | वॉल्यूम का 10% से कम खाली है, या अंतिम बैकअप के नए डेटा से कम दोगुना खाली है। जगह खाली करें या कम बिंदु रखें | -| `verify_failed` | गंभीर | कोई बिंदु सत्यापन में विफल हुआ। vault न बदलें; जाँच करें | -| `never_deep_verified` | चेतावनी | 8 दिन से अधिक समय से कोई पूर्ण सत्यापन नहीं। जाँचें कि एजेंट चल रहा है, या पूर्ण सत्यापन शुरू करें | +| `vault_low_space` | चेतावनी | वॉल्यूम का 10% से कम खाली है, या अंतिम बैकअप के नए डेटा से कम दोगुना खाली है। जगह खाली करें या कम बिंदु रखें | +| `verify_failed` | गंभीर | कोई बिंदु सत्यापन में विफल हुआ। vault न बदलें; जाँच करें | +| `never_deep_verified` | चेतावनी | 8 दिन से अधिक समय से कोई पूर्ण सत्यापन नहीं। जाँचें कि एजेंट चल रहा है, या पूर्ण सत्यापन शुरू करें | ### CLI और API के साथ {#status-cli} @@ -367,50 +367,50 @@ Prometheus के लिए, API `arkvory_backup_last_success_timestamp_seconds` प्रोग्राम `arkvory-backup` अपने standard output पर हर पंक्ति में एक JSON object लिखता है, और विफलता पर standard error पर एक संकेत पंक्ति। -| कोड | अर्थ | -| --- | -------------------------------------------------------------------------------------------------------------------------------------- | -| 0 | सफलता। `--yes` के बिना `restore` के लिए, जाँच पास हुई | +| कोड | अर्थ | +| --- | --------------------------------------------------------------------------------------------------------------------- | +| 0 | सफलता। `--yes` के बिना `restore` के लिए, जाँच पास हुई | | 1 | रन विफल: डेटाबेस या डिस्क अनुपलब्ध, lease या snapshot खोया, vault या लक्ष्य भरा। पुनर्स्थापना बिंदु क्षतिग्रस्त नहीं होते | -| 2 | गलत आर्गुमेंट या एनवायरनमेंट वेरिएबल | +| 2 | गलत आर्गुमेंट या एनवायरनमेंट वेरिएबल | | 3 | एक सुरक्षा जाँच ने इनकार किया: `vault.json` नहीं, अतिव्यापी डायरेक्टरियाँ, ऐसा लक्ष्य जो खाली नहीं है, असमर्थित schema, ऐसा बिंदु नहीं | -| 4 | अखंडता विफलता: hash, गायब फ़ाइल या बदला हुआ manifest। समझने तक vault अपरिवर्तित छोड़ दें | -| 5 | व्यस्त: कोई और बैकअप या maintenance चल रहा है, या हटाना समय पर पूरा नहीं हुआ। बाद में फिर प्रयास करें | +| 4 | अखंडता विफलता: hash, गायब फ़ाइल या बदला हुआ manifest। समझने तक vault अपरिवर्तित छोड़ दें | +| 5 | व्यस्त: कोई और बैकअप या maintenance चल रहा है, या हटाना समय पर पूरा नहीं हुआ। बाद में फिर प्रयास करें | ### log पंक्तियाँ {#log-lines} हर पंक्ति में `component` `backup` पर सेट होता है। Paths, URLs और secrets कभी नहीं लिखे जाते। सबसे उपयोगी पंक्तियाँ: -| कोड | अर्थ | -| ------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | -| `backup.phase` | बैकअप एक चरण में जाता है: `barrier`, `pins`, `tables`, `blobs`, `manifest`, `commit`, `done` | +| कोड | अर्थ | +| ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | +| `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.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.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` | एजेंट log Linux पर `journalctl -u arkvory-backup` से पढ़ें, Windows पर इंस्टॉलेशन रूट की `logs\` में, और Compose में `docker compose logs backup` से। ### त्रुटि कोड {#error-codes} -| `errorCode` | एग्ज़िट | क्या करें | -| -------------------------------------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------- | -| `vault_missing` | 3 | डायरेक्टरी में `vault.json` नहीं है। वॉल्यूम माउंट करें, या एक बार `vault init` चलाएँ | -| `vault_key_missing` | 3 | vault एन्क्रिप्टेड है और कोई कुंजी नहीं दी गई। `--key-file FILE` या `ARKVORY_BACKUP_VAULT_KEY_FILE` इस्तेमाल करें | -| `vault_key_invalid` | 3 | यह कुंजी इस vault को नहीं खोलती: फ़ाइल, vault, या स्लॉट हटा तो नहीं दिया गया, जाँचें। टाइपो कुंजी के चेकसम से पकड़ा जाता है | -| `unsafe_path` | 3 | vault, स्टोरेज और पुनर्स्थापना लक्ष्य को अलग डायरेक्टरी वृक्षों में रखें | -| `target_not_empty` | 3 | पुनर्स्थापना केवल खाली डेटाबेस और खाली डायरेक्टरी में लिखती है | -| `schema_mismatch` | 3 | बिंदु रिलीज़ से नया है, या समर्थित पुनर्स्थापना से पुराना। दूसरी रिलीज़ इस्तेमाल करें | -| `upgrade_required` | 3 | इंस्टॉलेशन के हर API और maintenance प्रोसेस को अपडेट करें | -| `point_not_found`, `storage_mismatch` | 3 | गलत point ID, या `ARKVORY_DATA_DIR` इस इंस्टॉलेशन की इनिशियलाइज़ की गई storage डायरेक्टरी नहीं है | -| `integrity_mismatch`, `invalid_manifest`, `blob_missing` | 4 | vault अपरिवर्तित रखें। `verify --deep` चलाएँ और जाँच करें | -| `busy`, `barrier_timeout` | 5 | कोई और ऑपरेशन चल रहा है। बाद में फिर प्रयास करें | -| `vault_full`, `storage_full` | 1 | जगह खाली करें। पहले के बिंदु बरकरार हैं | -| `attempts_exhausted` | 3 | इस अनुरोध ने अपने 5 प्रयास इस्तेमाल कर लिए। नया बैकअप शुरू करें | +| `errorCode` | एग्ज़िट | क्या करें | +| -------------------------------------------------------- | ----- | ----------------------------------------------------------------------------------------------------------- | +| `vault_missing` | 3 | डायरेक्टरी में `vault.json` नहीं है। वॉल्यूम माउंट करें, या एक बार `vault init` चलाएँ | +| `vault_key_missing` | 3 | vault एन्क्रिप्टेड है और कोई कुंजी नहीं दी गई। `--key-file FILE` या `ARKVORY_BACKUP_VAULT_KEY_FILE` इस्तेमाल करें | +| `vault_key_invalid` | 3 | यह कुंजी इस vault को नहीं खोलती: फ़ाइल, vault, या स्लॉट हटा तो नहीं दिया गया, जाँचें। टाइपो कुंजी के चेकसम से पकड़ा जाता है | +| `unsafe_path` | 3 | vault, स्टोरेज और पुनर्स्थापना लक्ष्य को अलग डायरेक्टरी वृक्षों में रखें | +| `target_not_empty` | 3 | पुनर्स्थापना केवल खाली डेटाबेस और खाली डायरेक्टरी में लिखती है | +| `schema_mismatch` | 3 | बिंदु रिलीज़ से नया है, या समर्थित पुनर्स्थापना से पुराना। दूसरी रिलीज़ इस्तेमाल करें | +| `upgrade_required` | 3 | इंस्टॉलेशन के हर API और maintenance प्रोसेस को अपडेट करें | +| `point_not_found`, `storage_mismatch` | 3 | गलत point ID, या `ARKVORY_DATA_DIR` इस इंस्टॉलेशन की इनिशियलाइज़ की गई storage डायरेक्टरी नहीं है | +| `integrity_mismatch`, `invalid_manifest`, `blob_missing` | 4 | vault अपरिवर्तित रखें। `verify --deep` चलाएँ और जाँच करें | +| `busy`, `barrier_timeout` | 5 | कोई और ऑपरेशन चल रहा है। बाद में फिर प्रयास करें | +| `vault_full`, `storage_full` | 1 | जगह खाली करें। पहले के बिंदु बरकरार हैं | +| `attempts_exhausted` | 3 | इस अनुरोध ने अपने 5 प्रयास इस्तेमाल कर लिए। नया बैकअप शुरू करें | ## सीमाएँ {#limits} diff --git a/wiki/hi/operate/cluster.md b/wiki/hi/operate/cluster.md index c0314b14..ab816acc 100644 --- a/wiki/hi/operate/cluster.md +++ b/wiki/hi/operate/cluster.md @@ -16,10 +16,10 @@ description: 'एक साइट के दो या तीन Linux सर् - **फ़ेंसिंग अनिवार्य है।** दूसरे सर्वर के कार्यभार संभालने से पहले Pacemaker विफल सर्वर को पावर डिवाइस (IPMI, iDRAC, iLO, Redfish, PDU) या हाइपरवाइज़र के ज़रिए बंद कर देता है। फ़ेंसिंग के बिना दो सर्वर एक साथ राइट कर सकते हैं। फ़ेंसिंग के बिना क्लस्टर शुरू नहीं होता। - **हर स्वीकृत राइट के लिए दो कॉपी।** Arkvory किसी राइट का उत्तर सफलता से तभी देता है जब राइट कम से कम दो पूरी कॉपी पर हो ([राइट और कॉपी](#writes) देखें)। कोई कॉपी कम हो तो राइट रुक जाती हैं और रीड जारी रहती हैं। -| प्रोफ़ाइल | डेटा सर्वर | विटनेस | जब एक डेटा सर्वर विफल हो | -| --------- | ---------- | ------------------------------------------------------------------------------------- | ----------------------------------------------------- | -| `ha-2` | 2 | अनिवार्य: बिना डेटा वाला एक छोटा सर्वर जो `corosync-qnetd` और DRBD टाईब्रेकर चलाता है | सर्वर लौटने या ऑपरेटर के निर्णय तक राइट रुकी रहती हैं | -| `ha-3` | 3 | उपयोग नहीं होता: तीनों सर्वर बहुमत से तय करते हैं | राइट जारी रहती हैं: दो कॉपी बची रहती हैं | +| प्रोफ़ाइल | डेटा सर्वर | विटनेस | जब एक डेटा सर्वर विफल हो | +| ------- | -------- | ------------------------------------------------------------------------------- | --------------------------------------------- | +| `ha-2` | 2 | अनिवार्य: बिना डेटा वाला एक छोटा सर्वर जो `corosync-qnetd` और DRBD टाईब्रेकर चलाता है | सर्वर लौटने या ऑपरेटर के निर्णय तक राइट रुकी रहती हैं | +| `ha-3` | 3 | उपयोग नहीं होता: तीनों सर्वर बहुमत से तय करते हैं | राइट जारी रहती हैं: दो कॉपी बची रहती हैं | `ha-3` अनुशंसित प्रोफ़ाइल है। `ha-2` कम खर्चीला है और डेटा को एक ही कॉपी में रखने के बजाय ईमानदारी से राइट रोक देता है। @@ -151,15 +151,15 @@ description: 'एक साइट के दो या तीन Linux सर् इन कमांड को 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-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