run_once

여러 호스트를 대상으로 플레이북을 실행하여도 local_action과 같이 로컬에서 실행하는 경우가 발생할 수 있습니다. 이때, 해당 작업을 하나의 호스트에서만 수행하도록 하는 옵션이 run_once입니다.

- name: run only once
    command: /usr/bin/custom-command
    run_once: true

위와 같이 작성 시, 모든 호스트들 중에서 최초 호스트에서만 작업을 수행하게됩니다.

- name: copy only once
    local_action: command /usr/bin/custom/command
    run_once: true

또한 컨트롤러 역할의 로컬에서 작업을 수행하도록 하는 local_action과 함께 사용시 특히 유용할 수 있습니다.