initial transfer

2026-07-27 13:09:00 +02:00
parent 9f25d48dc2
commit 736c01216a
191 changed files with 17622 additions and 136 deletions
@@ -0,0 +1,83 @@
+# nodevm
+
+**Install Node.js with essential global packages**
+
+## Purpose
+
+This cube installs the latest LTS (Long Term Support) version of Node.js along with essential global npm packages commonly needed for development and deployment.
+
+## What is Node.js?
+
+Node.js is a JavaScript runtime built on Chrome's V8 engine that allows you to run JavaScript on the server. It's widely used for:
+
+- Building web servers and APIs
+- Command-line tools
+- Build tools and task runners
+- Real-time applications (chat, notifications)
+- Microservices
+
+## What This Cube Does
+
+1. **Installs Node.js LTS**
+   - Downloads and runs the official NodeSource setup script
+   - Installs the latest LTS version of Node.js
+   - Includes npm (Node Package Manager)
+
+2. **Installs build dependencies**
+   - `libssl-dev` - SSL/TLS libraries
+   - `libtool` - Library building tools
+   - `cmake` - Cross-platform build system
+   - `libpng-dev`, `libjpeg-dev`, `libvips-dev` - Image processing libraries
+
+3. **Installs global npm packages**
+   - **npm@11.1.0** - Latest npm version
+   - **pm2** - Production process manager for Node.js apps
+   - **yarn** - Alternative package manager
+   - **local-web-server** - Local development web server
+   - **node-gyp** - Node.js native addon build tool
+   - **inquirer** - Interactive command-line prompts
+   - **execa** - Better child process execution
+   - **@dotenvx/dotenvx** - Environment variable management
+
+## Configuration
+
+This cube currently has no configurable parameters.
+
+## Dependencies
+
+None - this cube can run standalone.
+
+## Post-Installation
+
+Verify installation:
+```bash
+node --version
+npm --version
+```
+
+Common commands:
+- Run a Node.js app: `node app.js`
+- Start with PM2: `pm2 start app.js`
+- Install packages: `npm install <package>`
+- Use yarn: `yarn add <package>`
+
+## PM2 - Process Manager
+
+PM2 is included for production deployments. Common PM2 commands:
+
+```bash
+pm2 start app.js              # Start application
+pm2 list                      # List running apps
+pm2 stop app                  # Stop application
+pm2 restart app               # Restart application
+pm2 logs                      # View logs
+pm2 startup                   # Enable PM2 on boot
+pm2 save                      # Save current process list
+```
+
+## Notes
+
+- Node.js is installed system-wide
+- Global packages are accessible to all users
+- npm cache is stored in `~/.npm`
+- Use `nvm` if you need multiple Node.js versions
@@ -0,0 +1,58 @@
+from pyinfra.operations import server, apt, npm, python
+from pyinfra import host
+from pyinfra.facts.files import Directory
+from pyinfra.facts.server import Which
+
+hasNode = host.get_fact(Which, 'node')
+VERSION = host.data.VERSION
+ALIAS = host.data.ALIAS
+GLOBAL_PACKAGES = host.data.GLOBAL_PACKAGES
+USER = host.data.USER
+
+apt.packages( 
+        name=f'Install nodejs tools',
+        no_recommends=True,
+        packages=[
+          'build-essential',
+          'libssl-dev',
+          'libtool',
+          'cmake',
+          'libcairo2-dev',
+          'libpango1.0-de',
+          'libpng-dev',
+          'libgif-dev',
+          'libjpeg-dev',
+          'libvips-dev',
+          'librsvg2-dev',
+          'libpixman-1-dev',
+          ],
+        _sudo = True,
+    )
+
+server.shell(
+    commands=[
+        "curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash",
+        "omf install nvm",
+        f"nvm install {VERSION}",
+        f"nvm alias {ALIAS} {VERSION}",
+        "set -gx NVM_DIR $HOME/.nvm",
+    ],
+    _sudo=True,
+    _su_user=USER,
+    _use_su_login=True,
+    _shell_executable='/usr/bin/fish'
+)
+
+
+server.shell(
+    commands=[
+        "npm install -g pm2 yarn local-web-server node-gyp inquirer execa @dotenvx/dotenvx"
+    ],
+    _sudo=True,
+    _su_user=USER,
+    _use_su_login=True,
+    _shell_executable='/usr/bin/fish'
+    
+)
+
+
@@ -0,0 +1,20 @@
+import { cubes } from '@bitstack/nopy';
+import { z } from 'zod';
+
+export default cubes.Manifest({
+  id: 'runtime:nodevm',
+  name: 'Install nvm and nodejs with global packages',
+  dependencies: () => [],
+  schema: z.object({
+    VERSION: z
+      .nullable(z.string())
+      .describe('Node.js version to install. It is recommended to use semver notation')
+      .default('v22.20.0'),
+    USER: z.string().describe('Username for which to install nodejs').default('vagrant'),
+    ALIAS: z.string().describe('The alias for this node version').default('nodelts'),
+    GLOBAL_PACKAGES: z
+      .string()
+      .describe('Space-separated list of global npm packages to install')
+      .default('npm-check-updates'),
+  }),
+});