次の方法で共有


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 -
入力エイリアス: ConnectedServiceNamestring. 必須。

これは、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 を使用して接続する場合、これは ParametersHostname に使用される値と同じです。


DatabaseName - データベース名の
string.

任意 データベースの名前。 データベース名が存在しない場合、スクリプトによってデータベース名が作成されます。

指定しない場合は、必要に応じて、指定された SQL ファイルまたはインライン SQL でデータベースが参照されていることを確認します。

注: MySQL データベース名では大文字と小文字が区別されます。


SqlUsername - サーバー管理者ログイン
string. 必須。

Azure Database for MySQL サーバーでは、ネイティブ MySQL 認証がサポートされています。 サーバーにはサーバーの管理者ログインで接続し、認証できます。 例: bbo1@fabrikam

MySQL Workbench を使用して接続する場合、これは ParametersUsername に使用される値と同じです。


SqlPassword - パスワード
string. 必須。

Azure Database for MySQL の管理者パスワード。 パスワードを思い出さない場合は、Azure portal からパスワード変更できます。

この文字列は、パイプライン内の変数で定義できます。 例: $(password)

また、変数型をセキュリティで保護するために secret としてマークすることもできます。


TaskNameSelector - 型の
string. 使用できる値: SqlTaskFile (MySQL スクリプト ファイル)、InlineSqlTask (インライン MySQL スクリプト)。 既定値: SqlTaskFile.

任意 スクリプト ファイルからインライン スクリプト & オプションのいずれかを選択します。

  • SqlTaskFile (既定値)、SqlFile 引数で使用します
  • InlineSqlTaskSqlInline 引数で使用します。

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


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. 必須。 使用できる値: AutoDetectIPAddressRange。 既定値: AutoDetect.

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

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

受け入れ可能な値:

  • automation エージェントのパブリック IP アドレスを自動検出する AutoDetect
  • 構成する IP アドレス範囲を明示的に指定する IPAddressRangeStartIpAddress パラメーターと 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 単一サーバーでのみ機能します。

必要条件

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