AzureMysqlDeployment@1 - Azure Database for MySQL デプロイ v1 タスク
このタスクを使用して、スクリプトを実行し、Azure Database for MySQL のデータベースに変更を加えます。 Azure Database for MySQL デプロイ タスクは、Azure Database for MySQL 単一サーバーでのみ機能します。
構文
# Azure Database for MySQL deployment v1
# Run your scripts and make changes to your Azure Database for MySQL.
- task: AzureMysqlDeployment@1
inputs:
azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure Subscription.
# DB Details
ServerName: # string. Required. Host Name.
#DatabaseName: # string. Database Name.
SqlUsername: # string. Required. Server Admin Login.
SqlPassword: # string. Required. Password.
# Deployment Package
#TaskNameSelector: 'SqlTaskFile' # 'SqlTaskFile' | 'InlineSqlTask'. Type. Default: SqlTaskFile.
SqlFile: # string. Required when TaskNameSelector = SqlTaskFile. MySQL Script.
#SqlInline: # string. Required when TaskNameSelector = InlineSqlTask. Inline MySQL Script.
#SqlAdditionalArguments: # string. Additional MySQL Arguments.
# Firewall
IpDetectionMethod: 'AutoDetect' # 'AutoDetect' | 'IPAddressRange'. Required. Specify Firewall Rules Using. Default: AutoDetect.
#StartIpAddress: # string. Required when IpDetectionMethod = IPAddressRange. Start IP Address.
#EndIpAddress: # string. Required when IpDetectionMethod = IPAddressRange. End IP Address.
#DeleteFirewallRule: true # boolean. Delete Rule After Task Ends. Default: true.
入力
Azure サブスクリプションの azureSubscription
-
入力エイリアス: ConnectedServiceName
。
string
. 必須。
これは、Azure アカウントに接続するために必要です。
新しいサービス接続を構成するには、一覧から Azure サブスクリプションを選択し、[Authorize
] をクリックします。
サブスクリプションが一覧にない場合、または既存のサービス プリンシパルを使用する場合は、Add
または Manage
ボタンを使用して Azure サービス接続を設定できます。
ServerName
-
ホスト名の
string
. 必須。
Azure Database for MySQL サーバーの名前。
例: fabrikam.mysql.database.azure.com
サーバー名は、Azure Portal の Azure Database for MySQL サーバー リソースの [概要] ブレードで指定します。
MySQL Workbench を使用して接続する場合、これは Parameters
の Hostname
に使用される値と同じです。
DatabaseName
-
データベース名の
string
.
任意 データベースの名前。 データベース名が存在しない場合、スクリプトによってデータベース名が作成されます。
指定しない場合は、必要に応じて、指定された SQL ファイルまたはインライン SQL でデータベースが参照されていることを確認します。
注: MySQL データベース名では大文字と小文字が区別されます。
SqlUsername
-
サーバー管理者ログイン
string
. 必須。
Azure Database for MySQL サーバーでは、ネイティブ MySQL 認証がサポートされています。 サーバーにはサーバーの管理者ログインで接続し、認証できます。 例: bbo1@fabrikam
。
MySQL Workbench を使用して接続する場合、これは Parameters
の Username
に使用される値と同じです。
SqlPassword
-
パスワード
string
. 必須。
Azure Database for MySQL の管理者パスワード。 パスワードを思い出さない場合は、Azure portal からパスワード変更できます。
この文字列は、パイプライン内の変数で定義できます。 例: $(password)
。
また、変数型をセキュリティで保護するために secret
としてマークすることもできます。
TaskNameSelector
-
型の
string
. 使用できる値: SqlTaskFile
(MySQL スクリプト ファイル)、InlineSqlTask
(インライン MySQL スクリプト)。 既定値: SqlTaskFile
.
任意 スクリプト ファイルからインライン スクリプト & オプションのいずれかを選択します。
-
SqlTaskFile
(既定値)、SqlFile
引数で使用します -
InlineSqlTask
、SqlInline
引数で使用します。
注意: これらの値では大文字と小文字が区別されます。
mySQL スクリプトの SqlFile
-
string
.
TaskNameSelector = SqlTaskFile
する場合に必要です。
Automation エージェントまたはオートメーション エージェントからアクセスできる UNC パス上のスクリプト ファイルの完全パス。 (例: \BudgetIT\DeployBuilds\script.sql
)。
ここでは、$(agent.releaseDirectory)
などの定義済みのシステム変数と、SQL ステートメントを含むファイルを使用できます。
注: MySQL クライアントは Unix スタイルのパスを使用するため、バージョン 1.183.0 以降では、タスクは Windows スタイルパスを Unix スタイルパスに変換します。
例: c:\foo\bar\myscript.sql
から c:/foo/bar/myscript.sql
まで。
タスクが Linux プラットフォームで使用されている場合、パスは変更されません。 パス内の特殊文字をエスケープする必要はありません。
インライン MySQL スクリプトの SqlInline
-
string
.
TaskNameSelector = InlineSqlTask
する場合に必要です。
上記で選択したデータベースで実行する MySQL スクリプトを入力します。
追加の MySQL 引数を SqlAdditionalArguments
- する
string
.
任意 MySQL クライアントでサポートされる追加オプション。 これらのオプションは、Azure Database for MySQL で特定のファイルを実行するときに適用されます。
例: タブ区切りの既定の出力形式、HTML、または XML 形式に変更できます。 その他の例を次に示します。
- クライアントからサーバーに送信されたコメントを削除する
--comments
します。 - 結果のキャッシュを防ぐために
--quick
します。 - 結果を XML として出力する
--xml
。
使用可能なすべてのオプションについては、MySQL クライアントのドキュメントを参照してください。
IpDetectionMethod
-
を使用してファイアウォール規則を指定する
string
. 必須。 使用できる値: AutoDetect
、IPAddressRange
。 既定値: AutoDetect
.
タスクを正常に実行するには、管理者が Automation エージェントの IP アドレスから Azure Database for MySQL サーバーにアクセスできるようにする必要があります。
自動検出を選択すると、自動化エージェントの使用可能な IP アドレスの範囲に対してファイアウォール例外を自動的に追加したり、範囲を明示的に指定したりすることができます。
受け入れ可能な値:
- automation エージェントのパブリック IP アドレスを自動検出する
AutoDetect
。 - 構成する IP アドレス範囲を明示的に指定する
IPAddressRange
。StartIpAddress
パラメーターとEndIpAddress
パラメーターを使用して IP アドレス範囲を設定します。
注意: これらの値では大文字と小文字が区別されます。
StartIpAddress
-
開始 IP アドレス
string
.
IpDetectionMethod = IPAddressRange
する場合に必要です。
Automation エージェント マシン プールの開始 IP アドレス。 (例: 196.21.30.50
)。
EndIpAddress
-
エンド IP アドレスの
string
.
IpDetectionMethod = IPAddressRange
する場合に必要です。
Automation エージェント マシン プールの終了 IP アドレス。 (例: 196.21.30.65
)。
DeleteFirewallRule
-
タスクの終了後にルールを削除
boolean
. 既定値: true
.
任意 選択した場合、Automation エージェントの IP アドレスに対して追加された例外は、対応する Azure Database for MySQL に対して削除されます。
タスク コントロールのオプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「コントロール オプションと一般的なタスク プロパティを参照してください。
出力変数
なし。
注釈
このタスクを使用して、スクリプトを実行し、Azure Database for MySQL のデータベースに変更を加えます。 これはプレビュー バージョンであることに注意してください。 Azure Database for MySQL デプロイ タスクは、Azure Database for MySQL 単一サーバーでのみ機能します。