ssh-docker

Uma Ferramenta Sumor Cloud.
Mais Documentação

ssh-docker é uma ferramenta docker para @sumor/ssh-tools

Instalação

npm i @sumor/ssh-docker --save

Pré-requisitos

Versão Node.JS

Requer Node.JS versão 18.x ou acima

requer Módulo ES Node.JS

Como este pacote é escrito em módulo ES, por favor altere o seguinte código no seu arquivo package.json:

{
  "type": "module"
}

Uso

Importar ferramenta

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 ferramenta

import SSH from './ssh.js'

const ssh = new SSH(server)

await ssh.connect()

// construir imagem docker
const pastaOrigem = '/caminho/para/pasta/origem'
const nomeImagem = 'nome-imagem'
const versao = '1.0.0'
await ssh.docker.buildImage(pastaOrigem, nomeImagem, versao)

// lista de imagens
const imagens = await ssh.docker.images()

// verifica se a imagem existe
const existe = await ssh.docker.existsImage(nomeImagem, versao)

// executar contêiner docker
await ssh.docker.run({
  nome: 'nome-contêiner',
  imagem: nomeImagem,
  versao: versao,
  portas: [
    {
      de: 443, // porta do contêiner
      para: 30123 // porta do host
    }
  ],
  bindings: [
    {
      de: '/usr/source/config', // pasta do contêiner
      para: '/caminho/para/pasta/config', // pasta do host
      somenteLeitura: true // opcional, padrão é false
    }
  ]
})

// lista de contêineres docker
const contêineres = await ssh.docker.containers()

// verifica se o contêiner existe
const existe = await ssh.docker.exists('nome-contêiner')

// executar comando no contêiner
const resultado = await ssh.docker.exec('nome-contêiner', 'ls -al')

// excluir contêiner docker
await ssh.docker.remove('nome-contêiner')

// excluir imagem docker
await ssh.docker.removeImage(nomeImagem, versao)

// construir projeto node.js
const logs = await ssh.docker.buildNode('/caminho/para/pasta/origem')

// executar projeto node.js
const logs = await ssh.docker.runNode('nome-contêiner', '/caminho/para/pasta/origem', {
  porta
})

// executar Nginx
const logs = await ssh.docker.runNginx({
  nome: 'nome-contêiner',
  portas: [
    {
      de: 443, // porta do contêiner
      para: 30123 // porta do host
    }
  ],
  bindings: [
    {
      de: '/usr/source/config', // pasta do contêiner
      para: '/caminho/para/pasta/config', // pasta do host
      somenteLeitura: true // opcional, padrão é false
    }
  ]
})

// atualizar configuração do Nginx
await ssh.docker.updateNginx(dockerId)

// executar site
await ssh.docker.runSite({
  processosTrabalhadores: 2,
  conexõesTrabalhadores: 2048,
  porta: 30100,
  domínios: [
    {
      domínio: 'dev.example.com',
      servidores: [
        {
          host: 'dev.example.com',
          porta: 30001,
          maxFails: 3,
          maxConns: 5
        },
        {
          host: 'dev.example.com',
          porta: 30002,
          peso: 1
        }
      ]
    }
  ]
})

await ssh.disconnect()