次の方法で共有

Kubernetes@0 - Kubectl v0 タスク

  • [アーティクル]

このタスクを使用して、kubectl コマンドを実行して、Azure Container Service で Kubernetes クラスターをデプロイ、構成、または更新します。

このバージョンのタスクは非推奨です。Kubernetes@1 を使用して、ワークロード ID フェデレーションなどの最新の機能を利用します。

このタスクを使用して、kubectl コマンドを実行して、Azure Container Service で Kubernetes クラスターをデプロイ、構成、または更新します。

構文

# Kubectl v0
# Deploy, configure, update a Kubernetes cluster in Azure Container Service by running kubectl commands.
- task: Kubernetes@0
  inputs:
    #kubernetesServiceConnection: # string. Alias: kubernetesServiceEndpoint. Kubernetes service connection. 
    #namespace: # string. Namespace. 
  # Commands
    #command: # 'apply' | 'create' | 'delete' | 'exec' | 'expose' | 'get' | 'logs' | 'run' | 'set' | 'top'. Command. 
    #useConfigurationFile: false # boolean. Use Configuration files. Default: false.
    #configuration: # string. Required when useConfigurationFile = true. Configuration file. 
    #arguments: # string. Arguments. 
  # Secrets
    secretType: 'dockerRegistry' # 'dockerRegistry' | 'generic'. Required. Type of secret. Default: dockerRegistry.
    #secretArguments: # string. Optional. Use when secretType = generic. Arguments. 
    containerRegistryType: 'Azure Container Registry' # 'Azure Container Registry' | 'Container Registry'. Required when secretType = dockerRegistry. Container Registry type. Default: Azure Container Registry.
    #dockerRegistryConnection: # string. Alias: dockerRegistryEndpoint. Optional. Use when secretType = dockerRegistry && containerRegistryType = Container Registry. Docker Registry service connection. 
    #azureSubscription: # string. Alias: azureSubscriptionEndpoint. Optional. Use when secretType = dockerRegistry && containerRegistryType = Azure Container Registry. Azure subscription. 
    #azureContainerRegistry: # string. Optional. Use when secretType = dockerRegistry && containerRegistryType = Azure Container Registry. Azure Container Registry. 
    #secretName: # string. Secret name. 
    #forceUpdate: true # boolean. Force update secret. Default: true.
  # ConfigMaps
    #configMapName: # string. ConfigMap name. 
    #forceUpdateConfigMap: false # boolean. Force update configmap. Default: false.
    #useConfigMapFile: false # boolean. Use file. Default: false.
    #configMapFile: # string. Required when useConfigMapFile = true. ConfigMap file. 
    #configMapArguments: # string. Optional. Use when useConfigMapFile = false. Arguments. 
  # Advanced
    #versionOrLocation: 'version' # 'version' | 'location'. Kubectl. Default: version.
    #versionSpec: '1.7.0' # string. Optional. Use when versionOrLocation = version. Version spec. Default: 1.7.0.
    #checkLatest: false # boolean. Optional. Use when versionOrLocation = version. Check for latest version. Default: false.
    #specifyLocation: # string. Required when versionOrLocation = location. Path to Kubectl. 
    #workingDirectory: '$(System.DefaultWorkingDirectory)' # string. Alias: cwd. Working directory. Default: $(System.DefaultWorkingDirectory).
  # Output
    #outputFormat: 'json' # 'json' | 'yaml'. Output format. Default: json.
    #kubectlOutput: # string. Output variable name.

入力

Kubernetes サービス接続の kubernetesServiceConnection -
入力エイリアス: kubernetesServiceEndpoint。 string.

Kubernetes サービス接続を選択します。


namespace - 名前空間の
string.

–namespace フラグを使用して、kubectl コマンドの名前空間を指定します。 名前空間が指定されていない場合、コマンドは既定の名前空間で実行されます。


command - コマンド
string. 使用できる値: apply、create、delete、exec、expose、get、logs、run、set、top。

実行する kubectl コマンドを指定します。


useConfigurationFile - 構成ファイルを使用する
boolean. 既定値: false.

kubectl コマンドで Kubernetes 構成ファイルを使用します。 Kubernetes 構成ファイルのファイル名、ディレクトリ、または URL も指定できます。


configuration - 構成ファイルの
string. useConfigurationFile = trueする場合に必要です。

コマンドで使用される kubernetes 構成ファイルのファイル名、ディレクトリ、または URL を指定します。


arguments - 引数
string.

指定した kubectl コマンドの引数を指定します。


secretType - シークレット の種類
string. 必須。 使用できる値: dockerRegistry、generic。 既定値: dockerRegistry.

