kadi-deploy 0.19.0

package/quick-command.txt

@@ -0,0 +1,92 @@
+Those commands are for "TestBackendWallet"
+
+provider-services query market bid list \
+  --owner=akash1etrf2qpsvuyuhs4g0e6swdn9gk4n9dsslrjdjr \
+  --node https://rpc.akashnet.net:443 \
+  --dseq 9900163 \
+  --state=open
+
+provider-services tx deployment close \
+  --dseq 9900163 \
+  --owner akash1etrf2qpsvuyuhs4g0e6swdn9gk4n9dsslrjdjr \
+  --from TestBackendWallet \
+  --node https://rpc.akashnet.net:443 \
+  --chain-id akashnet-2 \
+  --fees 500uakt --yes
+
+provider-services tx deployment close \
+  --dseq 22139007 \
+  --owner akash1etrf2qpsvuyuhs4g0e6swdn9gk4n9dsslrjdjr \
+  --from TestBackendWallet \
+  --node https://rpc.akashnet.net:443 \
+  --chain-id akashnet-2 \
+  --fees 500uakt \
+  --gas 250000 \
+  --yes
+
+provider-services tx deployment close \
+  --dseq 9943223 \
+  --owner akash1etrf2qpsvuyuhs4g0e6swdn9gk4n9dsslrjdjr \
+  --from TestBackendWallet \
+  --node https://rpc.akashnet.net:443 \
+  --chain-id akashnet-2 \
+  --gas 300000 \
+  --fees 800uakt --yes
+
+provider-services query deployment list \
+  --owner akash1etrf2qpsvuyuhs4g0e6swdn9gk4n9dsslrjdjr \
+  --node https://rpc.akashnet.net:443 \
+  --state active
+
+provider-services query deployment list \
+  --owner akash1etrf2qpsvuyuhs4g0e6swdn9gk4n9dsslrjdjr \
+  --node https://rpc.akashnet.net:443 | grep 'open' | wc -l
+
+provider-services query deployment list \
+  --owner akash1etrf2qpsvuyuhs4g0e6swdn9gk4n9dsslrjdjr \
+  --node https://rpc.akashnet.net:443 \
+  --state active
+
+provider-services query deployment list \
+  --owner akash1etrf2qpsvuyuhs4g0e6swdn9gk4n9dsslrjdjr \
+  --node https://rpc.akashnet.net:443 | grep 'open' | wc -l
+
+# Brand new certificate Overwrite old one from the command line
+provider-services tx cert generate client --from TestBackendWallet --overwrite
+
+provider-services tx cert publish client \
+  --from TestBackendWallet \
+  --node https://rpc.akashnet.net:443 \
+  --chain-id akashnet-2 \
+  --fees 500uakt \
+  --gas auto
+
+provider-services query cert list \
+  --owner akash1etrf2qpsvuyuhs4g0e6swdn9gk4n9dsslrjdjr \
+  --node https://rpc.akashnet.net:443 \
+  --state valid
+
+provider-services tx cert revoke client \
+  --serial <certificate-serial-number> \
+  --from TestBackendWallet \
+  --node https://rpc.akashnet.net:443 \
+  --chain-id akashnet-2 \
+  --gas-prices 0.025uakt \
+  --gas auto \
+  --gas-adjustment 1.5 --yes
+
+provider-services query deployment get \
+  --owner akash1etrf2qpsvuyuhs4g0e6swdn9gk4n9dsslrjdjr \
+  --dseq 9900163 \
+  --node https://rpc.akashnet.net:443
+
+provider-services query market lease list \
+  --owner akash1etrf2qpsvuyuhs4g0e6swdn9gk4n9dsslrjdjr \
+  --node https://rpc.akashnet.net:443 \
+  --dseq 9943255
+
+provider-services lease-logs \
+  --from TestBackendWallet \
+  --dseq 9900163 \
+  --provider $PROVIDER_ADDRESS \
+  --node https://rpc.akashnet.net:443 -f

package/scripts/preflight.js

