Sitecore コマンド ライン インターフェイスのインストール
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
Sitecore コマンド ライン インターフェイス (CLI) は、ターミナルにインストールするツールです。
既存の CLI インストールをアップグレードするには、「Sitecore コマンド ライン インターフェイスのアップグレード」を参照してください。
Sitecore CLI は、個々のプロジェクトのローカル ツール、またはすべてのプロジェクトのグローバル ツールとしてインストールできます。
Sitecore CLI をグローバル ツールとしてインストールすることはお勧めしません。異なる Sitecore インスタンスには、異なるバージョンの Sitecore CLI が必要になる場合があります。
Sitecore CLI をインストールする前に、.NET Core をワークステーションにインストールする必要があります。必要なバージョンの .NET Core がインストールされていない場合、次のメッセージが表示されます。
It was not possible to find any compatible framework version
The framework 'Microsoft.NETCore.App', version '<major.minor>' was not found.
Sitecore CLI をローカル プロジェクト ツールとしてインストールするには:
-
Sitecore Management Services をまだインストールしていない場合は、Sitecore Management Services をインストールします。
-
管理者権限でターミナルを開きます。
-
次のコマンドを実行して、Sitecore CLI をインストールします。
RequestResponsecd <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
オプションを使用します (非推奨)。インストールが正常に完了すると、次のメッセージが表示されます。
RequestResponseYou 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.
注記ターミナルに表示されるバージョンは、入手可能な最新の公式リリースです。
-
新しいプロジェクトを初期化するには、プロジェクト フォルダーで次のコマンドを実行します。
RequestResponsedotnet sitecore init
注記バージョン 4.1.0 以降、コマンド
sitecore init
は CLIと同じバージョンのデフォルト プラグインをsitecore.json
ファイルに追加します。プラグインはSitecore.DevEx.Extensibility.Serialization
、Sitecore.DevEx.Extensibility.Publishing
、Sitecore.DevEx.Extensibility.Indexing
、Sitecore.DevEx.Extensibility.ResourcePackage
です。次に Sitecore CLI コマンドを使用すると、CLI はプラグインを解決してインストールしようとします。 -
必要な
Publishing
およびSerialization
プラグインをインストールします。RequestResponsedotnet 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
コマンドを使用します。RequestResponseList of plugins: Sitecore.DevEx.Extensibility.Publishing v.4.0.0 Sitecore.DevEx.Extensibility.Serialization v.4.0.0
注記ターミナルに表示されるバージョンは、入手可能な最新の公式リリースです。
-
Sitecore CLI が機能することを確認するには、ターミナルのプロジェクト フォルダーに移動して、「
dotnet sitecore -h
」と入力します。Sitecore CLI を使用する準備が完了している場合、次のメッセージが表示されます。
RequestResponseRequired 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