Docker@0 – Docker v0-feladat

Docker-lemezképek létrehozása, címkézése, leküldése, futtatása vagy Docker-parancs futtatása. Használja ezt a feladatot a Dockerrel vagy az Azure Container Registryvel.

Megjegyzés

Docker@2 a feladat egy újabb verziója, amely leegyszerűsíti a feladatot azáltal, hogy eltávolítja azokat a bemeneteket, amelyek argumentumként átadhatók a parancsnak.

Syntax

# 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.

Bevitelek

containerregistrytype - Tárolóregisztrációs adatbázis típusa
string. Kötelező. Engedélyezett értékek: Azure Container Registry, Container Registry. Alapértelmezett érték: Azure Container Registry.

Az "Azure Container Registry" lehetőséget választva csatlakozhat hozzá egy Azure-szolgáltatáskapcsolat használatával. Válassza a Tárolóregisztrációs adatbázis lehetőséget a Docker Hub vagy bármely más privát tárolóregisztrációs adatbázishoz való csatlakozáshoz.

dockerRegistryConnection - Docker Beállításjegyzék-szolgáltatáskapcsolat
Bemeneti alias: dockerRegistryEndpoint. string. Választható. Használja a következőt: containerregistrytype = Container Registry.

Docker-beállításjegyzék-szolgáltatáskapcsolatot ad meg. A beállításjegyzékkel hitelesítendő parancsokhoz szükséges.

azureSubscription - Azure-előfizetés
Bemeneti alias: azureSubscriptionEndpoint. string. Választható. Használja a következőt: containerregistrytype = Azure Container Registry.

Egy Azure-előfizetést határoz meg.

azureContainerRegistry - Azure Container Registry
string. Választható. Használja a következőt: containerregistrytype = Azure Container Registry.

Egy Azure Container Registry a kiválasztott Azure-előfizetésben. A tárolórendszerkép létrejön, majd le lesz küldve ebbe a tárolóregisztrációs adatbázisba.

action - Akció
string. Kötelező. Engedélyezett értékek: Build an image, Tag images, Push an image, Push images, Run an image. Run a Docker command Alapértelmezett érték: Build an image.

Docker-műveletet határoz meg.

dockerFile - Docker-fájl
string. Akkor szükséges, ha action = Build an image. Alapértelmezett érték: **/Dockerfile.

Megadja a Docker-fájl elérési útját. A feladat az első docker-fájlt használja a rendszerkép létrehozásához.

addBaseImageData - Alapkép metaadatainak hozzáadása a kép(ek)hez
boolean. Alapértelmezett érték: true.

Az alapértelmezett érték hozzáadja az alapképadatokat, például az alaprendszerkép nevét és kivonatát a nyomon követhetőség érdekében. A leiratkozást úgy tilthatja le, ha az értéket értékre állítja false.

buildArguments - Argumentumok összeállítása
string. Választható. Használja a következőt: action = Build an image.

A Docker-fájl buildidejének változóit adja meg. Formázza az egyes name=value párokat egy új sorban.

defaultContext - Alapértelmezett buildkörnyezet használata
boolean. Választható. Használja a következőt: action = Build an image. Alapértelmezett érték: true.

Megadja a Docker-fájlt tartalmazó könyvtár buildkörnyezetét.

context - Buildkörnyezet
string. Választható. Használja a következőt: action = Build an image && defaultContext = false.

Megadja a buildkörnyezet elérési útját.

imageName - Kép neve
string. Akkor szükséges, ha action == Build an image || action == Push an image || action == Run an image. Alapértelmezett érték: $(Build.Repository.Name):$(Build.BuildId).

Megadja a létrehozandó, leküldéses vagy futtatandó Docker-rendszerkép nevét.

imageNamesPath - Képnevek elérési útja
string. Akkor szükséges, ha action == Tag images || action == Push images.

Megadja a címkézendő vagy leküldéses Docker-lemezképek nevét tartalmazó szövegfájl elérési útját. Az egyes rendszerképek nevei külön sorban listázva.

qualifyImageName - Kép nevének minősítése
boolean. Választható. Használja a következőt: action = Build an image || action = Tag images || action = Push an image || action = Push images || action = Run an image. Alapértelmezett érték: true.

Egy minősítő rendszerképnevet ad meg a Docker beállításjegyzék-szolgáltatás kapcsolatának állomásnevével.

additionalImageTags - További képcímkék
string. Választható. Használja a következőt: action = Build an image || action = Tag images || action = Push an image || action = Push images.

További címkéket ad meg a létrehozandó vagy leküldéses Docker-lemezképhez.

includeSourceTags - Forráscímkék belefoglalása
boolean. Választható. Használja a következőt: action = Build an image || action = Tag image || action = Push an image || action = Push images. Alapértelmezett érték: false.

Meghatározza, hogy a Docker-rendszerkép létrehozásakor vagy leküldésekor szerepeljenek-e Git-címkék.