@@ -0,0 +1,458 @@
+#!/usr/bin/env node
+// ──────────────────────────────────────────────────────────────
+// kadi-deploy preflight script (cross-platform: macOS/Linux/Windows)
+//
+// Runs during `kadi install` to validate prerequisites.
+// Checks for required and optional dependencies:
+//   - Node.js 18+ (required — already running if this executes)
+//   - Docker or Podman (required for local deploys)
+//   - frpc (required for KADI tunnel — Akash deploys)
+//
+// If frpc is missing, attempts auto-install:
+//   macOS:   Homebrew → direct download
+//   Linux:   direct download
+//   Windows: direct download (.zip)
+// ──────────────────────────────────────────────────────────────
+
+import { execFileSync } from 'node:child_process';
+import { existsSync, mkdirSync, chmodSync, renameSync, unlinkSync, readdirSync, createWriteStream } from 'node:fs';
+import { join, delimiter, dirname } from 'node:path';
+import { homedir, platform, arch, tmpdir } from 'node:os';
+import { pipeline } from 'node:stream/promises';
+import { Readable } from 'node:stream';
+
+// ── Globals ──────────────────────────────────────────────────
+const PLATFORM = platform();   // 'darwin', 'linux', 'win32'
+const ARCH = arch();           // 'arm64', 'x64', 'arm'
+const HOME = homedir();
+const IS_WIN = PLATFORM === 'win32';
+const FRP_VERSION = '0.67.0';
+
+let errors = 0;
+let warnings = 0;
+
+// ── Colors ───────────────────────────────────────────────────
+const supportsColor = process.stdout.isTTY && !process.env.NO_COLOR;
+const c = {
+  green:  (s) => supportsColor ? `\x1b[32m${s}\x1b[0m` : s,
+  yellow: (s) => supportsColor ? `\x1b[33m${s}\x1b[0m` : s,
+  red:    (s) => supportsColor ? `\x1b[31m${s}\x1b[0m` : s,
+  bold:   (s) => supportsColor ? `\x1b[1m${s}\x1b[0m`  : s,
+};
+
+const ok   = (msg) => console.log(c.green('  ✓') + ` ${msg}`);
+const warn = (msg) => console.log(c.yellow('  ⚠') + ` ${msg}`);
+const fail = (msg) => console.log(c.red('  ✗') + ` ${msg}`);
+const info = (msg) => console.log(`    ${msg}`);
+
+// ── PATH augmentation ────────────────────────────────────────
+// Non-interactive shells (SSH, lifecycle runners) may have a
+// minimal PATH. Add common install locations.
+function augmentPath() {
+  const extra = [];
+
+  if (IS_WIN) {
+    extra.push(
+      join(HOME, '.local', 'bin'),
+      join(HOME, 'bin'),
+      join(HOME, 'AppData', 'Local', 'Programs', 'frp'),
+      'C:\\Program Files\\frp',
+      'C:\\ProgramData\\chocolatey\\bin',
+      join(HOME, 'scoop', 'shims'),
+    );
+  } else {
+    extra.push(
+      '/opt/homebrew/bin',
+      '/opt/homebrew/sbin',
+      '/usr/local/bin',
+      '/usr/local/sbin',
+      join(HOME, '.local', 'bin'),
+      join(HOME, 'bin'),
+    );
+
+    // nvm — find installed node versions
+    const nvmDir = join(HOME, '.nvm', 'versions', 'node');
+    if (existsSync(nvmDir)) {
+      try {
+        const versions = readdirSync(nvmDir).filter(v => v.startsWith('v')).sort().reverse();
+        for (const v of versions) {
+          extra.push(join(nvmDir, v, 'bin'));
+        }
+      } catch { /* ignore */ }
+    }
+
+    // volta / fnm
+    extra.push(join(HOME, '.volta', 'bin'));
+    extra.push(join(HOME, '.fnm', 'aliases', 'default', 'bin'));
+  }
+
+  const pathDirs = new Set(process.env.PATH.split(delimiter));
+  for (const p of extra) {
+    if (existsSync(p) && !pathDirs.has(p)) {
+      process.env.PATH = p + delimiter + process.env.PATH;
+      pathDirs.add(p);
+    }
+  }
+}
+
+// ── Utility: find a binary ───────────────────────────────────
+function which(name) {
+  // Try the OS-native which/where
+  try {
+    const cmd = IS_WIN ? 'where' : 'which';
+    const result = execFileSync(cmd, [name], {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+      env: process.env,
+    }).trim();
+    // `where` on Windows can return multiple lines
+    return result.split(/\r?\n/)[0];
+  } catch { /* not found */ }
+
+  // Fallback: manually check common locations
+  const suffix = IS_WIN ? '.exe' : '';
+  const candidates = IS_WIN
+    ? [
+        join(HOME, '.local', 'bin', name + suffix),
+        join(HOME, 'AppData', 'Local', 'Programs', 'frp', name + suffix),
+        `C:\\Program Files\\frp\\${name}${suffix}`,
+      ]
+    : [
+        `/usr/local/bin/${name}`,
+        `/opt/homebrew/bin/${name}`,
+        join(HOME, '.local', 'bin', name),
+        join(HOME, 'bin', name),
+      ];
+
+  for (const p of candidates) {
+    if (existsSync(p)) return p;
+  }
+  return null;
+}
+
+// ── Utility: run a command and return stdout (or null) ───────
+function run(cmd, args = []) {
+  try {
+    return execFileSync(cmd, args, {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+      env: process.env,
+      timeout: 15000,
+    }).trim();
+  } catch {
+    return null;
+  }
+}
+
+// ── Utility: download a file ─────────────────────────────────
+async function download(url, destPath) {
+  const resp = await fetch(url, { redirect: 'follow' });
+  if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
+  const fileStream = createWriteStream(destPath);
+  const nodeStream = Readable.fromWeb(resp.body);
+  await pipeline(nodeStream, fileStream);
+}
+
+// ── Utility: extract frpc from .tar.gz ───────────────────────
+async function extractTarGz(tarPath, binaryName, destPath) {
+  // Use `tar` CLI (available on macOS, Linux, and modern Windows)
+  const tmpExtract = join(tmpdir(), `frpc-extract-${Date.now()}`);
+  mkdirSync(tmpExtract, { recursive: true });
+
+  try {
+    execFileSync('tar', ['xzf', tarPath, '-C', tmpExtract], {
+      stdio: ['pipe', 'pipe', 'pipe'],
+      timeout: 30000,
+    });
+
+    // Find the frpc binary in the extracted directory
+    const extracted = findFile(tmpExtract, binaryName);
+    if (!extracted) throw new Error(`${binaryName} not found in archive`);
+
+    // Ensure dest dir exists
+    mkdirSync(dirname(destPath), { recursive: true });
+    renameSync(extracted, destPath);
+    if (!IS_WIN) chmodSync(destPath, 0o755);
+    return true;
+  } finally {
+    // Cleanup
+    try {
+      if (IS_WIN) {
+        execFileSync('cmd', ['/c', 'rmdir', '/s', '/q', tmpExtract], { stdio: 'pipe' });
+      } else {
+        execFileSync('rm', ['-rf', tmpExtract], { stdio: 'pipe' });
+      }
+    } catch { /* ignore */ }
+  }
+}
+
+// ── Utility: extract frpc from .zip (Windows) ────────────────
+async function extractZip(zipPath, binaryName, destPath) {
+  const tmpExtract = join(tmpdir(), `frpc-extract-${Date.now()}`);
+  mkdirSync(tmpExtract, { recursive: true });
+
+  try {
+    // PowerShell's Expand-Archive works on all modern Windows
+    execFileSync('powershell', [
+      '-NoProfile', '-Command',
+      `Expand-Archive -Path '${zipPath}' -DestinationPath '${tmpExtract}' -Force`
+    ], { stdio: ['pipe', 'pipe', 'pipe'], timeout: 30000 });
+
+    const extracted = findFile(tmpExtract, binaryName);
+    if (!extracted) throw new Error(`${binaryName} not found in archive`);
+
+    mkdirSync(dirname(destPath), { recursive: true });
+    renameSync(extracted, destPath);
+    return true;
+  } finally {
+    try { execFileSync('rmdir', ['/s', '/q', tmpExtract], { stdio: 'pipe', shell: true }); } catch { /* ignore */ }
+  }
+}
+
+// ── Utility: recursively find a file ─────────────────────────
+function findFile(dir, name) {
+  try {
+    const entries = readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const full = join(dir, entry.name);
+      if (entry.isFile() && entry.name === name) return full;
+      if (entry.isDirectory()) {
+        const found = findFile(full, name);
+        if (found) return found;
+      }
+    }
+  } catch { /* ignore */ }
+  return null;
+}
+
+// ── Check: Node.js ───────────────────────────────────────────
+function checkNode() {
+  console.log('Checking Node.js...');
+  const major = parseInt(process.versions.node.split('.')[0], 10);
+  if (major >= 18) {
+    ok(`Node.js ${process.versions.node}`);
+  } else {
+    fail(`Node.js ${process.versions.node} (18+ required)`);
+    info('Install from https://nodejs.org/');
+    errors++;
+  }
+}
+
+// ── Check: Container engine ──────────────────────────────────
+function checkContainerEngine() {
+  console.log('Checking container engine...');
+
+  const dockerPath = which('docker');
+  if (dockerPath) {
+    const ver = run(dockerPath, ['--version']) || 'unknown';
+    ok(`Docker: ${ver}`);
+    return;
+  }
+
+  const podmanPath = which('podman');
+  if (podmanPath) {
+    const ver = run(podmanPath, ['--version']) || 'unknown';
+    ok(`Podman: ${ver}`);
+    return;
+  }
+
+  warn('No container engine found (Docker or Podman)');
+  info('Required for local deploys. Not needed for Akash-only deploys.');
+  info('Install Docker: https://docs.docker.com/get-docker/');
+  warnings++;
+}
+
+// ── Check: frpc ──────────────────────────────────────────────
+async function checkFrpc() {
+  console.log('Checking frpc (tunnel client)...');
+
+  // 1. Check if already installed
+  let frpcPath = which('frpc');
+  if (frpcPath) {
+    const ver = run(frpcPath, ['--version']) || 'unknown';
+    ok(`frpc ${ver} (${frpcPath})`);
+    return;
+  }
+
+  // 2. Not found — attempt auto-install
+  let installed = false;
+
+  // macOS: try Homebrew first
+  if (PLATFORM === 'darwin' && !installed) {
+    const brewPath = which('brew');
+    if (brewPath) {
+      warn('frpc not found — attempting install via Homebrew...');
+      const brewResult = run(brewPath, ['install', 'frpc']);
+      if (brewResult !== null) {
+        // Verify the binary actually exists (XProtect may delete it)
+        frpcPath = which('frpc');
+        if (frpcPath) {
+          const ver = run(frpcPath, ['--version']) || 'unknown';
+          ok(`frpc ${ver} (installed via Homebrew)`);
+          installed = true;
+        } else {
+          warn('Homebrew installed frpc formula but binary is missing (XProtect may have removed it)');
+        }
+      } else {
+        warn('Homebrew install failed — trying direct download...');
+      }
+    }
+  }
+
+  // macOS/Linux: direct download .tar.gz
+  if ((PLATFORM === 'darwin' || PLATFORM === 'linux') && !installed) {
+    const archMap = {
+      'darwin-arm64': 'darwin_arm64',
+      'darwin-x64':  'darwin_amd64',
+      'linux-x64':   'linux_amd64',
+      'linux-arm64': 'linux_arm64',
+      'linux-arm':   'linux_arm',
+    };
+    const frpArch = archMap[`${PLATFORM}-${ARCH}`];
+
+    if (frpArch) {
+      warn('frpc not found — attempting direct download...');
+      const url = `https://github.com/fatedier/frp/releases/download/v${FRP_VERSION}/frp_${FRP_VERSION}_${frpArch}.tar.gz`;
+      const installDir = join(HOME, '.local', 'bin');
+      const destPath = join(installDir, 'frpc');
+      const tmpFile = join(tmpdir(), `frpc-${Date.now()}.tar.gz`);
+
+      try {
+        await download(url, tmpFile);
+        await extractTarGz(tmpFile, 'frpc', destPath);
+
+        // macOS: remove quarantine attribute
+        if (PLATFORM === 'darwin') {
+          run('xattr', ['-d', 'com.apple.quarantine', destPath]);
+        }
+
+        const ver = run(destPath, ['--version']);
+        if (ver) {
+          ok(`frpc ${ver} (installed to ${destPath})`);
+          installed = true;
+
+          // Add to PATH for this process (and log for user)
+          if (!process.env.PATH.split(delimiter).includes(installDir)) {
+            process.env.PATH = installDir + delimiter + process.env.PATH;
+            warn(`${installDir} added to PATH for this session`);
+            const rcFile = PLATFORM === 'darwin' ? '~/.zshrc' : '~/.bashrc';
+            info(`Add permanently: echo 'export PATH="$HOME/.local/bin:$PATH"' >> ${rcFile}`);
+          }
+        } else {
+          fail('frpc downloaded but binary won\'t execute');
+          if (PLATFORM === 'darwin') {
+            info(`Try: xattr -d com.apple.quarantine ${destPath}`);
+          }
+        }
+      } catch (err) {
+        fail(`Direct download failed: ${err.message}`);
+      } finally {
+        try { unlinkSync(tmpFile); } catch { /* ignore */ }
+      }
+    }
+  }
+
+  // Windows: direct download .zip
+  if (PLATFORM === 'win32' && !installed) {
+    const archMap = {
+      'x64':   'windows_amd64',
+      'arm64': 'windows_arm64',
+    };
+    const frpArch = archMap[ARCH];
+
+    if (frpArch) {
+      warn('frpc not found — attempting direct download...');
+      const url = `https://github.com/fatedier/frp/releases/download/v${FRP_VERSION}/frp_${FRP_VERSION}_${frpArch}.zip`;
+      const installDir = join(HOME, '.local', 'bin');
+      const destPath = join(installDir, 'frpc.exe');
+      const tmpFile = join(tmpdir(), `frpc-${Date.now()}.zip`);
+
+      try {
+        await download(url, tmpFile);
+        await extractZip(tmpFile, 'frpc.exe', destPath);
+
+        const ver = run(destPath, ['--version']);
+        if (ver) {
+          ok(`frpc ${ver} (installed to ${destPath})`);
+          installed = true;
+
+          if (!process.env.PATH.split(delimiter).includes(installDir)) {
+            process.env.PATH = installDir + delimiter + process.env.PATH;
+            warn(`${installDir} added to PATH for this session`);
+            info(`Add permanently: setx PATH "%PATH%;${installDir}"`);
+          }
+        } else {
+          fail('frpc downloaded but won\'t execute');
+        }
+      } catch (err) {
+        fail(`Direct download failed: ${err.message}`);
+      } finally {
+        try { unlinkSync(tmpFile); } catch { /* ignore */ }
+      }
+    }
+  }
+
+  // If all install attempts failed, show manual instructions
+  if (!installed) {
+    warn('frpc not installed — KADI tunnel will not work');
+    console.log('');
+    info(c.bold('frpc is required for Akash deployments with local images.'));
+    info('Without it, kadi-deploy cannot create a tunnel for providers');
+    info('to pull your container images.');
+    console.log('');
+    info(c.bold('Install frpc:'));
+
+    if (PLATFORM === 'darwin') {
+      info('  brew install frpc');
+      info('');
+      info('If Homebrew install fails (macOS XProtect may block it):');
+      info('  1. Download from https://github.com/fatedier/frp/releases');
+      info('     (choose frp_*_darwin_arm64.tar.gz for Apple Silicon)');
+      info('  2. Extract: tar xzf frp_*.tar.gz');
+      info('  3. Move:    sudo mv frp_*/frpc /usr/local/bin/');
+      info('  4. Allow:   xattr -d com.apple.quarantine /usr/local/bin/frpc');
+    } else if (PLATFORM === 'win32') {
+      info('  1. Download from https://github.com/fatedier/frp/releases');
+      info('     (choose frp_*_windows_amd64.zip)');
+      info('  2. Extract frpc.exe to %USERPROFILE%\\.local\\bin\\');
+      info('  3. Add to PATH: setx PATH "%PATH%;%USERPROFILE%\\.local\\bin"');
+    } else {
+      info('  Download from https://github.com/fatedier/frp/releases');
+      info('  Extract and move frpc to ~/.local/bin/ or /usr/local/bin/');
+    }
+    console.log('');
+    info('After installing, re-run: kadi install');
+    console.log('');
+    warnings++;
+  }
+}
+
+// ── Main ─────────────────────────────────────────────────────
+async function main() {
+  console.log(c.bold('kadi-deploy preflight'));
+  console.log('');
+
+  augmentPath();
+  checkNode();
+  checkContainerEngine();
+  await checkFrpc();
+
+  // Summary
+  console.log('');
+  if (errors > 0) {
+    fail(c.bold(`Preflight failed with ${errors} error(s)`));
+    process.exit(1);
+  } else if (warnings > 0) {
+    warn(c.bold(`Preflight passed with ${warnings} warning(s)`));
+    info('kadi-deploy will work but some features may be limited.');
+    process.exit(0);
+  } else {
+    ok(c.bold('All checks passed'));
+    process.exit(0);
+  }
+}
+
+main().catch((err) => {
+  fail(`Preflight error: ${err.message}`);
+  process.exit(1);
+});