package-script-writer

パッケージスクリプトライター (psw)

psw CLI ツールを使用して、Umbraco CMS のインストールスクリプトを生成および実行します。

ワークフロー

1. PSW CLI がインストールされているかを確認します:

   psw --version
   

   コマンドが見つからない場合、.NET ツールのパスが PATH に含まれていない可能性があります。次を試してください:

   • Linux/Mac: export PATH="$PATH:$HOME/.dotnet/tools" && psw --version
   • Windows: %USERPROFILE%\.dotnet\tools\psw --version

2. インストールされていない場合は、インストールします:

   dotnet tool install --global PackageScriptWriter.Cli
   

3. その後、psw コマンドを実行します (以下を参照)

非対話的な使用方法 (Claude Code)

使用するコマンドはこれです:

export PATH="$PATH:$HOME/.dotnet/tools"
psw -d -n ProjectName -s ProjectName -u --database-type SQLite --admin-email [email protected] --admin-password SecurePass1234 --auto-run

Umbraco は長時間実行される Web サーバーであるため、これを run_in_background: true で実行してください。

重要なフラグ:

• -d - 必須 - 完全なインストールスクリプトを生成します (これがないと、失敗する dotnet run のみが生成されます)
• -u - 無人インストールのデフォルトを使用します
• --auto-run - スクリプトを即座に実行します
• -o を --auto-run と組み合わせないでください (スクリプトが切り詰められます)

デフォルトの認証情報: [email protected] / SecurePass1234

パッケージを使用する場合

psw -d -n ProjectName -s ProjectName -u --database-type SQLite --admin-email [email protected] --admin-password "SecurePass1234" -p "uSync,Umbraco.Forms" --auto-run

特定のバージョンを指定する場合:

psw -d -n ProjectName -s ProjectName -u --database-type SQLite --admin-email [email protected] --admin-password "SecurePass1234" -p "uSync|18.0.0,Umbraco.Forms|18.0.0" --auto-run

重要

パスワードやユーザー名にエスケープ可能な文字を使用しないでください

主なオプション

フラグ	説明
-d, --default	必須 - 完全なインストールスクリプトを生成します
-n, --project-name	プロジェクト名
-s, --solution	ソリューション名
-u, --unattended-defaults	無人インストールのデフォルトを使用します
--database-type	SQLite, LocalDb, SQLServer, SQLAzure, SQLCE
--admin-email	無人インストール用の管理者メールアドレス
--admin-password	無人インストール用の管理者パスワード
--auto-run	生成されたスクリプトを実行します
-p, --packages	カンマ区切りのパッケージ (例: "uSync,Umbraco.Forms")
-t, --template-package	バージョンを任意で指定できる Umbraco テンプレート
-da, --delivery-api	Content Delivery API を有効にします

Umbraco の起動を待機する

バックグラウンドでコマンドを実行した後、準備が整うまでポーリングします:

# Check the output for the port number (e.g., "Now listening on: https://localhost:44356")
# Then poll until ready:
for i in {1..30}; do
  if nc -z localhost 44356 2>/dev/null; then
    echo "Umbraco is ready!"
    break
  fi
  sleep 2
done

その他のコマンド

psw versions              # Show Umbraco versions with support status
psw history list          # Show recent scripts
psw history rerun 1       # Re-run script #1
psw --clear-cache         # Clear cached API responses