Web Analytics

setup-distributed-nix-builds

⭐ 1 stars Assamese by Misaka13514

🌐 ভাষা

❄️ বিতৰণ কৰা Nix Build স্থাপন কৰক

এটা GitHub Action যিয়ে তৎক্ষণাত এটা ক্ষণস্থায়ী, বহু-প্লেটফৰ্ম Distributed Nix Build ক্লাষ্টাৰ প্ৰভিজন কৰে, যিটো সাধাৰণ GitHub Hosted Runners ব্যৱহাৰ কৰি নিৰাপদভাৱে Tailscale-এ সংযোগ কৰে।

এই Action-এ আপোনাক এটা মেট্ৰিক্সৰ ছেকেণ্ডাৰী GitHub runner (Builderবোৰ) তৎক্ষণাত আৰম্ভ কৰিবলৈ আৰু এগৰাকী প্ৰাইমাৰী runner (Coordinator)ৰ সৈতে Tailscale SSHৰ জৰিয়তে সুন্দৰভাৱে সংযোগ কৰিবলৈ সক্ষম কৰে। Coordinator-এ স্বয়ংক্ৰিয়ভাৱে Nix কনফিগাৰ কৰে যাতে এই নোডবোৰক ৰিম’ট বিল্ডাৰৰ ৰূপে ব্যৱহাৰ কৰিব পাৰি, বাহ্যিক ইন্ফ্ৰাষ্ট্ৰাকচাৰ ব্যৱস্থাপনা নকৰাকৈ একেলগে বহুবিধ বিল্ড পাৰফৰ্মেন্স বঢ়ায়! এইটো বহু-আৰ্হিটেকচাৰ পেকেজ বিল্ড কৰাৰ বাবে বা x86 runner ৰ বহুল ব্যৱহাৰ কৰি ভাৰী NixOS system closureবোৰ চাৰ্ভাৰ কৰিবলৈ উপযুক্ত।

বৈশিষ্ট্যসমূহ

এইটো কেনেকৈ কাম কৰে

ওৱৰ্কফ্ল’ৱে ৰানাৰসমূহক দুটা ভূমিকাত বিভাজন কৰে: builder আৰু coordinator।

sequenceDiagram
  participant GH as GitHub Actions
  participant Coord as Coordinator (Ubuntu)
  participant B1 as Builder 1 (Ubuntu ARM)
  participant B2 as Builder 2 (macOS)
  participant TS as Tailscale Network
  GH->>B1: Spawn Builder Node
  GH->>B2: Spawn Builder Node
  GH->>Coord: Spawn Coordinator Node
  B1->>TS: Auth & Idle Wait
  B2->>TS: Auth & Idle Wait
  Coord->>TS: Auth & Wait for Builders
  TS-->>Coord: Builders Online!
  Note over Coord: Tests Nix connection &
Updates /etc/nix/machines
  Coord->>B1: Send aarch64-linux build tasks via SSH
  Coord->>B2: Send aarch64-darwin build tasks via SSH
  B1-->>Coord: Return Build Artifacts
  B2-->>Coord: Return Build Artifacts
  Note over Coord: Build Completes
  Coord->>B1: Send Teardown Signal
  Coord->>B2: Send Teardown Signal

প্ৰয়োজনীয়তা

এই কাৰ্যটো ব্যৱহাৰ কৰাৰ আগতে, আপুনি ৰানাৰসমূহে সুৰক্ষিতভাৱে যোগাযোগ কৰিবলৈ এটা Tailscale নেটৱৰ্ক কনফিগাৰ কৰিব লাগিব।

নিশ্চিত কৰক যে আপোনাৰ Tailscale-ত tag গ্ৰুপ সৃষ্টি কৰা হৈছে আৰু ACL-সমূহে coordinator-এ builders-সমূহত Tailscale SSH ব্যৱহাৰ কৰি SSH কৰিব পৰা যায়। আপোনাৰ Tailscale Access Controlsত তলত দিয়া সংযোজন কৰক:

প্ৰয়োজনীয় Tailscale ACL কনফিগাৰেশ্বন চাবলৈ ক্লিক কৰক

