Anypoint Code Builder の使用開始

logo cloud IDE Cloud IDE

logo desktop IDE Desktop IDE

これは進行中のベータリリースです。ベータ状態での Anypoint Code Builder の使用には、該当するベータサービス契約条件が適用されます。

Anypoint Code Builder は Visual Studio Code の Anypoint Extension Pack から構築されています。Anypoint Code Builder のデスクトップ IDE とクラウド IDE の両方でこれらの拡張機能が共有されます。クラウド IDE では、Web 用の Visual Studio Code のコードサーバー実装への組み込み拡張機能が提供されます。

  • デスクトップ IDE のセットアップ​: デスクトップ IDE の場合、拡張機能パックをローカルの Visual Studio Code IDE に読み込む必要があります。

  • クラウド IDE の起動​: クラウド IDE の場合、Anypoint Platform にログインして、Anypoint Code Builder を使用するための権限を取得する必要があります。

デスクトップ IDE のセットアップ

Anypoint Extension Pack のデスクトップベースの IDE 拡張機能は Visual Studio Marketplace で入手できます。

Desktop IDE のセットアップを開始する前に

デスクトップ拡張機能を VS Code にインストールする前に、git をセットアップし、必要な権限を持つ Anypoint Platform アカウントを用意します。

  • git​ をインストールして ​PATH​ に追加します。適切に機能させるために、一部の Anypoint Extension Pack 拡張機能はこの要件に基づきます。

  • Anypoint Platform にはユーザーアカウントが必要です。既存のアカウントを使用することも、US または EU クラウド (​「US および EU クラウドのホスト」​を参照) の Anypoint Platform からアカウントを作成することもできます。有効期限が切れていないトライアルアカウントは許可されます。

  • Anypoint Platform 組織アカウントを持つシステム管理者から必要な権限を付与してもらう必要があります。権限の設定を参照してください。

OS およびシステムの互換性についての詳細は、​「Anypoint Code Builder リリースノート」​を参照してください。

Anypoint Extension Pack をインストールする

Anypoint Extension Pack をデスクトップ IDE にインストールする手順は、次のとおりです。

  1. VS Code を開きます。

  2. デスクトップ IDE または Visual Studio Marketplace​ から ​Anypoint Extension Pack​ を見つけます。

    インストールエラーを回避する方法

    Visual Studio Marketplace の Anypoint Extension Pack から個別に入手することもできる個々の Anypoint Code Builder 拡張機能をインストールしないでください。

    • デスクトップ IDE からインストールするには、アクティビティメニューから [Extensions (拡張機能)] アイコンをクリックするか Cmd+Shift+x (Mac) または Ctrl+Shift+x (Windows) を押して [Extensions (拡張機能)] メニューを起動し、拡張機能パックを検索します。

      [Install Release Version (リリースバージョンをインストール)]​ を選択します。

    • Visual Studio Marketplace Web サイトからインストールするには、拡張機能パックを見つけてインストールします。

      [Install Release Version (リリースバージョンをインストール)]​ を選択します。

      追加の指針については、 Visual Studio Code Web サイト​を参照してください。

  3. [Extensions (拡張機能)] メニューを開き、Anypoint Extension Pack の拡張機能を確認します。

    Anypoint Extension Pack には次の拡張機能が含まれます。

    • Anypoint Code Builder - API 拡張機能

    • Anypoint Code Builder - APIkit 拡張機能

    • Anypoint Code Builder - DataWeave 拡張機能

    • Anypoint Code Builder - 連動関係拡張機能

    • Anypoint Code Builder - インテグレーション拡張機能

    • Anypoint Code Builder - Mule Runtime 拡張機能

    • Anypoint Code Builder - プラットフォーム拡張機能

      Anypoint Extension Pack の拡張機能に関するバージョン設定情報は、 「Change Log (変更ログ)」​を参照してください。

  4. アクティビティバーの [MuleSoft] アイコンをクリックして、Anypoint Code Builder 機能にアクセスして使用します。

    アクティビティバーの [Anypoint Code Builder] の [MuleSoft] アイコン
  5. [Quick Actions (クイックアクション)]​ と ​[Documentation (ドキュメント)]​ リンクを含む ​Anypoint Code Builder メニュー​が IDE に読み込まれることを確認します。

  6. Anypoint Platform アカウントを EU クラウドで実行している場合、​[Mule: Control Plane (Mule: コントロールプレーン)]​ 設定を ​[EU cloud (EU クラウド)]​ に変更します。

    指針については、​デスクトップ IDE を EU クラウドまたは US クラウドに設定する​を参照してください。

  7. IDE から Anypoint Platform へのログイン​の手順を実行します。

