このタスクを使用して、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。
kubectl フラグを使用して、–namespace コマンドの名前空間を指定します。 名前空間が指定されていない場合、コマンドは既定の名前空間で実行されます。
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を作成または更新します。 選択したレジストリの 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 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。
コマンドの出力を保存する変数の名前。
タスク コントロールのオプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「コントロール オプションと一般的なタスク プロパティを参照してください。
出力変数
なし。