{
  "grants": [
    {
      "src": ["tag:nix-ci-builder", "tag:nix-ci-coordinator"],
      "dst": ["tag:nix-ci-builder", "tag:nix-ci-coordinator"],
      "ip": ["*"]
    }
  ],
  "ssh": [
    {
      "src": ["tag:nix-ci-coordinator"],
      "dst": ["tag:nix-ci-builder"],
      "users": ["autogroup:nonroot", "root"],
      "action": "accept"
    }
  ],
  "tagOwners": {
    "tag:nix-ci-coordinator": ["autogroup:admin", "tag:nix-ci-coordinator"],
    "tag:nix-ci-builder": ["autogroup:admin", "tag:nix-ci-builder"]
  }
}

আপোনাৰ Tailscale Admin panel-ত auth_keys ৰাইট স্ক'প আৰু nix-ci-builder nix-ci-coordinator টেগৰ সৈতে এটা OAuth ক্লায়েন্ট চিক্ৰেট সৃষ্টি কৰক। এই চিক্ৰেটটো আপোনাৰ GitHub Repository Secrets-ত TS_OAUTH_SECRET হিচাপে সংযোজন কৰক।

ইনপুটসমূহ

| ইনপুট | বিৱৰণ | আৱশ্যক | ডিফ’ল্ট | | -------------------- | --------------------------------------------------------------------------------------------- | ------- | ----------- | | tailscale_authkey | Tailscale OAuth ক্লায়েন্ট চিক্ৰেট বা Auth Key. | হয় | N/A | | tailscale_hostname | Tailscale-ত পঞ্জীয়ন কৰিবলৈ হোস্টনেম। | হয় | N/A | | tailscale_tags | Tailscale-ত প্ৰকাশ কৰিবলৈ টেগসমূহ (উদাহৰণস্বৰূপে tag:nix-ci-builder)। | হয় | N/A | | role | বৰ্তমান জবটোৰ ভূমিকা: "builder" বা "coordinator"। | হয় | "builder" | | builders | অপেক্ষা কৰিবলগীয়া সম্পূৰ্ণ বিল্ডাৰ হোস্টনেমসমূহৰ স্পেচেৰে বিভাজিত তালিকা। (_coordinator ভূমিকা হ’লে আৱশ্যক_) | নহয় | "" | | builder_timeout | বিল্ডাৰে আত্ম-সমাপ্ত কৰাৰ আগত অপেক্ষা কৰিবলগীয়া সৰ্বাধিক সময় (ছেকেণ্ডত)। | নহয় | "300" | | extra_nix_config | /etc/nix/nix.conf-ত সংযোজন কৰিবলগীয়া অতিৰিক্ত Nix সংৰূপ। | নহয় | "" |

ব্যৱহাৰ

সম্পূৰ্ণ বিতৰণ বিল্ড উদাহৰণ

তলত এটা সম্পূৰ্ণ ৱৰ্কফ্ল’ (nix-build.yml) দিয়া হৈছে, যি ডাইনেমিকভাৱে বহুতো ৰানাৰ আৰ্হিচেকচাৰ (Ubuntu x86, Ubuntu ARM, macOS x86, macOS Apple Silicon) স্পিন আপ কৰে, ইহঁতক সংযোগ কৰে, আৰু এটা বিতৰণ Nix বিল্ড চলায়।

আপুনি যদি এটা বৃহৎ NixOS কনফিগাৰেচন বিল্ড কৰি আছে আৰু কেৱল ইয়াক হৰাইজণ্টেল স্কেলিং ব্যৱহাৰ কৰি দ্ৰুত কৰিব বিচাৰে, তেন্তে আপুনি BUILDER_COUNTS পৰিবৰ্তন কৰি বহুতো একেই x86 ৰানাৰ স্পন কৰিব পাৰে। উদাহৰণস্বৰূপে: BUILDER_COUNTS: '{"ubuntu-24.04": 4}' ইয়ে মুহূৰ্ততে আপোনাক ১৬টা CPU কোৰ (৪টা ৰানাৰ × ৪ কোৰ) সহ এটা বিল্ড ফাৰ্ম দিব, যিয়ে ডেৰিভেচনসমূহ সমান্তৰালভাৱে প্ৰসেছ কৰিব পাৰে।