Anypoint Extension Pack の更新

デスクトップ IDE に Anypoint Extension Pack がインストールされている場合、 「Update an extension manually (拡張機能の手動更新)」​の VS Code 手順に従って拡張機能パックの最新バージョンに更新します。

Anypoint Extension Pack のアンインストール

通常、拡張機能パックや個々の Anypoint Code Builder 拡張機能を VS Code からアンインストールする必要はありません。たとえば、最初にアンインストールしなくても新しいバージョンに更新できます。

Anypoint Extension Pack をアンインストールするように決定した場合は、他の VS Code 拡張機能で使用する手順と同じ手順に従います。拡張機能パックをアンインストールすると、DataWeave 拡張機能や APIkit 拡張機能など、拡張機能パック内でバンドルされている個々の Anypoint Code Builder 拡張機能もアンインストールされます。

アンインストールする手順は、次のとおりです。

  1. VS Code を開きます。

  2. アクティビティバーから、[Extensions (拡張機能)] パネルを開きます。

  3. [Anypoint Extension Pack] を見つけて選択します。

  4. 開いた [Anypoint Extension Pack] タブで ​[Uninstall (アンインストール)]​ をクリックします。

  5. Anypoint Code Builder 拡張機能を [Extensions (拡張機能)] パネルから削除するには、いずれかの拡張機能で ​[Reload (再読み込み)]​ をクリックします。

追加の指針については、VS Code ドキュメント 「Manage extensions (拡張機能の管理)」​を参照してください。

再インストールはいつでも行うことができます。

クラウド IDE の起動

Anypoint Platform からクラウド IDE を起動します。Anypoint Platform ユーザーアカウントとビジネス組織は US クラウドまたは EU クラウドでホストされ、これらのホスト間で共有されません。

クラウド IDE を開始する前に

クラウド IDE を起動する前に前提条件を満たします。

  • Anypoint Platform にはユーザーアカウントが必要です。既存のアカウントを使用することも、US または EU クラウド (​「US および EU クラウドのホスト」​を参照) の Anypoint Platform からアカウントを作成することもできます。有効期限が切れていないトライアルアカウントは許可されます。

  • Anypoint Platform 組織アカウントを持つシステム管理者から必要な権限を付与してもらう必要があります。権限の設定を参照してください。

  • 重要な進行中のベータ情報を確認します。

    クラウド IDE は進行中のベータ期間中です。

    進行中のベータの間、クラウド IDE インスタンスが削除される場合があります。これにより、インテグレーション、自動化、API が失われます。

    詳細を表示するには、クリックしてください。

    作業内容を保存するには、Mule プロジェクトを CloudHub にデプロイするか、Mule プロジェクトをソース制御にコミットするか、API 仕様を Design Center にパブリッシュする必要があります。

    トライアル期間の終了後に Anypoint Code Builder へのアクセス権を失う Anypoint Platform トライアルアカウントを使用している場合、クラウド IDE インスタンスは削除されます。

    本番環境の API、インテグレーション、または自動化の開発に Anypoint Code Builder のベータバージョンを使用しないでください。

Anypoint Platform からクラウド IDE を開く

クラウド IDE を起動する手順は、次のとおりです。

  1. Anypoint Platform にログインします。

    • U.S. ホスト (すべての非 EU リージョンをサポート) の場合は anypoint.mulesoft.com

    • EU 準拠のホストの場合は eu1.anypoint.mulesoft.com

      1 つのクラウドにアカウントがあり、別のクラウドで作業する必要がある場合、別のクラウドでアカウントを作成してプロジェクトを作成し、プロジェクトの作業を行う必要があります。

  2. Anypoint Platform の使用に関する契約条件を受け入れます。

  3. [Launch Cloud IDE (クラウド IDE) を起動]​ をクリックします。

    Anypoint Platform のクラウド IDE の起動ボタン

    クラウド IDE のプロビジョニングが完了したら、IDE が開きます。プロビジョニングプロセスには数分かかることがあります。

    クラウド IDE 環境はユーザーアカウントに関連付けられています。クラウド環境には、自分のみがアクセスできる、Anypoint Platform UI 内に埋め込まれて​いない​一意の URL もあります。クラウド IDE をこの URL から直接再開したり、Anypoint Platform の Anypoint Code Builder から間接的に再起動したりできます。

  4. アクティビティバーの [MuleSoft] アイコンをクリックして、Anypoint Code Builder 機能を表示して使用します。

