ssh-docker

Sumor Cloud ツール。
詳細なドキュメント

ssh-docker は @sumor/ssh-tools 向けのdockerツールです

インストール

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()