AzureMysqlDeployment@1 - デプロイ v1 タスクAzure Database for MySQL

このタスクを使用して、スクリプトを実行し、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.

入力

azureSubscription - Azure サブスクリプション
入力エイリアス: ConnectedServiceName。 string. 必須です。

これは、Azure アカウントに接続するために必要です。

新しいサービス接続を構成するには、一覧から Azure サブスクリプションを選択し、 をクリックします Authorize。

サブスクリプションが一覧にない場合、または既存のサービス プリンシパルを使用する場合は、 または Manage ボタンを使用して Azure サービス接続をAdd設定できます。

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 引数と共に使用します。

注: これらの値では大文字と小文字が区別されます。

SqlFile - MySQL スクリプト
string. TaskNameSelector = SqlTaskFile の場合に必要です。

自動化エージェントまたは自動化エージェントからアクセスできる 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 プラットフォーム上で使用されている場合、パスは変更されません。 パス内の特殊文字をエスケープする必要はありません。

SqlInline - インライン MySQL スクリプト
string. TaskNameSelector = InlineSqlTask の場合に必要です。

上で選択したデータベースで実行する MySQL スクリプトを入力します。

SqlAdditionalArguments - 追加の MySQL 引数
string.

省略可能。 MySQL クライアントでサポートされる追加オプション。 これらのオプションは、Azure Database for MySQLで指定されたファイルを実行するときに適用されます。

例: 既定のタブ区切り出力形式、HTML 形式、または XML 形式に変更できます。 その他の例は次のとおりです。

• --comments。クライアントからサーバーに送信されたコメントを削除します。
• --quick。結果がキャッシュされるのを防ぎます。
• --xml。結果を XML として出力します。

MySQL クライアントのドキュメントに、使用可能なオプションがすべて記載されています。

IpDetectionMethod - を使用してファイアウォール規則を指定する
string. 必須です。 使用できる値: AutoDetect、IPAddressRange。 既定値: AutoDetect。

タスクを正常に実行するには、管理者が自動化エージェントの IP アドレスからAzure Database for MySQL サーバーにアクセスできるようにする必要があります。

自動検出を選択すると、自動化エージェントの使用可能な IP アドレスの範囲に対してファイアウォール例外を自動的に追加したり、範囲を明示的に指定したりできます。

指定できる値:

• AutoDetect。自動化エージェントのパブリック IP アドレスを自動検出します。
• IPAddressRange。構成する IP アドレス範囲を明示的に指定します。 StartIpAddress および EndIpAddress パラメーターを使用して IP アドレス範囲を設定します。

注: これらの値では大文字と小文字が区別されます。

StartIpAddress - 開始 IP アドレス
string. IpDetectionMethod = IPAddressRange の場合に必要です。

オートメーション エージェント マシン プールの開始 IP アドレス。 (例: 196.21.30.50)。

EndIpAddress - 終了 IP アドレス
string. IpDetectionMethod = IPAddressRange の場合に必要です。

オートメーション エージェント マシン プールの終了 IP アドレス。 (例: 196.21.30.65)。

DeleteFirewallRule - タスク終了後にルールを削除する
boolean. 既定値: true。

省略可能。 選択した場合、オートメーション エージェントの IP アドレスに対して追加された例外は、対応するAzure Database for MySQLに対して削除されます。

タスク制御オプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。

出力変数

[なし] :

解説

このタスクを使用して、スクリプトを実行し、Azure Database for MySQL でご利用のデータベースに変更を加えます。 これはプレビュー バージョンであることに注意してください。 Azure Database for MySQL のデプロイ タスクは、Azure Database for MySQL 単一サーバーでのみ機能します。

要件

要件	説明
パイプラインの種類	YAML、クラシック ビルド、クラシック リリース
実行日	エージェント
確認要求	なし
Capabilities	このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限	Any
設定可能な変数	Any
エージェントのバージョン	1.100.0 以上
タスクのカテゴリ	配置