Docker@0 — zadanie platformy Docker v0

Kompilowanie, tagowanie, wypychanie, uruchamianie obrazów platformy Docker lub uruchamianie polecenia platformy Docker. Użyj tego zadania z platformą Docker lub usługą Azure Container Registry.

Kompilowanie, tagowanie, wypychanie, uruchamianie obrazów platformy Docker lub uruchamianie polecenia platformy Docker. Użyj tego zadania z platformą Docker lub usługą Azure Container Registry.

# Docker v0
# Build, tag, push, or run Docker images, or run a Docker command.
- task: Docker@0
  inputs:
    containerregistrytype: 'Azure Container Registry' # 'Azure Container Registry' | 'Container Registry'. Required. Container Registry Type. Default: Azure Container Registry.
    #dockerRegistryConnection: # string. Alias: dockerRegistryEndpoint. Optional. Use when containerregistrytype = Container Registry. Docker Registry Service Connection. 
    #azureSubscription: # string. Alias: azureSubscriptionEndpoint. Optional. Use when containerregistrytype = Azure Container Registry. Azure subscription. 
    #azureContainerRegistry: # string. Optional. Use when containerregistrytype = Azure Container Registry. Azure Container Registry. 
    action: 'Build an image' # 'Build an image' | 'Tag images' | 'Push an image' | 'Push images' | 'Run an image' | 'Run a Docker command'. Required. Action. Default: Build an image.
    #dockerFile: '**/Dockerfile' # string. Required when action = Build an image. Docker File. Default: **/Dockerfile.
    #buildArguments: # string. Optional. Use when action = Build an image. Build Arguments. 
    #defaultContext: true # boolean. Optional. Use when action = Build an image. Use Default Build Context. Default: true.
    #context: # string. Optional. Use when action = Build an image && defaultContext = false. Build Context. 
    #imageName: '$(Build.Repository.Name):$(Build.BuildId)' # string. Required when action == Build an image || action == Push an image || action == Run an image. Image Name. Default: $(Build.Repository.Name):$(Build.BuildId).
    #imageNamesPath: # string. Required when action == Tag images || action == Push images. Image Names Path. 
    #qualifyImageName: true # boolean. Optional. Use when action = Build an image || action = Tag images || action = Push an image || action = Push images || action = Run an image. Qualify Image Name. Default: true.
    #additionalImageTags: # string. Optional. Use when action = Build an image || action = Tag images || action = Push an image || action = Push images. Additional Image Tags. 
    #includeSourceTags: false # boolean. Optional. Use when action = Build an image || action = Tag image || action = Push an image || action = Push images. Include Source Tags. Default: false.
    #includeLatestTag: false # boolean. Optional. Use when action = Build an image || action = Push an image || action = Push images. Include Latest Tag. Default: false.
    #imageDigestFile: # string. Optional. Use when action = Push an image || action = Push images. Image Digest File. 
    #containerName: # string. Optional. Use when action = Run an image. Container Name. 
    #ports: # string. Optional. Use when action = Run an image. Ports. 
    #volumes: # string. Optional. Use when action = Run an image. Volumes. 
    #envVars: # string. Optional. Use when action = Run an image. Environment Variables. 
    #workDir: # string. Optional. Use when action = Run an image. Working Directory. 
    #entrypoint: # string. Optional. Use when action = Run an image. Entry Point Override. 
    #containerCommand: # string. Optional. Use when action = Run an image. Command. 
    #detached: true # boolean. Optional. Use when action = Run an image. Run In Background. Default: true.
    #restartPolicy: 'no' # 'no' | 'onFailure' | 'always' | 'unlessStopped'. Required when action = Run an image && detached = true. Restart Policy. Default: no.
    #restartMaxRetries: # string. Optional. Use when action = Run an image && detached = true && restartPolicy = onFailure. Maximum Restart Retries. 
    #customCommand: # string. Required when action = Run a Docker command. Command. 
  # commands
    #addBaseImageData: true # boolean. Add base image metadata to image(s). Default: true.
  # Advanced Options
    #dockerHostEndpoint: # string. Docker Host Service Connection. 
    #enforceDockerNamingConvention: true # boolean. Force image name to follow Docker naming convention. Default: true.
    #workingDirectory: '$(System.DefaultWorkingDirectory)' # string. Alias: cwd. Working Directory. Default: $(System.DefaultWorkingDirectory).
    #memory: # string. Memory limit.

containerregistrytype - typ rejestru kontenerów
string. To jest wymagane. Dozwolone wartości: Azure Container Registry, Container Registry. Wartość domyślna: Azure Container Registry.