কাৰণ GitHub Hosted Runner-সমূহ ক্ষণস্থায়ী, সেয়া বুলি যেতিয়া ৱৰ্কফ্ল’টো সমাপ্ত হয় তেতিয়া Nix ষ্ট’ৰৰ সকলো বিল্ড অৰ্টিফেক্ট হেৰাই যাব। আপোনাৰ বিতৰণ বিল্ডসমূহৰ লাভ ভৱিষ্যতৰ CI ৰানসমূহত বা আপোনাৰ লোকেল মেচিনত পাবলৈ, ফলাফলসমূহ Cachix বা Attic যেনে এটা বাইনাৰী কেচলৈ পুশ কৰা অধিক সুপারিশযোগ্য।

name: Distributed Nix Build
on:
  workflow_dispatch:
env:
  # Define exactly how many runners of each OS type you want
  BUILDER_COUNTS: '{"ubuntu-24.04": 1, "ubuntu-24.04-arm": 1, "macos-26-intel": 1, "macos-26": 1}'
jobs:
  config:
    runs-on: ubuntu-slim
    outputs:
      builder_matrix: ${{ steps.set.outputs.builder_matrix }}
      builders_list: ${{ steps.set.outputs.builders_list }}
      run_suffix: ${{ steps.set.outputs.run_suffix }}
    steps:
      
  • id: set
    • 
        
run: |
          SUFFIX=$(openssl rand -hex 3)
          echo "run_suffix=$SUFFIX" >> "$GITHUB_OUTPUT"
          # Dynamically generate the Matrix JSON based on BUILDER_COUNTS
          MATRIX_JSON=$(echo '${{ env.BUILDER_COUNTS }}' | jq -c '[
              to_entries[] | .key as $os | .value as $count |
              range(1; $count + 1) | { os: $os, id: "\($os)-\(.)" }
            ]
          ')
          echo "builder_matrix=$MATRIX_JSON" >> "$GITHUB_OUTPUT"
          # Create a space-separated list of hostnames for the coordinator
          BUILDERS_LIST=$(echo "$MATRIX_JSON" | jq -r --arg suffix "$SUFFIX" 'map("nix-builder-\($suffix)-\(.id)") | join(" ")')
          echo "builders_list=$BUILDERS_LIST" >> "$GITHUB_OUTPUT"
  builder:
    needs: config
    name: Builder ${{ matrix.builder.id }} (${{ needs.config.outputs.run_suffix }})
    runs-on: ${{ matrix.builder.os }}
    strategy:
      fail-fast: false
      matrix:
        builder: ${{ fromJSON(needs.config.outputs.builder_matrix) }}
    steps:
      
  • name: Setup Distributed Nix Builder
    • 
        
uses: Misaka13514/setup-distributed-nix-builds@main
        with:
          tailscale_authkey: ${{ secrets.TS_OAUTH_SECRET }}
          tailscale_hostname: nix-builder-${{ needs.config.outputs.run_suffix }}-${{ matrix.builder.id }}
          tailscale_tags: tag:nix-ci-builder
          role: builder
      # Optionally configure your Cachix/Attic or other caching here
      # - uses: cachix/cachix-action@v17
  coordinator:
    needs: config
    name: Coordinator (${{ needs.config.outputs.run_suffix }})
    runs-on: ubuntu-24.04
    steps:
      
  • name: Setup Coordinator & Connect Builders
    • 
        
uses: Misaka13514/setup-distributed-nix-builds@main
        with:
          tailscale_authkey: ${{ secrets.TS_OAUTH_SECRET }}
          tailscale_hostname: nix-coordinator-${{ needs.config.outputs.run_suffix }}
          tailscale_tags: tag:nix-ci-coordinator
          role: coordinator
          builders: ${{ needs.config.outputs.builders_list }}
      # Optionally configure your Cachix/Attic or other caching here
      # - uses: cachix/cachix-action@v17
  • name: Execute Distributed Build
    • 
        
run: |
          # Your build command here. Because builders are registered in /etc/nix/machines,
          # Nix will automatically offload tasks to the correct architecture node.
          nix build -L --max-jobs 0 .#my-package
      # Signal builders to terminate if they are not needed anymore
      
  • name: Teardown Builders
    • 
        
run: stop-nix-builders
      # Push build results to Cachix/Attic or other cache here if desired
      # - name: Push to Cachix
      #   run: cachix push mycache --all

লাইচেন্স

এই প্ৰকল্পটো MIT লাইচেন্সৰ অধীনত লাইচেন্স কৰা হৈছে।

--- Tranlated By Open Ai Tx | Last indexed: 2026-03-27 ---

Original README: View on GitHub

Translated by OpenAiTx | Last updated: 2026-03-27