https://d226lax1qjow5r.cloudfront.net/blog/blogposts/better-together-github-vonage-cli/github_vonage-cli.png

より良い関係を:GitHub & Vonage CLI

最終更新日 September 20, 2022

所要時間:1 分

はじめに

2022年も半分が過ぎようとしている。 CLI(コマンドライン・インターフェイス)の必要性はかつてないほど高まっている。伝統的に、コマンドライン・インターフェイスは上級ユーザー(開発者やパワーユーザーなど)が使用するのに対し、GUI(グラフィカル・ユーザー・インターフェイス)はユーザーフレンドリーで習得が容易なため、初心者に求められている。コンピューティングの原点に立ち戻って、さらに学びましょう。

初期のコンピューターシステムでは、ユーザーはキーボードでしか情報を入力できず、画面は(ほとんどの場合)テキストを表示するだけだった。コマンドの入力を間違えると、プログラムが終了したり、重要なファイルが削除されたりする危険性があった。数年後、マウスとカラースクリーンが登場し、ウィンドウズ3.11やOS/2ワープのような一般的なオペレーティングシステムが、(GUIを通じて)より親しみやすい対話方法をユーザーに提供し始めた。しかし、このような決定的な前進があっても、CLIの進歩は続いていた。 WindowsのコマンドプロンプトMacOSのターミナル.(アップルによるNeXTSTEPとOPENSTEPの買収に端を発する)。

最新のハードウェアやソフトウェア技術を使うことができるにもかかわらず、なぜ多くの企業(そして開発者)がいまだにCLIツールに投資しているのだろうか?

私は、2022年のCLIの目的を次のようにまとめることができると考えている:

  • コマンドに慣れれば、生産性を飛躍的に向上させることができる。

  • GUIに比べてメモリなどのリソースが少なくて済むため、あらゆるハードウェアで動作させることができます。

  • 舞台裏で何が起きているのかを、より厳密なレベルでコントロール(理解)することができる。

今日、多くのパワーユーザーや開発者は、ファイルシステムの表示や操作、コンピュータプロセスの管理、コードのデプロイ、反復タスクの実行にCLIを使用している。

ソフトウェア開発者やパワーユーザーがGUIよりもこれらの利点を好むのであれば、サービスを提供する企業がネイティブのCLIを提供し、アプリケーションやAPIとのやり取りをより簡単にすることは理にかなっている。この投稿で取り上げる2つのCLIは、gitやVonageのAPIで作業する際のワークフローを向上させるものです。この2つのCLIを使うことで、あなたとあなたのチームの生産性がこれまで以上に向上すると信じています。それでは始めましょう!

GitHub CLI

GitHub CLI GitHub CLIを使えば、好きなターミナルで GitHub を操作できる。これはフリーでオープンソースですが、GitHub CLIとGitLab CLIにはいくつかの違いがあります。 git. gitは、ローカルでホストしているバージョンのgit、Bitbucket、GitLabなどを使うなど、git操作全般に使われます。一方、Github CLIはGitHub専用に作られており、課題追跡などGitHubの様々な機能を管理することができます。

インストールは簡単だ。インストールは簡単です。 GitHub CLIのドキュメントにアクセスし、あなたのオペレーティング・システムとお好みのパッケージ・マネージャーを探してください。このチュートリアルはCLIについてのものなので、GUIインストーラーをダウンロードすることはお勧めしない。)

The Windows GUI Installer

ウィンドウズ11と を使っているのでを使っているので、次のコマンドを実行する choco install gh.

インストールしたら、最初に使うコマンドは次のとおりだ。 gh helpである:

Running gh help

ヘルプ機能を次のようなコアコマンドと組み合わせることもできます。 gh pr --helpのようなコアコマンドと組み合わせることもできます:

Running gh pr help

ヘルプ機能の使い方がわかったところで、次は GitHub で認証してアカウントを管理しましょう。それには gh auth login.GitHub CLI はあなたにいくつかの質問をします:

  • 個人アカウントか企業サーバーかを選択するには

  • gitの操作に使用するプロトコル

  • 認証方法(ブラウザまたはトークン)

ログインが完了すると、以下のような画面が表示されます:

Successful Login

を実行することで、いつでも認証ステータスを確認することができます。 gh auth status.

