@sumor/ssh-docker

ssh-docker

一个 Sumor Cloud 工具。
更多文档

ssh-docker 是一个针对 @sumor/ssh-tools 的 Docker 工具。

CI Test Coverage Audit

安装

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 = '/path/to/source/folder'
const imageName = 'image-name'
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: 'container-name',
  image: imageName,
  version: version,
  ports: [
    {
      from: 443, // 容器端口
      to: 30123 // 主机端口
    }
  ],
  folders: [
    {
      from: '/usr/source/config', // 容器文件夹
      to: '/path/to/config/folder', // 主机文件夹
      readOnly: true // 可选,默认为 false
    }
  ]
})

// Docker 容器列表
const containers = await ssh.docker.containers()

// 存在容器
const exists = await ssh.docker.exists('container-name')

// 在容器中执行命令
const result = await ssh.docker.exec('container-name', 'ls -al')

// 删除 Docker 容器
await ssh.docker.remove('container-name')

// 删除 Docker 镜像
await ssh.docker.removeImage(imageName, version)

// 构建 Node.js 项目
const logs = await ssh.docker.buildNode('/path/to/source')

// 运行 Node.js 项目
const logs = await ssh.docker.runNode('container-name', '/path/to/source', {
  port
})

await ssh.disconnect()