@sumor/ssh-docker

ssh-docker

Ein Sumor Cloud Tool.
Weitere Dokumentation

ssh-docker ist ein Docker-Tool für @sumor/ssh-tools

CI Test Coverage Audit

Installation

npm i @sumor/ssh-docker --save

Voraussetzungen

Node.JS Version

Node.JS-Version 18.x oder höher erforderlich

Erforderliches Node.JS ES-Modul

Da dieses Paket in ES-Modul geschrieben ist, ändern Sie bitte den folgenden Code in Ihrer package.json-Datei:

{
  "type": "module"
}

Verwendung

Tool importieren

import SSHBasic von '@sumor/ssh-tools'
import docker von '@sumor/ssh-docker'

class SSH erweitert SSHBasic {
  constructor(config) {
    super(config)
    this.addTool('docker', docker)
  }
}

exportiere standardmäßig SSH

Tool verwenden

import SSH von './ssh.js'

const ssh = new SSH(server)

await ssh.connect()

// Bild mit Docker erstellen
const sourceFolder = '/Pfad/zum/Quellordner'
const imageName = 'Bildname'
const version = '1.0.0'
await ssh.docker.buildImage(sourceFolder, imageName, version)

// Bilderliste
const images = await ssh.docker.images()

// Bild vorhanden
const exists = await ssh.docker.existsImage(imageName, version)

// Container mit Docker ausführen
await ssh.docker.run({
  name: 'Containername',
  image: imageName,
  version: version,
  ports: [
    {
      from: 443, // Containerport
      to: 30123 // Hostport
    }
  ],
  bindings: [
    {
      from: '/usr/source/config', // Containerordner
      to: '/Pfad/zum/Konfigurationsordner', // Hostordner
      readOnly: true // optional, Standardwert ist false
    }
  ]
})

// Liste der Docker-Container
const containers = await ssh.docker.containers()

// Container vorhanden
const exists = await ssh.docker.exists('Containername')

// Befehl im Container ausführen
const result = await ssh.docker.exec('Containername', 'ls -al')

// Container löschen
await ssh.docker.remove('Containername')

// Bild löschen
await ssh.docker.removeImage(imageName, version)

// Node.js-Projekt erstellen
const logs = await ssh.docker.buildNode('/Pfad/zum/Quellordner')

// Node.js-Projekt ausführen
const logs = await ssh.docker.runNode('Containername', '/Pfad/zum/Quellordner', {
  port
})

// Nginx ausführen
const logs = await ssh.docker.runNginx({
  name: 'Containername',
  ports: [
    {
      from: 443, // Containerport
      to: 30123 // Hostport
    }
  ],
  bindings: [
    {
      from: '/usr/source/config', // Containerordner
      to: '/Pfad/zum/Konfigurationsordner', // Hostordner
      readOnly: true // optional, Standardwert ist false
    }
  ]
})

// Nginx-Konfiguration aktualisieren
await ssh.docker.updateNginx(Docker-ID)

// Website ausführen
await ssh.docker.runSite({
  workerProcesses: 2,
  workerConnections: 2048,
  port: 30100,
  domains: [
    {
      domain: 'dev.example.com',
      servers: [
        {
          host: 'dev.example.com',
          port: 30001,
          maxFails: 3,
          maxConns: 5
        },
        {
          host: 'dev.example.com',
          port: 30002,
          weight: 1
        }
      ]
    }
  ]
})

await ssh.disconnect()