Kubernetes@0 - Kubectl v0 タスク

このタスクを使用して、コマンドを実行 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.

入力

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

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

namespace - 名前 空間
string.

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

command - コマンド
string. 使用できる値: 、、、deleteexec、expose、get、runlogs、set、 top。 createapply

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

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

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

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

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

arguments - 引数
string.

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

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

ジェネリック または docker を作成または更新します imagepullsecret。 を指定 dockerRegistry して、選択したレジストリの を imagepullsecret 作成または更新します。 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 レジストリを操作できます。 その他の標準コンテナー レジストリもサポートされています。

dockerRegistryConnection - Docker Registry サービス接続
入力エイリアス: dockerRegistryEndpoint。 string. 省略可能。 の場合は secretType = dockerRegistry && containerRegistryType = Container Registryを使用します。

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

azureSubscription - Azure サブスクリプション
入力エイリアス: azureSubscriptionEndpoint。 string. 省略可能。 の場合は secretType = dockerRegistry && containerRegistryType = Azure Container Registryを使用します。

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

注意

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

azureContainerRegistry - Azure Container Registry
string. 省略可能。 の場合は secretType = dockerRegistry && containerRegistryType = Azure Container Registryを使用します。

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

secretName - シークレット名
string.

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

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

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

configMapName - ConfigMap 名
string.

ConfigMaps を使用すると、構成成果物をイメージ コンテンツから切り離して、コンテナー化されたアプリケーションの移植性を維持できます。

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

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

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

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

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

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

configMapArguments - 引数
string. 省略可能。 の場合は useConfigMapFile = falseを使用します。

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

versionOrLocation - Kubectl
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 です。 これにより、特にホストされたビルド プールでは、必要ない可能性がある場合にダウンロード コストが発生します。

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

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

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

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

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

出力形式。

kubectlOutput - 出力変数名
string.

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

タスク制御オプション

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

出力変数

[なし] :

必要条件

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