IDE から Anypoint Platform へのログイン

一部の Anypoint Code Builder 機能では、IDE から Anypoint Platform に直接ログインする必要があります。ログインが必要な場合、IDE にプロンプトが表示され、ログインプロセスに誘導されます。ただし、IDE からのログインは、IDE で MuleSoft 機能を開いてから行うことをお勧めします。

  • Anypoint Platform にはユーザーアカウントが必要です。既存のアカウントを使用することも、US または EU クラウド (​「US および EU クラウドのホスト」​を参照) の Anypoint Platform からアカウントを作成することもできます。有効期限が切れていないトライアルアカウントは許可されます。

  • Anypoint Platform 組織アカウントを持つシステム管理者から必要な権限を付与してもらう必要があります。権限の設定を参照してください。

IDE から、ステータスバーまたはコマンドを使用してログインできます。

ステータスバーを使用した IDE からのログイン

デスクトップ IDE とクラウド IDE のステータスバーにはログイン状況が表示されます。

  • [Not logged in to Anypoint Platform (Anypoint Platform にログインしていません)]​ は、Anypoint Platform への接続を必要とするタスクを実行するにはログインする必要があることを示しています。

    ステータスバーのログイン状況メッセージ

    ログインするには、この通知をクリックしてログインのプロンプトに従います。

  • ユーザー名へのリンクは、ログインしていることを示します。

    ログアウトするには、ユーザー名をクリックしてプロンプトに従います。

コマンドパレットを使用した IDE からのログイン

コマンドパレットを使用して Anypoint Platform にログインできます。

IDE からコマンドパレットでログインする手順は、次のとおりです。

  1. コマンドパレットを開きます。

    手順を表示
    • キーボードショートカットを使用する。

      • Mac: Cmd+Shift+p

      • Windows: Ctrl+Shift+p

    • デスクトップ IDE で、​[View (表示)]​ > ​[Command Palette (コマンドパレット)]​ を選択する。

    • クラウド IDE で、​​ (メニュー) アイコンをクリックし、​[View (表示)]​ > ​[Command Palette (コマンドパレット)]​ を選択する。

  2. 次のコマンドを選択します。

    MuleSoft: Login to Anypoint Platform
    login to anypoint platform

    「login」​と入力し、結果で検索条件を使用して必要なコマンドを選択できます。

  3. プラットフォームにサインインするように促されたら、​[Allow (許可)]​ を選択します。

    allow login to anypoint platform

    ログインしたら、Anypoint Platform に ​[You can close this page now (今すぐこのページを閉じることができます)]​ というメッセージが表示されます。

  4. ログインを検証するには、​[Not logged in to Anypoint Platform (Anypoint Platform にログインしていません)]​ が ​<your-username>​ に置き換えられていることを確認します。

デスクトップ IDE を EU クラウドまたは US クラウドに設定する

デスクトップ IDE では、Anypoint Platform コントロールプレーンを US クラウドまたは EU クラウドに変更することができます。US クラウドがデフォルトです。Anypoint Platform インスタンス間でユーザーアカウント、プロジェクト、その他のデータは共有されません。詳細は、​「US および EU クラウドホスト」​を参照してください。

  1. IDE の [Explorer] ビューで API 仕様が開いている場合、プロジェクトを閉じて、クラウドを切り替えたときに同期エラーが発生しないようにします。

    • デスクトップ IDE では、​[File (ファイル)]​ > ​[Close Folder (フォルダーを閉じる)]​ をクリックします。

    • クラウド IDE で、​​ (メニュー) アイコンをクリックし、​[File (ファイル)]​ > ​[Close Folder (フォルダーを閉じる)]​ を選択する。

  2. デスクトップ IDE のアクティビティバーから [Settings (設定)] タブを開きます。

    デスクトップ IDE から EU クラウドの選択
    • [Anypoint Code Builder] パネルから ​[Open ACB Settings (ACB 設定を開く)]​ (歯車) アイコンをクリックします。

    • アクティビティバーから ​[Manage (管理)]​ (歯車) アイコンをクリックし、​[Settings (設定)]​ を選択して、​[Settings (設定)]​ タブで ​mule​ を検索します。

  3. [Mule: Control Plane (Mule: コントロールプレーン)]​ までスクロールします。

  4. [US Cloud (US クラウド)]​ または ​[EU Cloud (EU クラウド)]​ を選択します。

  5. IDE を再起動してすべての変更を読み込みます。

  6. IDE から Anypoint Platform へのログイン​の手順を実行します。