Salesforce CLI

🚀 Salesforce コマンドラインインターフェイス（CLI）統合ツール

Salesforce CLI 統合ツールは、Salesforce の開発と管理をコマンドラインから効率的に行うためのツールです。このツールを使用することで、プロジェクトの作成、設定、コマンドの実行などを簡単に行うことができます。

🚀 クイックスタート

インストールと初期化

Salesforce CLI 統合ツールを使用する前に、以下の手順でインストールと初期化を行ってください。

1. Salesforce CLI のインストール

• macOS：brew install salesforce/salesforce-cli を実行します。
• Windows：Salesforce CLI ダウンロードページ から MSI パッケージをダウンロードしてインストールします。
• Linux：以下のコマンドを使用します。

curl -o /usr/local/bin/sf https://cli-assets.s3.amazonaws.com/latest/cli.js && chmod +x /usr/local/bin/sf

2. ツールの初期化

sf init コマンドを実行して、Salesforce CLI 環境を初期化し、必要な依存関係をインストールします。

基本的な使い方

コアコマンドの例

• プロジェクトの作成：

sf project create --name MyProject

• プロジェクトの設定：

sf config:set -n MyProject --username yourUsername@example.com

• コマンドの実行：

sf apy:log:get --organization-id my-org-id

よく使うツール

• キャッシュの更新：sf_cache_refresh
• プロジェクト管理：sf_project_manage
• ログの取得：sf_apex_log_get

📚 ドキュメント

高度な統合

Salesforce CLI 環境変数の設定

.bashrc または .zshrc ファイルに以下の内容を追加します。

export SF_API_VERSION=58.0

プラグインの管理

sf plugins コマンドを使用して、インストールされているプラグインを表示したり、sf plugin install PLUGIN_NAME で新しいプラグインをインストールしたりできます。

パラメータの設定

迅速な設定例

sf config:set -n MyProject \
  --username yourUsername@example.com \
  --password yourPassword \
  --organization-id my-org-id

環境変数の設定

config.json ファイルを作成します。

{
  "default": {
    "instanceUrl": "https://my-domain.my.salesforce.com",
    "accessToken": "your-access-token"
  }
}

高度な機能

バッチ処理コマンド

コマンドを script.sh スクリプトファイルに保存します。

#!/bin/bash
sf apy:log:get --organization-id my-org-id > logs.txt
sf report:generate --type daily > report.pdf

次に、スクリプトに実行権限を付与して実行します。

chmod +x script.sh && ./script.sh

ログとデバッグ

--verbose フラグを使用して詳細なログ記録を有効にします。

sf apy:log:get --organization-id my-org-id --verbose

🔧 技術詳細

セキュリティに関する注意事項

• 資格情報の保護：コマンドラインに直接機密情報を入力しないでください。設定ファイルまたは環境変数を使用することをおすすめします。
• 権限管理：定期的にアクセストークンと API キーを確認し、更新してセキュリティを確保します。
• ネットワーク監視：CLI 操作は制御されたネットワーク環境で実行し、不正アクセスを防止します。

よくある質問

1. コマンドキャッシュが期限切れになった場合はどうすればいいですか？

sf_cache_refresh を実行してキャッシュを更新するか、~/.sf - mcp/command - cache.json ファイルを手動で削除してからサービスを再起動します。

2. プラグインのインストールに失敗した場合はどうすればいいですか？

ネットワーク接続を確認し、Salesforce サーバーにアクセスできることを確認してから、プロキシ設定を使用してみます。

sf plugin install PLUGIN_NAME --proxy http://proxy.example.com:8080

3. 設定ファイルが失われた場合はどうやって復元できますか？

sf init コマンドを再度実行して、デフォルトの設定ファイルを再構築します。

ドキュメントとリソース

• 公式ドキュメント：Salesforce CLI ドキュメント
• 開発者フォーラム：Salesforce 開発者コミュニティ
• サポートセンター：Salesforce サポート

以上の手順とガイドを参考にすることで、Salesforce CLI を使用した統合開発と管理を効率的に行うことができます。