@sumor/ssh-docker

ssh-docker

Инструмент Sumor Cloud.
Дополнительная документация

ssh-docker - это инструмент docker для @sumor/ssh-tools

CI Тест Покрытие Проверка

Установка

npm i @sumor/ssh-docker --save

Предварительные требования

Версия Node.JS

Требуется версия Node.JS 18.x или выше

Требуется модуль Node.JS ES

Поскольку этот пакет написан как ES модуль, пожалуйста, измените следующий код в вашем файле package.json:

{
  "type": "module"
}

Использование

Импорт инструмента

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

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

export default SSH

Используйте инструмент

import SSH from './ssh.js'

const ssh = new SSH(server)

await ssh.connect()

// Сборка образа docker
const sourceFolder = '/путь/к/исходной/папке'
const imageName = 'имя-образа'
const version = '1.0.0'
await ssh.docker.buildImage(sourceFolder, imageName, version)

// Список образов
const images = await ssh.docker.images()

// Существует ли образ
const exists = await ssh.docker.existsImage(imageName, version)

// Запуск контейнера docker
await ssh.docker.run({
  name: 'имя-контейнера',
  image: imageName,
  version: version,
  ports: [
    {
      from: 443, // порт контейнера
      to: 30123 // порт хоста
    }
  ],
  bindings: [
    {
      from: '/usr/source/config', // папка контейнера
      to: '/путь/к/папке/конфигурации', // папка хоста
      readOnly: true // опционально, по умолчанию false
    }
  ]
})

// Список контейнеров docker
const containers = await ssh.docker.containers()

// Существует ли контейнер
const exists = await ssh.docker.exists('имя-контейнера')

// Выполнение команды в контейнере
const result = await ssh.docker.exec('имя-контейнера', 'ls -al')

// Удаление контейнера docker
await ssh.docker.remove('имя-контейнера')

// Удаление образа docker
await ssh.docker.removeImage(imageName, version)

// Сборка проекта на node.js
const logs = await ssh.docker.buildNode('/путь/к/исходнику')

// Запуск проекта на node.js
const logs = await ssh.docker.runNode('имя-контейнера', '/путь/к/исходнику', {
  порт
})

// Запуск Nginx
const logs = await ssh.docker.runNginx({
  name: 'имя-контейнера',
  ports: [
    {
      from: 443, // порт контейнера
      to: 30123 // порт хоста
    }
  ],
  bindings: [
    {
      from: '/usr/source/config', // папка контейнера
      to: '/путь/к/папке/конфигурации', // папка хоста
      readOnly: true // опционально, по умолчанию false
    }
  ]
})

// Обновление конфигурации Nginx
await ssh.docker.updateNginx(dockerId)

// Запуск сайта
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()