Sitecore コマンド ライン インターフェイスのインストール

Version: 10.2
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

Sitecore コマンド ライン インターフェイス (CLI) は、ターミナルにインストールするツールです。

注記

既存の CLI インストールをアップグレードするには、「Sitecore コマンド ライン インターフェイスのアップグレード」を参照してください。

Sitecore CLI は、個々のプロジェクトのローカル ツール、またはすべてのプロジェクトのグローバル ツールとしてインストールできます。

重要

Sitecore CLI をグローバル ツールとしてインストールすることはお勧めしません。異なる Sitecore インスタンスには、異なるバージョンの Sitecore CLI が必要になる場合があります。

Sitecore CLI をインストールする前に、.NET Core をワークステーションにインストールする必要があります。必要なバージョンの .NET Core がインストールされていない場合、次のメッセージが表示されます。

RequestResponse
It was not possible to find any compatible framework version
The framework 'Microsoft.NETCore.App', version '<major.minor>' was not found.

Sitecore CLI をローカル プロジェクト ツールとしてインストールするには:

  1. Sitecore Management Services をまだインストールしていない場合は、Sitecore Management Services をインストールします

  2. 管理者権限でターミナルを開きます。

  3. 次のコマンドを実行して、Sitecore CLI をインストールします。

    RequestResponse
    cd <project folder>
    dotnet new tool-manifest
    dotnet nuget add source -n Sitecore https://sitecore.myget.org/F/sc-packages/api/v3/index.json
    dotnet tool install Sitecore.CLI 
    注記

    同じプロジェクトで作業している他の開発者は、dotnet tool restore を実行するだけで Sitecore CLI をインストールできます。

    CLI のグローバル インストールを実行するには、install コマンドを実行する際に -g オプションを使用します (非推奨)。

    インストールが正常に完了すると、次のメッセージが表示されます。

    RequestResponse
    You can invoke the tool from this directory using the following commands: 'dotnet tool run sitecore' or 'dotnet sitecore'.
    Tool 'sitecore.cli' {version information} was successfully installed. Entry is added to the manifest file {project-path}.config\dotnet-tools.json.
    注記

    ターミナルに表示されるバージョンは、入手可能な最新の公式リリースです。

  4. 新しいプロジェクトを初期化するには、プロジェクト フォルダーで次のコマンドを実行します。

    RequestResponse
    dotnet sitecore init
    注記

    バージョン 4.1.0 以降、コマンド sitecore init は CLIと同じバージョンのデフォルト プラグインを sitecore.json ファイルに追加します。プラグインは Sitecore.DevEx.Extensibility.SerializationSitecore.DevEx.Extensibility.PublishingSitecore.DevEx.Extensibility.IndexingSitecore.DevEx.Extensibility.ResourcePackage です。次に Sitecore CLI コマンドを使用すると、CLI はプラグインを解決してインストールしようとします。

  5. 必要な Publishing および Serialization プラグインをインストールします。

    RequestResponse
    dotnet sitecore plugin add -n Sitecore.DevEx.Extensibility.Serialization
    dotnet sitecore plugin add -n Sitecore.DevEx.Extensibility.Publishing
    注記

    Publishing コマンドおよび Serialization コマンドは、Sitecore CLI の NuGet 拡張リリースの一部として個別のプラグインになりました。

    インストールされているプラグインを確認するには、dotnet sitecore plugin list コマンドを使用します。

    RequestResponse
    List of plugins:
    Sitecore.DevEx.Extensibility.Publishing v.4.0.0
    Sitecore.DevEx.Extensibility.Serialization v.4.0.0
    注記

    ターミナルに表示されるバージョンは、入手可能な最新の公式リリースです。

  6. Sitecore CLI が機能することを確認するには、ターミナルのプロジェクト フォルダーに移動して、「dotnet sitecore -h」と入力します。

    Sitecore CLI を使用する準備が完了している場合、次のメッセージが表示されます。

    RequestResponse
    Required command was not provided.
    
    Usage:
      sitecore.cli [options] [command]
    
    Options:
      --version    Display version information
    
    Commands:
      login                  Authenticates the CLI to a Sitecore instance
      publish                Performs a publish operation on all content
      ser, serialization     Item serialization commands
      init                   Creates Sitecore configurations in current directory

何かフィードバックはありますか?

この記事を改善するための提案がある場合は、