Wybierz pozycję "Azure Container Registry", aby nawiązać z nim połączenie przy użyciu połączenia z usługą platformy Azure. Wybierz pozycję "Rejestr kontenerów", aby nawiązać połączenie z usługą Docker Hub lub dowolnym innym prywatnym rejestrem kontenerów.

dockerRegistryConnection - połączenia usługi rejestru platformy Docker
Alias wejściowy: dockerRegistryEndpoint. string. Opcjonalny. Użyj polecenia , gdy containerregistrytype = Container Registry.

Określa połączenie usługi rejestru platformy Docker. Wymagane w przypadku poleceń, które muszą być uwierzytelniane w rejestrze.

subskrypcji platformy Azure
Alias wejściowy: azureSubscriptionEndpoint. string. Opcjonalny. Użyj polecenia , gdy containerregistrytype = Azure Container Registry.

Określa subskrypcję platformy Azure.

azureContainerRegistry - usługi Azure Container Registry
string. Opcjonalny. Użyj polecenia , gdy containerregistrytype = Azure Container Registry.

Określa usługę Azure Container Registry w wybranej subskrypcji platformy Azure. Obraz kontenera jest kompilowany, a następnie wypychany do tego rejestru kontenerów.

action - akcja
string. To jest wymagane. Dozwolone wartości: Build an image, Tag images, Push an image, Push images, Run an image, Run a Docker command. Wartość domyślna: Build an image.

Określa akcję platformy Docker.

dockerFile - plików platformy Docker
string. Wymagane, gdy action = Build an image. Wartość domyślna: **/Dockerfile.

Określa ścieżkę do pliku platformy Docker. Zadanie używa pierwszego znalezionego pliku platformy Docker do skompilowania obrazu.

addBaseImageData - Dodawanie metadanych obrazu podstawowego do obrazów
boolean. Wartość domyślna: true.

Wartość domyślna dodaje dane obrazu podstawowego, takie jak nazwa obrazu podstawowego i skrót, aby ułatwić śledzenie. Możesz zrezygnować, ustawiając wartość na false.

buildArguments - argumenty kompilacji
string. Opcjonalny. Użyj polecenia , gdy action = Build an image.

Określa zmienne czasu kompilacji dla pliku platformy Docker. Sformatuj każdą parę name=value w nowym wierszu.

defaultContext - użyj domyślnego kontekstu kompilacji
boolean. Opcjonalny. Użyj polecenia , gdy action = Build an image. Wartość domyślna: true.

Określa kontekst kompilacji katalogu, który zawiera plik platformy Docker.

kontekstu kompilacji context -
string. Opcjonalny. Użyj polecenia , gdy action = Build an image && defaultContext = false.

Określa ścieżkę do kontekstu kompilacji.

imageName - nazwa obrazu
string. Wymagane, gdy action == Build an image || action == Push an image || action == Run an image. Wartość domyślna: $(Build.Repository.Name):$(Build.BuildId).

Określa nazwę obrazu platformy Docker do kompilowania, wypychania lub uruchamiania.

imageNamesPath - ścieżki nazw obrazów
string. Wymagane, gdy action == Tag images || action == Push images.

Określa ścieżkę do pliku tekstowego zawierającego nazwy obrazów platformy Docker do tagowania lub wypychania. Wyświetl każdą nazwę obrazu w osobnym wierszu.

qualifyImageName - kwalifikowana nazwa obrazu
boolean. Opcjonalny. Użyj polecenia , gdy action = Build an image || action = Tag images || action = Push an image || action = Push images || action = Run an image. Wartość domyślna: true.

Określa kwalifikowaną nazwę obrazu z nazwą hosta połączenia usługi rejestru platformy Docker.

additionalImageTags - dodatkowe tagi obrazów
string. Opcjonalny. Użyj polecenia , gdy action = Build an image || action = Tag images || action = Push an image || action = Push images.

Określa dodatkowe tagi dla tworzonego lub wypychanego obrazu platformy Docker.

includeSourceTags - dołączanie tagów źródłowych
boolean. Opcjonalny. Użyj polecenia , gdy action = Build an image || action = Tag image || action = Push an image || action = Push images. Wartość domyślna: false.

Określa, czy mają być uwzględniane tagi Git podczas kompilowania lub wypychania obrazu platformy Docker.

includeLatestTag - dołączanie najnowszego tagu
boolean. Opcjonalny. Użyj polecenia , gdy action = Build an image || action = Push an image || action = Push images. Wartość domyślna: false.