includeLatestTag - Legújabb címke belefoglalása
boolean. Választható. Használja a következőt: action = Build an image || action = Push an image || action = Push images. Alapértelmezett érték: false.

Meghatározza, hogy a docker-rendszerkép létrehozásakor vagy leküldésekor szerepeljen-e a legújabb címke.

imageDigestFile - Képemelő fájl
string. Választható. Használja a következőt: action = Push an image || action = Push images.

Megadja a leküldéses Docker-lemezkép teljes rendszerkép-adattárának kivonatával létrehozott és feltöltött fájl elérési útját.

containerName - Tároló neve
string. Választható. Használja a következőt: action = Run an image.

Megadja a futtatni kívánt Docker-tároló nevét.

ports - Portok
string. Választható. Használja a következőt: action = Run an image.

A Docker-tárolóban a gazdagépen közzéteendő portokat adja meg. Az egyes host-port:container-port kötések listázása egy új sorban.

volumes - Kötetek
string. Választható. Használja a következőt: action = Run an image.

Meghatározza a gazdagépről csatlakoztatni kívánt köteteket. Mindegyik host-dir:container-dir listázása egy új sorban.

envVars - Környezeti változók
string. Választható. Használja a következőt: action = Run an image.

Meghatározza a Docker-tároló környezeti változóit. Listázd az egyes name=value párokat egy új sorban.

workDir - Munkakönyvtár
string. Választható. Használja a következőt: action = Run an image.

Meghatározza a Docker-tároló munkakönyvtárát.

entrypoint - Belépési pont felülbírálása
string. Választható. Használja a következőt: action = Run an image.

A Docker-tároló alapértelmezett belépési pontjának felülbírálása.

containerCommand - Parancs
string. Választható. Használja a következőt: action = Run an image.

Docker-futtatási parancsot ad meg. A docker-futtatási parancs először létrehoz egy írható tárolóréteget a megadott lemezképen, majd elindítja azt a megadott futtatási paranccsal. Ha például a kép egy egyszerű Python Flask-webalkalmazást tartalmaz, megadhatja python app.py , hogy elindítsa a webalkalmazást.

detached - Futtatás a háttérben
boolean. Választható. Használja a következőt: action = Run an image. Alapértelmezett érték: true.

Megadja, hogy futtassa-e a Docker-tárolót a háttérben.

restartPolicy - Szabályzat újraindítása
string. Akkor szükséges, ha action = Run an image && detached = true. Engedélyezett értékek: no, onFailure (Sikertelen), always, unlessStopped (Kivéve, ha le van állítva). Alapértelmezett érték: no.

Újraindítási szabályzatot ad meg.

restartMaxRetries - Újrapróbálkozések maximális újraindítása
string. Választható. Használja a következőt: action = Run an image && detached = true && restartPolicy = onFailure.

Megadja a Docker démon által kísérelt újraindítási újrapróbálkozások maximális számát.

customCommand - Parancs
string. Akkor szükséges, ha action = Run a Docker command.

Megadja a Végrehajtandó Docker-parancsot és argumentumokat. Például rmi -f image-name eltávolít egy képet.

dockerHostEndpoint - Docker-gazdagép szolgáltatáskapcsolata
string.

Docker-gazdagép-szolgáltatáskapcsolatot ad meg. Az ügynök gazdagépének alapértelmezett értéke.

enforceDockerNamingConvention - A kép nevének kényszerítése a Docker-elnevezési konvenciók követésére
boolean. Alapértelmezett érték: true.

Ha engedélyezve van, a Docker-rendszerkép nevét a Docker elnevezési konvenciók szerint módosítja. Alakítsa át például a nagybetűket kisbetűkké, és távolítsa el a szóközöket.

workingDirectory - Munkakönyvtár
Bemeneti alias: cwd. string. Alapértelmezett érték: $(System.DefaultWorkingDirectory).

A Docker-parancs munkakönyvtárát adja meg.

memory - Memóriakorlát
string.

A tároló számára rendelkezésre álló memória maximális mennyiségét adja meg egész számként, opcionális utótagokkal, például 2GB: .

Feladatvezérlési lehetőségek

Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Ez a feladat a következő kimeneti változókat határozza meg, amelyeket az alsóbb rétegbeli lépésekben, feladatokban és szakaszokban használhat fel.

DockerOutput
A docker parancs kimenetét tárolja.

DockerOutputPath
A build parancs kimenetét tartalmazó fájl elérési útja.

Megjegyzések

Docker@2 a feladat egy újabb verziója, amely leegyszerűsíti a feladatot úgy, hogy eltávolítja azokat a bemeneteket, amelyek argumentumként átadhatók a parancsnak.

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build, klasszikus kiadás
Futtatás	Ügynök, DeploymentGroup
Igények	None
Képességek	Ez a feladat nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások	Bármelyik
Változók beállítása	Bármelyik
Ügynök verziója	Minden támogatott ügynökverzió.
Feladatkategória	Build

Lásd még

• Docker@2