# shishoctl CLI の Shisho Cloud プロジェクト管理機能を拡充

`shishoctl` CLI のプロジェクト管理コマンド `shishoctl project ...` が拡張されました。
拡張後の `shishoctl project ...` コマンドでは、プロジェクトの作成・削除、メンバーのロールを含む管理、スコープ設定、通知チャンネルの設定等が行えます。

これまで Shisho Cloud プロジェクトの大半の操作が Web UI 経由のみに限定されていました。
本拡張により、プロジェクトに対する操作を、CLI ベースでさらに効率化できます。

本拡張は、`v0.14.0` からご利用いただけます。

![eyecatch](/docs/ja/_md-assets/7c7dcbfed1-eyecatch.png)

## 概要

`shishoctl project ...` 以下のサブコマンドは、従来、検知結果やリソースの閲覧のみをサポートしていました。

拡張後の `shishoctl project ...` コマンドでは、Shisho Cloud プロジェクトの作成・削除、メンバーのロールを含む管理、スコープ設定、通知チャンネルの設定等が行えます。

例えば、新規プロジェクト作成は、以下のように行えます。

```shell
shishoctl project create --org <ORGANIZATION_ID> --name <PROJECT_NAME> --description <DESCRIPTION>
```

作成したプロジェクトに対するメンバーの追加は、以下のように行えます。

```shell
# 既存ユーザーをプロジェクトに追加
shishoctl project member add --org <ORGANIZATION_ID> --project <PROJECT_ID> --user <USER_ID> --role owner

# メンバーを同士に Shisho Cloud に招待する必要がある場合（ユーザーが Shisho Cloud 組織内に存在しない場合）
shishoctl project member invite --org <ORGANIZATION_ID> --project <PROJECT_ID> --email user@company.com --role viewer
```

プロジェクトを通して管理するリソースの追加は、`shishoctl project scope add` コマンドで行えます。
例えば Google Cloud プロジェクトを追加する場合は、以下のように行えます。

```shell
# Google Cloud プロジェクトをスコープに追加
shishoctl project scope add --org <ORGANIZATION_ID> --project <PROJECT_ID> --googlecloud-project-number <GOOGLECLOUD_PROJECT_NUMBER>
```

通知設定の変更も可能です。
設定したい通知先に応じて、`shishoctl project notification set` コマンドへのオプションを変更いただく必要があります。

```shell
# メールへの通知の追加
shishoctl project notification set --org <ORGANIZATION_ID> --project <PROJECT_ID> --email user@company.com

# Slack への通知の追加
shishoctl project notification set --org <ORGANIZATION_ID> --project <PROJECT_ID> --slack-workspace-id <WORKSPACE_ID> --slack-channel-id <CHANNEL_ID>
```

## 利用開始方法

Shisho Cloud ユーザーの皆様は、今すぐご利用いただけます。

ユーザーガイド:

- [プロジェクトの管理](https://shisho.dev/docs/ja/g/getting-started/accessing-via-shishoctl-cli/project-commands)
- [shishoctl CLI から操作する](https://shisho.dev/docs/ja/g/getting-started/accessing-via-shishoctl-cli)