dcstop

dcstop

DevContainer が作成したコンテナを停止する CLI ツール。

概要

VS Code の Dev Containers 拡張機能で作成されたコンテナが「Reopen Locally」しても停止しないことがあります。dcstop は対象のコンテナを特定して停止します。

• image ベース: devcontainer.config_file ラベルでコンテナを特定
• compose ベース: com.docker.compose.project ラベルでプロジェクトを特定
• Docker SDK for Go を使用してネイティブに Docker と連携（shell コマンドを発行しない）

インストール

Homebrew

brew install --casks dev-shimada/dcstop/dcstop

Go install

go install github.com/dev-shimada/dcstop@latest

リリースからダウンロード

Releases から対応するバイナリをダウンロードしてください。

ソースからビルド

git clone https://github.com/dev-shimada/dcstop.git
cd dcstop
go build -o dcstop .

補完

dcstop completion bash
dcstop completion zsh
dcstop completion fish

使い方

# カレントディレクトリの devcontainer を停止
dcstop

# 指定ディレクトリの devcontainer を停止
dcstop /path/to/project

# コンテナを停止後に削除（compose の場合はネットワークも削除）
dcstop --down
dcstop -d /path/to/project

# ボリュームも削除（--down が必要）
dcstop --down --volumes
dcstop -dv /path/to/project

# Docker context を指定して実行
dcstop --context my-remote-docker
dcstop -c desktop-linux /path/to/project

オプション

Docker Context

--context フラグで Docker context を指定できます。指定しない場合は以下の順序で決定されます：

1. --context フラグ
2. DOCKER_CONTEXT 環境変数
3. ~/.docker/config.json の currentContext（docker context use で設定）
4. DOCKER_HOST 環境変数
5. デフォルトの Docker ソケット

複数の devcontainer.json がある場合

プロジェクト内に複数の devcontainer.json がある場合、インタラクティブに選択できます。

? Select devcontainer:
  > workspace_devcontainer (image)
    workspace-node_devcontainer (compose)
    workspace-python_devcontainer (image)

開発

必要要件

• Go 1.21+
• Docker

テスト

go test ./... -v

ビルド

go build -o dcstop .

リリース

GoReleaser を使用してリリースを行います。

ローカルでのスナップショットビルド

# GoReleaser のインストール（未インストールの場合）
go install github.com/goreleaser/goreleaser/v2@latest

# スナップショットビルド（リリースせずにビルドのみ）
goreleaser build --snapshot --clean

# または全アーティファクトを生成
goreleaser release --snapshot --clean

リリース

GitHub Actions でタグをプッシュすると自動的にリリースされます。

# タグを作成してプッシュ
git tag v0.1.0
git push origin v0.1.0

手動でリリースする場合:

# GITHUB_TOKEN を設定
export GITHUB_TOKEN="your_github_token"

# リリース実行
goreleaser release --clean

ライセンス

MIT