ssh-docker

Una Sumor Cloud Herramienta.
Más documentación

ssh-docker es una herramienta de docker para @sumor/ssh-tools

Instalación

npm i @sumor/ssh-docker --save

Requisitos previos

Versión de Node.JS

Se requiere la versión de Node.JS 18.x o superior

Requerir módulo ES de Node.JS

Como este paquete está escrito en módulo ES, por favor cambie el siguiente código en su archivo package.json:

{
  "type": "module"
}

Uso

Importar herramienta

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

Usar la herramienta

import SSH from './ssh.js'

const ssh = new SSH(servidor)

await ssh.connect()

// construir imagen docker
const carpetaOrigen = '/ruta/a/carpeta/de/origen'
const nombreImagen = 'nombre-imagen'
const versión = '1.0.0'
await ssh.docker.buildImage(carpetaOrigen, nombreImagen, versión)

// lista de imágenes
const imágenes = await ssh.docker.images()

// verificar si existe la imagen
const existe = await ssh.docker.existsImage(nombreImagen, versión)

// ejecutar contenedor docker
await ssh.docker.run({
  nombre: 'nombre-contenedor',
  imagen: nombreImagen,
  versión: versión,
  puertos: [
    {
      desde: 443, // puerto del contenedor
      a: 30123 // puerto del host
    }
  ],
  carpetas: [
    {
      desde: '/usr/source/config', // carpeta del contenedor
      a: '/ruta/a/carpeta/config', // carpeta del host
      soloLectura: true // opcional, por defecto es falso
    }
  ]
})

// lista de contenedores docker
const contenedores = await ssh.docker.containers()

// verificar si existe el contenedor
const existe = await ssh.docker.exists('nombre-contenedor')

// ejecutar comando en el contenedor
const resultado = await ssh.docker.exec('nombre-contenedor', 'ls -al')

// eliminar contenedor docker
await ssh.docker.remove('nombre-contenedor')

// eliminar imagen docker
await ssh.docker.removeImage(nombreImagen, versión)

// construir proyecto node.js
const registros = await ssh.docker.buildNode('/ruta/a/carpeta/de/origen')

// ejecutar proyecto node.js
const registros = await ssh.docker.runNode('nombre-contenedor', '/ruta/a/carpeta/de/origen', {
  puerto
})

await ssh.disconnect()