GitHub Authentication Status

レポを作成またはクローンして作業を開始できます。まったく新しいレポを作りたい場合は gh repo create.対話モードになるので、次のオプションを選択します。 GitHub に新しいリポジトリをゼロから作成する.画面の指示に従って、必ずローカルにリポジトリをクローンしてください。これが私の例です:

Finished GitHub repo setup

レポをクローンしたい場合は gh repo clone <directory>.以下は、私の不動産C#サンプル - をクローンする例です。 gh repo clone Vonage-Community/blog-sms-csharp-realestate.ここでも、出力がどのようになるかの例を示します:

Finished GitHub repo clone setup

GitHub CLI での基本的な操作方法がわかったところで、次は Vonage CLI の機能を見てみましょう。

Vonage CLI

Vonage CLI Vonage CLIを使うと、コマンドラインから Vonage アカウントやナンバーを管理したり、アプリケーションを設定したりすることができます。GitHub CLI と同様、フリーでオープンソースです。 Vonage Developer Dashboard.

インストールには Node.jsがインストールされている必要がある。Node.jsをインストールしたら、npm(Node Package Manager)を使って、次のように入力してインストールできます。 npm install -g @vonage/cli.

インストールしたら vonage helpを実行すると、使用できるコマンドの概要と説明が表示される。

Running vonage help

ヘルプ機能を次のようなコアコマンドと組み合わせることもできます。 vonage apps --helpと組み合わせることもできる:

Running Vonage apps help

この情報は、コア・コマンドとどのようにやり取りするかについての詳細を提供する。

注意:"help "という単語を綴る代わりに vonage apps -h"help "という単語を綴る代わりに、"help "を渡すことによっても省略構文を使うことができる。

GitHub CLI で行ったのと同じように Vonage で認証を行い、CLI がどのアカウントをプロビジョニングすべきかを理解できるようにします。

そのためには、現在のAPIキーとAPIシークレットを取得する必要があります。 Vonageデベロッパーポータルにアクセスし、以下のキーを安全な場所にコピーしてください。

Keys from the portal

簡単なヒントもし アカウントアカウントをお持ちでない場合は、無料で作成できます。

コマンドプロンプトに戻り、ApiKeyとAPISecretを以下のフォーマットで渡す必要がある: vonage config:set --apiKey=XXXXXX --apiSecret=XXXXXX

設定後、情報が正常に保存されたことを確認するには、次のように入力します。 vonage configを入力することで情報が正常に保存されたことを確認できる:

Vonage Config

次にしたいことは、使用予定のVonage API用のアプリケーションを作成することです。CLIの対話型モードを利用するには、次のように入力します。 vonage apps:create.

供給が必要だ:

  • アプリケーション名

  • 使いたいアプリの機能

  • メッセージウェブフックが必要かどうかを示す。

  • AIトレーニングにデータを使用するためのオプトイン・オプション

完成したフォームは以下のようになる:

Vonage App Created Successfully

メッセージ設定(ウェブフックアドレス)、公開鍵、独立したアプリファイル(Vonageアプリファイルや秘密鍵など)を提供することに注意してください。また、ハードディスクドライブ上に vonage_app.jsonapp_name.keyこのファイルにはアプリケーション ID、アプリケーション名、秘密鍵が含まれています。これらのキーを使って、Vonage API と対話することができる!

結論

お分かりのように、CLIは今でも開発者の生産性を高め、より多くのことを成し遂げるための強力な方法だ!このチュートリアルが、これら2つのCLIを使う冒険を始めるきっかけになれば幸いです。CLI ツールに関するご質問やフィードバックがありましたら、Vonage Developer Slack にご参加ください。 Vonage Developer Slackに参加するか ツイッターをお送りください。また次回の記事でお会いしましょう!

シェア:

https://a.storyblok.com/f/270183/400x400/7cdff37c0e/michael-crump.png
Michael Crumpデベロッパー・エクスペリエンス・マネージャー

マイケル・クランプはVonageのデベロッパーエクスペリエンスチームに所属し、コーダー、YouTuber、そして様々な.NETやクラウド/通信開発トピックについて頻繁に講演を行っています。彼は、開発者がそれぞれの利点を分かりやすく理解できるようにすることに情熱を注いでいます。