リリース管理に対してアプリケーションを配置するためのリリース アクション
リリースの各ステージの配置シーケンスを定義するリリース アクションを追加します。 各アクションには一連の引数でコマンドを実行する特定のツールを使用します。
リリース パスをまだ作成していない場合は、ここ これを実行します。
ツールボックスからリリース アクションをドラッグして、配置シーケンスに追加します。 ツールボックスに表示される定義済みのリリース アクションを使用するか、独自のカスタム リリース アクションを作成します。
![[アプリの構成] タブ、[リリース テンプレート] タブ](images/ff425471.rm_addactions(ja-jp,vs.120).png "[アプリの構成] タブ、[リリース テンプレート] タブ")
シーケンスにリリース アクションを追加すると、必要に応じて構成変数を編集できます。 定義済みのリリース アクションおよび構成変数の詳細については、こちらを参照してください。 リリース操作 ここに使用するツールについて説明します。
カスタム リリース アクションの追加
新しいリリース アクションを追加し、このアクションに使用するツールを選択します。 または、既存のアクションをコピーし、これを基にして、カスタム リリース アクションを作成できます。 既存のリリース アクションは編集できません。
Release Management クライアントで、インベントリ ページを開きます (ページが表示されない場合は、[インベントリを管理できる] アクセス許可を要求します)。
編集するアクションをコピーするか、新しいアクションを追加します。
.png "リリース操作のコピー")
アクションの要件に基づいて使用するツールを選択します。 Deploy Database シーケンスでそのステップに必要 定義済みのなツール なものを行う場合は、独自のカスタム ツールを追加するに [新規作成] をクリックします。
[実行] セクションで、適切な形式でトークンを使用して、必要な引数を入力します。 各 parameter:__ にこのプレフィックスとサフィックスを追加する必要があります。 トークンを使用して引数を削除または追加するたびに、これらは [パラメーター] の一覧に表示されます。
たとえば、トークンを使用して、次の引数を追加します: -servername __servername__ -switch __onoff__。 servername と onoff がパラメーターの一覧に表示されます。
リリース アクションを非アクティブ化するには
- チームで使用しないアクションがある場合は、それらを非アクティブ化します。 インベントリ ページのアクションを開き、[非アクティブ化] をクリックします。
リリース アクションを再アクティブ化するには
非アクティブ リスト、アクションの順に開いて、[アクティブ化] をクリックします。
.png "インベントリ ページの非アクティブ リスト")
Q & A
.gif "Ff425471.collapse_all(ja-jp,VS.120).gif")
Q: リリース アクションを編集するには、どのアクセス許可が必要ですか。
A: リリース アクションを編集または追加するには、[インベントリを管理できる] アクセス許可が必要です。 アクセス許可が無効である場合、インベントリ ページは表示されません。
[ツールなし] オプションが選択されていると、[アクションおよびコンポーネントでカスタム ツールを使用可能] アクセス許可を持っていない場合、"コマンド" および "引数" フィールドは編集できません。 [アプリの構成]、[コンポーネント] で、ユーザーが [アクションおよびコンポーネントでカスタム ツールを使用可能] アクセス許可を持っていない場合、"コマンド" および "引数" フィールドは [ツールなし] オプションが選択されていると編集できません。
リリース アクションのアクションと構成変数
アプリケーション プールと Web サイトの管理
.ini ファイルの作成または変更
SQL Server データベースの管理
サーバーの設定
Windows サービスの管理
アプリケーション プールと Web サイトの管理
これらのアクションは、定義済み IIS Deployer ツールを使用して、アプリケーション プール、Web サイト、Web アプリケーション、仮想ディレクトリを管理します。 これらのアクションは、IIS 7.0、7.5、8.0、および 8.5 でサポートされています。 このツールの詳細については、実行します ここ。
アクション |
使用および配置の失敗条件 |
|---|---|
.png "空のスペーサー") |
アプリケーション プールの作成: このアクションでは、IIS で新しいアプリケーション プールを作成します。 IIS 7.0、7.5、8.0、および 8.5 では、そのアプリケーション プールが既に存在するときには、そのアプリケーション プールが構成変数の値の定義に従って再構成されます (定義されていない構成変数は、アプリケーション プールの実際の構成に影響を及ぼすことはありません)。 IIS のバージョンが 7.0 より前で、そのアプリケーション プールが既に存在する場合には、配置が失敗します。 [アプリケーション プールの構成]、[アプリケーション プールのリサイクル]、[アプリケーション プールの開始]、または [アプリケーション プールの停止] : これらのアクションでは、アプリケーション プールを再構成、リサイクル、開始、または停止します。 アプリケーション プールが存在しない場合は、配置が失敗します。 |
|
[Web サイトの作成]: IIS で新しい Web サイトを作成します。 IIS 7.0、7.5、8.0、および 8.5 の場合です。 その Web サイトが既に存在する場合には、構成変数の値の定義に従って再構成されます (定義されていない構成変数は、Web サイトの実際の構成に影響を及ぼすことはありません)。 IIS のバージョンが 7.0 より前で、そのアプリケーション プールが既に存在する場合には、配置が失敗します。 [Web サイトの構成]、[Web サイトの再起動]、[Web サイトの開始]、[Web サイトの停止]: これらのアクションでは、Web サイトを再構成、再起動、開始、または停止します。 Web サイトが存在しない場合は、配置が失敗します。 |
|
[Web アプリケーションの作成]: IIS で新しい Web アプリケーションを作成します。 IIS 7.0、7.5、8.0、および 8.5 の場合です。 その Web アプリケーションが既に存在する場合には、構成変数の値の定義に従って再構成されます (定義されていない構成変数は、Web アプリケーションの実際の構成に影響を及ぼすことはありません)。 IIS のバージョンが 7.0 より前で、そのアプリケーション プールが既に存在する場合には、配置が失敗します。 [Web アプリケーションの構成] では、Web アプリケーションを再構成します。 Web アプリケーションが存在しない場合は、配置が失敗します。 |
|
[仮想ディレクトリの作成]: IIS で仮想ディレクトリを作成します。 IIS 7.0、7.5、8.0、および 8.5 の場合です。 指定した仮想ディレクトリが既に存在する場合には、構成変数の値の定義に従って再構成されます (定義されていない構成変数は、仮想ディレクトリの実際の構成に影響を及ぼすことはありません)。 [仮想ディレクトリの構成] では、仮想ディレクトリを再構成します。 仮想ディレクトリが存在しない場合は、配置が失敗します。 |
構成変数
パラメーター |
必須かどうか |
説明 |
|---|---|---|
AppPoolName |
○[アプリケーション プール関連のアクション] ×[Web サイト関連のアクション] |
構成、作成、リサイクル、削除、開始、または停止するアプリケーション プールの名前。[アプリケーション プール関連のアクション] 新しいまたは変更された Web サイトに使用するアプリケーション プールの名前。[Web サイト関連のアクション] |
DotNetVersion |
No |
アプリケーション プールに使用する .NET Framework のバージョン。 このパラメーターは、IIS 7.5、8.0、および 8.5 でのみ使用できます。 許可される値は、v1.0、v1.1、v2.0、または v4.0 です。 |
IdentityUserDomain |
No |
アプリケーション プールの ID に使用するユーザーのドメイン。 定義がなく、"IdentityUserName" が定義されている場合は、ユーザーはローカル ユーザー (つまり .\localuser) であると見なされます。 |
IdentityUserName |
No |
アプリケーション プールの ID に使用するユーザー名。 定義されていない場合、IdentityUserDomain パラメーターと IdentityUserPassword パラメーターは無視され、IIS の既定値 (つまり、ApplicationPoolIdentity) が使用されます。 |
IdentityUserPassword |
No |
アプリケーション プールの ID に使用するユーザーのパスワード。 |
Is32BitsAllowed |
No |
アプリケーション プールで 32 ビット アプリケーションの実行を許可する、または許可しないフラグ。 次の値を指定できます。
|
IsAutoStart |
No |
Windows を起動したときにアプリケーション プールまたは Web サイトが自動的に開始するかどうかを示すフラグ。次の値を指定できます。
|
IsPreloadEnabled |
No |
Web サイトまたは Web アプリケーションにプリロード機能を有効にするかどうかを示すフラグ。 次の値を指定できます。
|
PhysicalPath |
○[アクションの作成] ×[他のすべての仮想ディレクトリ、Web サイト、Web アプリケーションのアクション] |
仮想ディレクトリ、Web サイト、または Web アプリケーションの完全な物理パス。 |
PipeLineMode |
No |
アプリケーション プールに使用するマネージ パイプライン モード。 次の値を指定できます。
|
PortNumber |
○[アクションのみの作成] |
新しいまたは変更された Web サイトに使用するポート番号。 |
ProcessIdleTimeOut |
No |
アプリケーション プールでプロセスがアイドル状態になっていることができる時間 (分単位)。 |
RecycleAfterMinutes |
No |
アプリケーション プールのリサイクルまでの固定時間 (分単位)。 |
RecycleFixedTime |
No |
アプリケーション プールがリサイクルされる時刻。 形式は HH:MM にする必要があります (23:58、01:23 など)。 |
RecycleKbMemory |
No |
アプリケーション プールのリサイクルまでに使用できるメモリの最大量 (KB 単位)。 |
SiteName |
○[Web サイト関連のアクション] ×[仮想ディレクトリ関連のアクション] |
作成、構成、削除、開始、または停止する Web サイトの名前。[Web サイト関連のアクション] 仮想ディレクトリが存在する Web サイトの名前。 定義がない場合、既定の Web サイトが使用されます。[仮想ディレクトリ関連のアクション] |
StartMode |
No |
アプリケーション プールに使用する開始モード。 次の値を指定できます。
|
VirtualDirectoryName |
Yes |
作成、構成、または削除する仮想ディレクトリの名前。 |
WebApplicationName |
No |
仮想ディレクトリが存在する Web アプリケーションの名前。 定義がない場合、Web サイトのルート Web アプリケーションを使用します。 |
WebAppName |
Yes |
構成、作成、または削除する Web アプリケーションの名前。 |
WebSiteName |
○[Web サイト関連のアクション] ×[Web アプリケーション関連のアクション] |
構成、作成、削除、開始、または停止する Web サイトの名前。[Web サイト関連のアクション] Web アプリケーションが存在する Web サイトの名前。 定義がない場合、既定の Web サイトが使用されます。[Web アプリケーション関連のアクション] |
.ini ファイルの作成または変更
これらの .ini ファイルのアクションでは、ファイルからセクションとキーを追加、変更、または削除するために INI ファイル マネージャー ツールを使用します。 このツールの詳細については、実行します ここ。
アクション |
説明 |
|---|---|
キーの作成 |
.ini ファイルの特定のセクションに新しいキーとその値を作成します。 指定されたファイルが存在しない場合、ファイルが作成されます。 指定されたセクションが存在しない場合、セクションが作成されます。 指定されたセクションにキーが既に存在する場合は、その値が置き換えられます。 |
キーの変更 |
.ini ファイルの特定のセクションの既存のキーを新しい値に変更します。 指定されたファイルが存在しない場合、ファイルが作成されます。 指定されたセクションが存在しない場合、セクションが作成されます。 指定されたセクションにキーが既に存在する場合、その値が追加されます。 |
値の変更 |
.ini ファイルの特定のセクションの既存のキーの値を変更します。 指定されたファイルが存在しない場合、ファイルが作成されます。 指定されたセクションが存在しない場合、セクションが作成されます。 指定されたセクションに目的のキーが存在しない場合、このアクションで追加されます。 |
キーの削除 |
.ini ファイルの特定のセクションからキーとその値を削除します。 指定されたファイルが存在しない場合、このアクションは失敗します。 指定されたセクションまたはキーが存在しない場合でも、このアクションは成功します。セクションからすべてのキーを削除するように指定した場合、セクションも削除されます。 |
セクションの変更 |
.ini ファイル内のセクションの名前を変更します。 指定されたファイルが存在しない場合、ファイルが作成されます。 指定したセクションがない場合でも、このアクションは成功します。 |
セクションの削除 |
.ini ファイル内のセクションおよびすべてのキーと値を削除します。 指定されたファイルが存在しない場合、このアクションは失敗します。 指定したセクションがない場合でも、このアクションは成功します。 |
構成変数
パラメーター |
必須かどうか |
説明 |
|---|---|---|
INIFile |
Yes |
変更する .ini ファイルの名前とパス (必要に応じて)。 |
KeyName |
Yes |
作成、変更、または削除するキーの名前。 |
KeyValue |
No |
キーに割り当てる新しい値。 この値を指定せずに NewKeyName を指定した場合、実際の値が使用されます。 この値を指定せず、NewKeyName も指定しなかった場合、値は空になります。 |
NewKeyName |
No |
キーに割り当てる新しい名前。 これを指定しない場合、キーの名前は変更されません。 |
NewSectionName |
No |
セクション名に割り当てる新しい名前。 これを指定しない場合、元のセクションのキーがルート セクションの下に置かれます (最初のセクションの前の、ファイルの冒頭部にあるすべてのキーがルートに存在すると見なされます)。 |
SectionName |
No |
[キー アクションの作成または変更] キーを追加または変更するセクション名。 指定しない場合、ルート セクションが更新されます。 .gif "メモ") メモ
最初のセクションの前の、ファイルの冒頭部にあるすべてのキーがルートに存在すると見なされます。
[アクションの名前変更] 名前を変更するセクション名。 指定しない場合、古いセクションのキーはルート セクションに置かれます。 [アクションの削除] 削除されるセクション名。 指定しない場合、ルート セクションが削除されます。 |
SQL Server データベースの管理
これらのアクションでは、SQL Server データベースの作成、削除、バックアップ、および復元にデータベース配置 - スクリプトを実行しますツールを使用します。 このツールの詳細については、実行します ここ。
アクション |
説明 |
|---|---|
SQL データベースの作成 |
新しいデータベースを作成します。 そのデータベースが既に存在する場合、このアクションは失敗します。 |
SQL データベースのドロップ |
データベースを削除します。 そのデータベースが存在しない場合、このアクションは失敗します。 |
SQL データベースのバックアップ |
既存のデータベースを指定したパスにバックアップします。 |
SQL データベースの復元 |
指定したソースからデータベースを復元します。 |
構成変数
パラメーター |
必須かどうか |
説明 |
|---|---|---|
DatabaseName |
Yes |
作成、ドロップ、バックアップ、または復元する SQL Server データベースの名前。 |
Path |
Yes |
データベースのバックアップを格納するために使用するパスとファイル名。 たとえば、\\server\filename.bak です。 |
ServerName |
Yes |
SQL データベースが作成、バックアップ、復元、またはドロップされるサーバーの名前。 |
Source |
Yes |
データベースを復元するために使用するデータベース バックアップのパスとファイル名。 |
サーバーの設定
Windows オペレーティング システムを実行する場合、これらのアクションはサーバー コンピューターを設定するために使用できます。 コマンドを実行してプロセスを強制終了することも、ファイル、フォルダー、環境変数、および Windows レジストリ キーと値を管理することもできます。 システムは、コマンド ライン ランナー、Windows プロセス、XCopy 配置機能などのいくつかの定義済みの Release Management ツールを使用して、これらのアクションを実行します。 これらのツールの詳細については、実行します ここ。
アクション |
メモおよび配置の失敗条件 |
|---|---|
|
[コマンド ラインを実行] を使用して、配置エージェント ID でコマンドを実行します。 [次のユーザーとしてコマンド ラインを実行] を使用して、特定のユーザー資格情報でコマンドを実行します。 |
|
これらのアクションは、ファイル、フォルダーの作成、変更、および削除をサポートし、属性を選択します。 ファイルまたはフォルダーを作成する場合、作成するフォルダーに親ディレクトリが存在しないと、親ディレクトリも作成されます。 |
|
これらのアクションは、環境変数の作成、変更、および削除をサポートします。 |
|
これらのアクションは、レジストリ キーと値の作成、変更、および削除をサポートします。 配置シーケンスは、存在しないレジストリ キーを変更しようとした場合にのみ失敗します。 |
コマンドを実行するか、プロセスを強制終了する構成変数
パラメーター |
必須かどうか |
説明 |
|---|---|---|
Arguments |
No |
コマンド ラインの実行に必要な引数。 |
command |
Yes |
固定値 ./WindowsProcess.ps1。 |
FilePath |
No |
アプリケーション プールの ID に使用するユーザーのドメイン。 定義がなく、IdentityUserName が定義されている場合は、ユーザーはローカル ユーザー (つまり .\localuser) であると見なされます。 |
IsKillProcessTree |
No |
プロセス ツリーを強制終了するかどうかを示します。 次の値を指定できます。
|
ProcessName |
Yes |
強制終了する Windows プロセスの名前。 |
UserDomain |
No |
実行可能ファイルの実行に使用するユーザーのドメイン。 指定されていない場合、.\localuser が割り当てられます。 |
UserName |
○[コマンド アクションの実行] ×[プロセス アクションの強制終了] |
実行可能ファイルの実行に使用するユーザーの名前。 プロセスを実行しているユーザー アカウント。 指定がない場合には、すべてのユーザーのプロセスが強制終了となります。 |
UserPassword |
No |
実行可能ファイルの実行に使用するユーザーのパスワード。 |
ファイルおよびフォルダーを管理する構成変数
パラメーター |
必須かどうか |
説明 |
|---|---|---|
Archive |
No |
ファイルまたはフォルダーにアーカイブ属性を設定または解除します。
|
DestinationFileFolder |
アプリケーション プールに使用する .NET Framework のバージョン。 このパラメーターは、IIS 7.5、8.0、および 8.5 でのみ使用できます。 許可される値は、v1.0、v1.1、v2.0、または v4.0 です。 |
|
DestinationName |
Yes |
ファイルやフォルダーをコピーまたは移動するターゲット パス。 または、名前を変更するファイルまたはフォルダーに提供する新しい名前。 |
FileFolderName |
Yes |
削除、変更、移動、または名前を変更するソース ファイルまたはフォルダー。 削除アクションでは、ワイルドカード (c:、Temp、*.log など) を使用できます。 |
FolderName |
Yes |
作成するフォルダーの名前とパス。 |
Hidden |
No |
ファイルまたはフォルダーの隠し属性を設定または解除します。
|
OwnerDomain |
No |
ファイルまたはフォルダーの新しい所有者のドメイン。 指定されていない場合、.\localuser が割り当てられます。 |
OwnerDomain |
Yes |
ファイルまたはフォルダーの新しい所有者の名前。 |
ReadOnly |
ファイルまたはフォルダーに読み取り専用属性を設定または解除します。
|
|
SourceFileFolder |
Yes |
コピーするソース ファイルまたはフォルダー。 ワイルドカード (c:、Temp、*.log など) を使用できます。 |
System |
ファイルまたはフォルダーにシステム属性を設定または解除します。
|
環境変数アクションの構成変数
パラメーター |
必須かどうか |
説明 |
|---|---|---|
VariableName |
Yes |
作成、変更、または削除する変数の名前。 |
VariableValue |
No |
追加または変更する変数に設定する値。 値を設定しなかった場合には、変数が削除されます。 |
Windows レジストリ アクションの構成変数
パラメーター |
必須かどうか |
説明 |
|---|---|---|
NewRegistryKey |
Yes |
ターゲット レジストリ キーの完全な名前 (たとえば、HKLM、Software、NEWKEY)。 |
OperatingSystemType |
No |
レジストリ キーを作成するオペレーティング システムの種類。 次の値を指定できます。
|
RegistryData |
No |
レジストリ値に影響を及ぼすデータ。 |
RegistryKey |
Yes |
作成、変更、または削除するレジストリ キーの完全な名前。 たとえば、HKLM、Software、NEWKEY。 |
RegistryValue |
Yes |
追加または変更するレジストリ値の名前。 |
ValueType |
No |
レジストリ値のデータの種類。 次の値を指定できます。
|
Windows サービスの管理
これらのアクションは、Windows サービスを作成、構成、削除、再起動、開始、停止する、定義済みの Windows サービス マネージャー ツールを使用します。このツールの詳細については、実行します ここ。
アクション |
使用および配置の失敗条件 |
|---|---|
|
[サービスの作成] を使用して、新しいサービスを作成します。 サービスが既に存在する場合、配置シーケンスは失敗します。 既存のサービスを構成するには、[サービスの構成] を使用します。 サービスが存在しない場合、配置シーケンスは失敗します。 新しい資格情報で既存のサービスを構成するには、[サービス資格情報の構成] を使用します。 サービスが存在しない場合、配置シーケンスは失敗します。 また、サービスの開始、停止、または再起動を指定する場合に、指定された ServiceName が存在しないと、配置シーケンスは失敗します。 サービスが既に開始または停止している場合は、失敗にはなりません。 |
構成変数
パラメーター |
必須かどうか |
説明 |
|---|---|---|
BinPath |
No |
サービスのバイナリのパスと名前。 |
Description |
Yes |
作成または構成するサービスの説明。 |
DisplayName |
No |
作成または構成するサービスの名前。 |
Password |
No |
サービスを開始するために指定するユーザー名のパスワード。 |
ServiceName |
Yes |
作成、構成、削除、リサイクル、開始、または停止するサービスの名前。 |
StartMode |
No |
サービスの開始モード。 次の値を指定できます。
|
UserName |
Yes |
サービスを開始するための資格情報で使用されるユーザー名。 形式 DOMAIN\USER (たとえば、NT AUTHORITY\NETWORK SERVICE) を使用します。 UserName を指定する場合、Password も指定する必要があります。 LocalSystem に対する資格情報をリセットするには、ユーザー名として「LocalSystem」と入力し、パスワードは "" とします。 |