Określa, czy podczas kompilowania lub wypychania obrazu platformy Docker należy uwzględnić tag najnowszej.

imageDigestFile - pliku skrótu obrazu
string. Opcjonalny. Użyj polecenia , gdy action = Push an image || action = Push images.

Określa ścieżkę do pliku, który został utworzony i wypełniony pełnym repozytorium obrazów skrót obrazu platformy Docker, który został wypchnięty.

containerName - nazwa kontenera
string. Opcjonalny. Użyj polecenia , gdy action = Run an image.

Określa nazwę kontenera platformy Docker do uruchomienia.

portów ports -
string. Opcjonalny. Użyj polecenia , gdy action = Run an image.

Określa porty w kontenerze platformy Docker do publikowania na hoście. Wyświetl listę każdego powiązania host-port:container-port w nowym wierszu.

volumes - woluminy
string. Opcjonalny. Użyj polecenia , gdy action = Run an image.

Określa woluminy do zainstalowania z hosta. Wyświetl listę każdego host-dir:container-dir w nowym wierszu.

envVars - zmiennych środowiskowych
string. Opcjonalny. Użyj polecenia , gdy action = Run an image.

Określa zmienne środowiskowe dla kontenera platformy Docker. Wyświetl listę każdej pary name=value w nowym wierszu.

katalogu roboczego workDir -
string. Opcjonalny. Użyj polecenia , gdy action = Run an image.

Określa katalog roboczy kontenera platformy Docker.

entrypoint - przesłonięcia punktu wejścia
string. Opcjonalny. Użyj polecenia , gdy action = Run an image.

Określa zastąpienie domyślnego punktu wejścia dla kontenera platformy Docker.

containerCommand - polecenia
string. Opcjonalny. Użyj polecenia , gdy action = Run an image.

Określa polecenie uruchamiania platformy Docker. Polecenie docker run najpierw tworzy zapisywalną warstwę kontenera na określonym obrazie, a następnie uruchamia ją przy użyciu określonego polecenia uruchamiania. Jeśli na przykład obraz zawiera prostą aplikację internetową platformy Python Flask, możesz określić python app.py, aby uruchomić aplikację internetową.

detached - uruchom w tle
boolean. Opcjonalny. Użyj polecenia , gdy action = Run an image. Wartość domyślna: true.

Określa, czy uruchamiać kontener platformy Docker w tle.

restartPolicy - zasady ponownego uruchamiania
string. Wymagane, gdy action = Run an image && detached = true. Dozwolone wartości: no, onFailure (po awarii), always, unlessStopped (chyba że zatrzymano). Wartość domyślna: no.

Określa zasady ponownego uruchamiania.

restartMaxRetries - maksymalna liczba ponownych prób ponownego uruchomienia
string. Opcjonalny. Użyj polecenia , gdy action = Run an image && detached = true && restartPolicy = onFailure.

Określa maksymalną liczbę ponownych prób ponownego uruchomienia, które próbuje demon platformy Docker.

customCommand - polecenia
string. Wymagane, gdy action = Run a Docker command.

Określa polecenie platformy Docker i argumenty do wykonania. Na przykład rmi -f image-name usuwa obraz.

dockerHostEndpoint - połączenia usługi hosta platformy Docker
string.

Określa połączenie usługi hosta platformy Docker. Domyślnie jest to host agenta.

enforceDockerNamingConvention - Wymuś nazwę obrazu zgodnie z konwencją nazewnictwa platformy Docker
boolean. Wartość domyślna: true.

Jeśli to ustawienie jest włączone, modyfikuje nazwę obrazu platformy Docker zgodnie z konwencjami nazewnictwa platformy Docker. Na przykład przekonwertuj wielkie litery na małe litery i usuń spacje.

katalogu roboczego workingDirectory -
Alias wejściowy: cwd. string. Wartość domyślna: $(System.DefaultWorkingDirectory).

Określa katalog roboczy dla polecenia platformy Docker.

memory - limit pamięci
string.

Określa maksymalną ilość pamięci dostępnej dla kontenera jako liczbę całkowitą z opcjonalnymi sufiksami, na przykład 2GB.

To zadanie definiuje następujące zmienne wyjściowe , które można używać w krokach podrzędnych, zadaniach i etapach.

DockerOutput
Przechowuje dane wyjściowe polecenia platformy Docker.

DockerOutputPath
ścieżka pliku zawierającego dane wyjściowe polecenia kompilacji.