Slack CLI を使用してプロジェクトを作成する
メモ
日本語で受講されている方へ
Challenge は日本語の Trailhead Playground で開始し、かっこ内の翻訳を参照しながら進めていってください。Challenge での評価は英語データを対象に行われるため、英語の値のみをコピーして貼り付けるようにしてください。日本語の組織で Challenge が不合格だった場合は、(1) この手順に従って [Locale (地域)] を [United States (米国)] に切り替え、(2) [Language (言語)] を [English (英語)] に切り替えてから、(3) [Check Challenge (Challenge を確認)] ボタンをクリックしてみることをお勧めします。
翻訳版 Trailhead を活用する方法の詳細は、自分の言語の Trailhead バッジを参照してください。
Slack CLI を設定する
アプリケーションを構築してホストするには、Slack コマンドラインインターフェース (CLI) を使用します。Slack CLI を使用すると、コマンドラインから Slack アプリケーションを作成して管理できます。
以下は、MacOS 向けに Slack CLI をインストールして認証する手順です。Windows マシンを実行している場合は、こちらで手順を確認できます。
Slack CLI をインストールする
まず、Slack CLI をダウンロードします。
- [Applications (アプリケーション)] からターミナルウィンドウを開くか、Command とスペースバーを同時に押してからターミナルウィンドウを検索して選択します。
- 次のコマンドを使用して Slack CLI をダウンロードします。
curl -fsSL https://downloads.slack-edge.com/slack-cli/install.sh | bash - ターミナルウィンドウに、Slack CLI のインストール中であるというメッセージが表示されます。
-
slack versionコマンドを使用してインストールを確認します。
ターミナルウィンドウに、インストールされている Slack CLI のバージョンが表示されます。
Slack CLI のインストールで問題が発生した場合
何らかの理由で Slack CLI のインストールで問題が発生した場合は、こちらで一般的な問題のトラブルシューティング手順を確認してください。
Slack CLI を認証する
次に、Slack CLI を Trailhead Slack Playground に接続します。この手順で受け取る認証チケットには制限時間があり、5 分でタイムアウトになります。すぐに使用してください。タイムアウトになってエラーが返された場合は、手順を最初からやり直してください。
- Trailhead Slack Playground を開いていない場合は開きます。
- 次に、ターミナルウィンドウに戻り、auth チケットを取得するために
slack loginと入力します。Slack 環境でスラッシュコマンド /slackauthticket [48 character string] を実行する手順が表示されます。
- このスラッシュコマンドと文字列全体をコピーします。ターミナルウィンドウを開いたまま Trailhead Slack Playground に移動します。任意のチャンネルまたは DM にコマンドを入力します。ワークスペースを整理するために、#the-slack-cli のようなプライベートチャンネルを作成することもできます。コマンドを入力すると、Slack CLI に付与したすべての権限を一覧表示するモーダルが表示されます。
![Slack CLI が要求する権限 (「Slack アプリケーションに関する情報の表示」、「Slack アプリケーションデータストアのデータの表示」、「プライベートチャンネルの基本情報の表示」など) が一覧表示された [Slack CLI Authentication (Slack CLI 認証)] モーダル](https://res.cloudinary.com/hy4kyit2a/f_auto,fl_lossy,q_70/learn/projects/develop-a-slack-app-with-bolt/create-your-project-with-the-slack-cli/images/ja-JP/5a162c70b8202691a321390bff11ca68_kix.64bsnwj9wwkv.png)
-
[Confirm (確認)] をクリックして認証コードを取得します。
![8 文字の認証コードが表示された [Submit Challenge Code (認証コードを送信)] モーダル](https://res.cloudinary.com/hy4kyit2a/f_auto,fl_lossy,q_70/learn/projects/develop-a-slack-app-with-bolt/create-your-project-with-the-slack-cli/images/ja-JP/6597edce4b0c26db32cac3a9c7508c92_kix.dzzohhh0hlbg.png)
- 開いているターミナルウィンドウに認証コードをコピーして貼り付けます。
認証コードを入力すると、Slack CLI から認証成功のメッセージが表示されます。
これで、アプリケーションを構築してホストする準備が整いました。
プロジェクトを作成する
Slack CLI の create コマンドを使用すると、作業するプロジェクトを設定できます。
- ターミナルウィンドウで、
slack create say-hello --template slack-samples/bolt-js-getting-started-appと入力します。
これにより、Bolt の入門テンプレートに基づいて、マシン上に say-hello プロジェクトが作成されます。Slack CLI は、~/say-hello のパスにプロジェクトを作成し、プロジェクトの連動関係をインストールすると応答します。- Slack 開発者ツールのダウンロードに同意するように求められる場合は 同意してください。
- Slack 開発者ツールのダウンロードに同意するように求められる場合は 同意してください。
- プロジェクトが設定されたことを確認するには、コンピューターで
say-helloプロジェクトフォルダーを検索して開きます。
この手順で行った作業はローカル環境での作業ですので、こちらでは確認しません。[Verify step to earn 100 points (ステップを確認して 100 ポイントを獲得)] をクリックして、先に進みます。次の手順では、VS Code などのテキストエディターを使用して、アプリケーションを開発します。