ジェネリックまたは docker imagepullsecretを作成または更新します。 選択したレジストリの imagepullsecret を作成または更新する dockerRegistry を指定します。 imagePullSecret は、コンテナー レジストリ パスワードを含むシークレットを Kubelet に渡す方法であり、ポッドの代わりにプライベート イメージをプルできます。


secretArguments - 引数
string. 任意 secretType = genericするときに使用します。

シークレットに挿入するキーとリテラル値を指定します。 たとえば、--from-literal=key1=value1 や --from-literal=key2="top secret"などです。


コンテナー レジストリの種類を containerRegistryType - する
string. secretType = dockerRegistryする場合に必要です。 使用できる値: Azure Container Registry、Container Registry。 既定値: Azure Container Registry.

コンテナー レジストリの種類を選択します。 このタスクでは、Azure サブスクリプションの詳細を使用して、Azure Container Registry を操作できます。 その他の標準コンテナー レジストリもサポートされています。


Docker レジストリ サービス接続を dockerRegistryConnection - する
入力エイリアス: dockerRegistryEndpoint。 string. 任意 secretType = dockerRegistry && containerRegistryType = Container Registryするときに使用します。

Docker レジストリ サービス接続を選択します。 レジストリで認証する必要があるコマンドに必要です。


Azure サブスクリプション を する
入力エイリアス: azureSubscriptionEndpoint。 string. 任意 secretType = dockerRegistry && containerRegistryType = Azure Container Registryするときに使用します。

Azure Container Registry を含む Azure Resource Manager サブスクリプションを指定します。

注

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


Azure Container Registryを azureContainerRegistry - する
string. 任意 secretType = dockerRegistry && containerRegistryType = Azure Container Registryするときに使用します。

コンテナー イメージをプルし、アプリケーションを Kubernetes クラスターにデプロイするために使用される Azure Container Registry を指定します。 レジストリで認証する必要があるコマンドに必要です。


シークレット名を secretName - する
string.

シークレットの名前。 このシークレット名は、Kubernetes YAML 構成ファイルで使用できます。


forceUpdate - シークレット を強制的に更新する
boolean. 既定値: true.

シークレットが存在する場合は削除し、更新された値を持つ新しいシークレットを作成します。


ConfigMap 名を configMapName - する
string.

ConfigMap を使用すると、構成成果物をイメージ コンテンツから切り離して、コンテナー化されたアプリケーションを移植可能な状態に保つことができます。


forceUpdateConfigMap - configmap を強制的に更新する
boolean. 既定値: false.

configmap が存在する場合は削除し、更新された値を持つ新しい configmap を作成します。


useConfigMapFile - ファイル を使用する
boolean. 既定値: false.

個別のファイルから、またはディレクトリを指定して複数のファイルから ConfigMap を作成します。


ConfigMap ファイルを configMapFile - する
string. useConfigMapFile = trueする場合に必要です。

configMaps を含むファイルまたはディレクトリを指定します。


configMapArguments - 引数
string. 任意 useConfigMapFile = falseするときに使用します。

configMap に挿入するキーとリテラル値を指定します。たとえば、--from-literal=key1=value1 や --from-literal=key2="top secret"などです。


Kubectlを versionOrLocation - する
string. 使用できる値: version、location (場所の指定)。 既定値: version.

kubectl は、Kubernetes クラスターに対してコマンドを実行するためのコマンド ライン インターフェイスです。


versionSpec - バージョン 仕様の
string. 任意 versionOrLocation = versionするときに使用します。 既定値: 1.7.0.

取得するバージョンのバージョン スペックを指定します。 例: 1.7.0、1.x.0、4.x.0、6.10.0、>=6.10.0。


checkLatest - 最新バージョンの を確認する
boolean. 任意 versionOrLocation = versionするときに使用します。 既定値: false.

常にオンラインで、バージョンの仕様を満たす最新の使用可能なバージョン (stable.txt) を確認します。これは、常に最新の情報を取得する特定のシナリオがない限り、通常は false です。 これにより、特にホストされているビルド プールでは、必要ない可能性がある場合にダウンロード コストが発生します。


Kubectlへのパスの specifyLocation -
string. versionOrLocation = locationする場合に必要です。

kubectl.exe ファイルへの完全パスを指定します。


workingDirectory - 作業ディレクトリの
入力エイリアス: cwd。 string. 既定値: $(System.DefaultWorkingDirectory).

Kubectl コマンドの作業ディレクトリ。


outputFormat - 出力形式の
string. 使用できる値: json、yaml。 既定値: json.

出力フォーマット。


kubectlOutput - 出力変数名
string.

コマンドの出力を保存する変数の名前。


タスク コントロールのオプション

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

出力変数

なし。

必要条件

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