azure self hosted agent linux do not run with "--once" parameter

Question

i like to run the self-hosted Linux container only once per pipeline that means when the pipeline is done i like the container to stop
i saw that there is a parameter called "--once"
please this link in the bottom :
https://docs.microsoft.com/en-us/azure/devops/pipelines/agents/docker?view=azure-devops

but when i start the docker like this with the once after the run :

docker run --once --rm -it -e AZP_WORK=/home/working_dir -v /home/working_dir:/azp -e AZP_URL=https://dev.azure.com/xxxx -e AZP_TOKEN=nhxxxxxu76mlua -e AZP_AGENT_NAME=ios_dockeragent xxx.xxx.com:2000/azure_self_hosted_agent/agent:latest

I'm getting :

unknown flag: --once
See 'docker run --help'.

also if i put it in the docker file as

COPY ./start.sh .
RUN chmod +x start.sh

CMD ["./start.sh --once"]

Im getting error when trying to run the docker :

docker: Error response from daemon: OCI runtime create failed: container_linux.go:349: starting container process caused "exec: \"./start.sh --once\": stat ./start.sh --once: no such file or directory": unknown

where do i need to set this "--once" command in dockerized agent?

Shayki Abramczyk Shayki Abramczyk · Accepted Answer · 2020-09-15T10:31:29

Is for the agent's run, not the docker run. from the docs:

For agents configured to run interactively, you can choose to have the agent accept only one job. To run in this configuration:

./run.sh --once

Agents in this mode will accept only one job and then spin down gracefully (useful for running in Docker on a service like Azure Container Instances).

So, you need to add it in the bash script you configure the docker image:

FROM ubuntu:18.04

# To make it easier for build and release pipelines to run apt-get,
# configure apt to not require confirmation (assume the -y argument by default)
ENV DEBIAN_FRONTEND=noninteractive
RUN echo "APT::Get::Assume-Yes \"true\";" > /etc/apt/apt.conf.d/90assumeyes

RUN apt-get update \
&& apt-get install -y --no-install-recommends \
        ca-certificates \
        curl \
        jq \
        git \
        iputils-ping \
        libcurl4 \
        libicu60 \
        libunwind8 \
        netcat

WORKDIR /azp

COPY ./start.sh .
RUN chmod +x start.sh --once

azure self hosted agent linux do not run with "--once" parameter

2 Answers