SSD Nodes Learn Hosting plans →
가이드 Matt Connor작성자 Matt Connor

systemd 의존성과 조건, Requires와 After 차이

Requires와 Wants는 종속성을, After와 Before는 순서를 정합니다. ExecStartPre와 Condition 계열의 차이, 부팅 시 unit이 실행되지 않는 원인과 디버깅 방법을 설명합니다.

Requires는 After를 의미하지 않는다

systemd 종속성과 조건은 서로 다른 4가지 메커니즘이지만, 대부분의 unit 파일은 이를 하나처럼 사용한다. Requires=와 Wants=은 어떤 다른 unit을 함께 가져올지 결정한다. After=와 Before=은 unit의 시작 순서를 결정한다. ExecStartPre=은 unit을 실패 상태로 만들 수 있는 검사를 실행한다. Condition 및 Assert 계열은 unit을 실행할지 자체를 결정한다. 각 메커니즘은 서로 독립적이다. 따라서 한 unit이 다른 unit을 요구하면서도 다른 unit과 정확히 같은 시각에 시작할 수 있다.

마지막 문장이 거의 모든 "수동으로 시작하면 작동하지만 부팅 시 실패한다"는 보고의 원인이다.

[Unit]
Description=Inventory API
Requires=postgresql.service

[Service]
ExecStartPre=/usr/bin/pg_isready -h 127.0.0.1 -t 5
ExecStart=/usr/local/bin/inventory-api

Requires=postgresql.service는 PostgreSQL을 같은 시작 트랜잭션에 포함한다. PostgreSQL이 준비될 때까지 기다리지는 않는다. systemd는 두 작업을 병렬로 시작하므로 PostgreSQL이 아직 데이터 디렉터리를 여는 동안 pg_isready가 실행된다. 아직 수신 대기 중인 프로세스가 없으므로 pg_isready는 종료 코드 2로 종료되고, ExecStart에 도달하기도 전에 unit이 실패한다. 1시간 뒤에 sudo systemctl start inventory-api을 실행하면 PostgreSQL이 이미 실행 중이므로 정상적으로 작동한다. unit 파일의 내용은 바뀌지 않았다. 따라서 파일 자체에는 문제가 없어 보인다.

수정 방법은 한 줄을 추가하는 것이다.

[Unit]
Requires=postgresql.service
After=postgresql.service

같은 부분에는 더 중요한 세부 사항이 있다. 실패하는 Requires= 종속성 때문에 unit의 시작이 중단되려면 해당 종속성에 After=도 설정해야 한다. 시작 순서를 지정하지 않으면 다른 unit이 실패할 때 systemd는 이미 대상 unit을 시작한 상태이므로 취소할 작업이 남아 있지 않다. Requires=만 설정해서는 사람들이 기대하는 보호 기능을 얻을 수 없다. 특별한 이유가 없다면 모든 Requires= 및 Wants= 옆에 After=을 작성한다.

Requires, Wants, Requisite 및 BindsTo의 의미

이 설정은 모두 의존성을 정의합니다. 순서를 지정하는 설정은 없습니다.

  • Wants=: 다른 unit을 함께 가져옵니다. 다른 unit이 실패하거나 존재하지 않아도 이 unit은 시작합니다. systemctl enable가 .wants/ 디렉터리 안에 symlink를 생성하는 방식이 바로 이것입니다.
  • Requires=: 다른 unit을 함께 가져옵니다. 다른 unit이 실패하고 After=도 함께 지정했다면 이 unit은 시작하지 않습니다. 이후 다른 unit을 명시적으로 중지하면 이 unit도 함께 중지합니다.
  • Requisite=: 다른 unit을 함께 가져오지 않습니다. 다른 unit이 이미 active 상태가 아니면 이 unit을 즉시 실패 처리합니다.
  • BindsTo=: Requires=과 비슷하지만, 다른 unit이 어떤 이유로든 중지될 때마다 이 unit도 중지합니다. 하드웨어가 사라지는 경우도 포함됩니다.
  • PartOf=: 다른 unit에서 이 unit으로 중지와 재시작이 전파됩니다. 시작은 전파되지 않습니다.
  • Conflicts=: 이 unit을 시작하면 다른 unit이 중지됩니다.

한 daemon이 다른 daemon과 통신하는 경우에는 일반적으로 Wants=와 After=를 함께 사용하는 것이 적절합니다. Requires=은 두 unit의 수명을 결합합니다. 유지 관리 목적으로 database를 중지하면 application도 함께 중지되고, database가 다시 시작되어도 application은 자동으로 다시 시작되지 않습니다. Wants=과 After=을 함께 사용하면 이러한 결합 없이 부팅 순서를 지정할 수 있습니다. 이후 의존성이 사라지는 경우는 restart policy로 처리합니다.

직접 작성하지 않은 의존성도 상속됩니다. 기본값인 DefaultDependencies=yes를 사용하면 일반 service에 Requires=sysinit.target, After=sysinit.target basic.target 및 Conflicts=shutdown.target가 자동으로 추가됩니다. 따라서 [Unit] section이 거의 비어 있는 service도 부팅 과정의 후반에 시작되고, 종료할 때 정상적으로 중지됩니다.

After와 Before는 트랜잭션의 순서만 정하며, 그 외에는 아무것도 하지 않는다

After=와 Before=는 순서만 정한다. 어떤 요구 사항도 추가하지 않는다. 다른 항목이 Redis를 가져오지 않는 unit에서 After=redis.service은 아무 동작도 하지 않는다. redis.service이 트랜잭션에 포함되지 않으면 기다릴 대상이 없으므로 해당 unit은 즉시 시작한다.

이 점은 아래에서 설명하는 network-online.target 실수의 정확한 형태이므로 다시 강조할 필요가 있다. 순서 지정은 동일한 트랜잭션에서 이미 시작 중인 unit만 기다린다.

두 설정은 대칭적이다. a.service에 After=b.service를 작성하는 것은 b.service에 Before=a.service을 작성하는 것과 같은 의미다. 따라서 둘 중 하나만 사용하고, 관리하는 unit에 작성한다. 종료할 때는 순서가 자동으로 반전되므로 After=b.service은 해당 unit이 b.service보다 먼저 중지된다는 의미이기도 하다.

After=는 "started"를 기다리며, Type=은 그 의미를 정의한다

After=는 다른 unit의 시작이 완료될 때까지 기다린다. "시작이 완료되었다"는 의미는 전적으로 해당 unit의 Type=이 결정한다.

  • Type=simple: systemd가 프로세스를 fork하는 즉시 시작된 것으로 간주한다. 프로그램이 아직 설정을 파싱하지 않았을 수 있으며, 소켓을 열기는커녕 초기화도 끝내지 않았을 수 있다.
  • Type=exec: execve()가 성공하는 즉시 시작된 것으로 간주한다. 조금 더 강한 조건이다. 그래도 준비가 완료되었다는 의미는 아니다.
  • Type=forking: 원래 부모 프로세스가 종료될 때 시작된 것으로 간주한다.
  • Type=oneshot: 프로세스가 종료될 때 시작된 것으로 간주한다. 여기서는 "started"가 실제 작업 완료를 의미한다.
  • Type=notify: 서비스가 알림 소켓으로 READY=1를 전송할 때 시작된 것으로 간주한다. 실제 준비 완료 상태를 보고하는 유일한 type이다.

따라서 Type=simple daemon에서 After=는 신뢰도가 낮은 약속이며, 첫 번째 예제에서 발생한 race의 두 번째 원인이기도 하다. 의존하는 unit이 Type=simple으로 제공되더라도, 해당 unit 뒤에 실행되도록 순서를 지정한다고 해서 연결을 수락할 준비가 되었다는 의미는 아니다. 해결 방법은 두 가지다. 해당 daemon의 socket unit 뒤에 순서를 배치하면 daemon이 시작되는 동안에도 커널이 들어오는 연결을 큐에 저장한다. 또는 자체 서비스에서 재시도하도록 만들고 restart policy가 이를 처리하게 한다. unit이 사용하는 type은 systemctl cat에서 확인할 수 있다. 순서 지정에 의존하기 전에 Type= 설정과 각 값이 systemd에 전달하는 의미를 읽어 보는 것이 좋다.

ExecStartPre는 unit을 실패시킬 수 있는 게이트다

ExecStartPre=는 ExecStart=보다 먼저 실행된다. ExecStartPre=가 0이 아닌 상태로 종료되면 활성화가 중단되고 unit은 failed 상태가 된다. ExecStart=는 실행되지 않는다. 실제 프로그램이 시작되지 않았기 때문에 프로그램 자체의 메시지 없이 실패하는 unit이 많은 이유가 여기에 있다.

다음 사항을 알아 두어야 한다.

  • shell이 아니다. 파이프, 리디렉션, glob, &&를 사용할 수 없다. 첫 번째 토큰은 절대 경로여야 한다. shell 구문이 필요하면 해당 줄을 /bin/sh -c '...'으로 감싸야 한다.
  • - 접두사를 사용하면 0이 아닌 종료 상태도 치명적이지 않게 만들 수 있다: ExecStartPre=-/usr/bin/optional-check.
  • 모든 ExecStartPre=는 다음 항목이 실행되기 전에 종료되어야 한다. 장시간 실행되는 프로세스를 시작할 수 없다.
  • 모든 ExecStartPre= 줄은 TimeoutStartSec=를 ExecStart=과 공유한다. 데이터베이스를 기다리며 반복하는 사전 검사는 시작 제한 시간을 소진한다. 그러면 journal에 start-pre operation timed out. Terminating.가 나타난 뒤 unit이 Result: timeout로 실패한다.

실패한 줄에는 주 프로세스가 아니라 제어 프로세스가 표시된다.

inventory-api.service: Control process exited, code=exited, status=2/INVALIDARGUMENT
inventory-api.service: Failed with result 'exit-code'.

이 symbolic name을 주의 깊게 확인해야 한다. systemd는 고정된 표를 통해 작은 종료 코드를 매핑한다. 따라서 프로그램이 해당 코드에 어떤 의미를 부여했든 2는 항상 INVALIDARGUMENT을 출력한다. 실제 정보를 전달하는 것은 status=203/EXEC다. systemd가 바이너리를 전혀 실행하지 못했다는 뜻이며, 경로가 잘못되었거나 파일에 실행 권한이 없기 때문이다.

디렉터리를 만들 때 ExecStartPre=를 사용하지 않아야 한다. RuntimeDirectory=, StateDirectory=, LogsDirectory= 및 CacheDirectory=은 올바른 소유자와 mode로 디렉터리를 만든다. RuntimeDirectory=은 서비스가 중지될 때 정리된다. 또한 이러한 방식은 직접 작성한 mkdir와 달리 DynamicUser= 환경에서도 올바르게 동작한다.

Condition은 조용히 실패하고 Assert는 크게 실패한다.

Condition 계열과 Assert 계열은 동일한 테스트를 수행한다. 테스트가 실패했을 때의 처리만 다르다.

Condition...=가 실패하면 해당 unit을 건너뛴다. 시작 작업은 성공으로 보고된다. unit은 inactive (dead) 상태로 유지되고, 실패로 표시되지 않으며, alert도 발생하지 않는다. journal에는 한 줄이 기록된다. 문구는 systemd release에 따라 다르다. 예를 들어 systemd 255에서는 실패한 테스트를 표시한다.

Inventory API was skipped because of an unmet condition check (ConditionPathExists=/etc/inventory/api.conf).

systemd 260 이상에서는 Inventory API skipped, unmet condition check ConditionPathExists=/etc/inventory/api.conf로 줄여서 표시하고, systemd 249 이하에서는 Condition check resulted in Inventory API being skipped.를 기록한다. unit의 journal에서 skipped를 검색하면 모든 변형을 찾을 수 있다.

systemctl status는 원인을 직접 출력한다.

     Active: inactive (dead)
  Condition: start condition unmet at Thu 2026-08-20 09:14:02 UTC; 2min ago

그 아래 들여쓴 줄에는 실패한 정확한 directive가 표시된다. 예를 들어 ConditionPathExists=/etc/inventory/api.conf was not met와 같다. systemd 252 이하에서는 헤더에 start condition unmet 대신 start condition failed를 출력한다.

Assert...=가 실패하면 시작 작업 자체가 실패한다. systemctl start는 Assertion failed on job for inventory-api.service.와 함께 0이 아닌 상태로 종료하고, journal에는 Assertion failed for Inventory API.가 기록되며, systemctl status에는 Assert: start assertion failed 줄이 표시된다. unit 자체는 여전히 failed 상태로 전환되지 않는다. 따라서 systemctl --failed와 실패한 unit만 감시하는 모니터링에는 표시되지 않는다. 오류는 시작을 요청한 사용자나 시스템으로 전달된다.

테스트가 실패한다는 의미를 기준으로 둘 중 하나를 선택한다. Condition는 "이 컴퓨터에는 이 unit이 적용되지 않는다"는 의미다. Assert는 "이 조건은 반드시 참이어야 하며, 그렇지 않으면 누군가에게 알려야 한다"는 의미다. 대부분의 unit에는 Condition가 적합하다. 아무 동작도 하지 않고 조용히 넘어가는 것보다 시작 작업 실패가 나은 경우에만 Assert를 사용한다.

Condition 계열에는 두 가지 함정이 있다.

첫째, 실패한 condition이 해당 unit에 의존하는 unit까지 실패시키지는 않는다. a.service에 Requires=b.service가 있고, b.service가 condition에 따라 건너뛰어져도 b.service의 시작 작업은 여전히 완료된 것으로 처리된다. 따라서 a.service는 b가 실행되지 않는 상태에서 정상적으로 시작한다. condition은 자신이 작성된 unit만 보호한다.

둘째, condition은 unit이 시작할 때마다 작업이 실행되는 순간 평가된다. VPS에서 실행되는 systemd timer가 트리거하는 unit은 연속해서 100번 건너뛰어도 한 번도 실패 상태로 표시되지 않을 수 있다. 이는 실행되지만 아무 작업도 하지 않는 cron job과 같은 종류의 조용한 no-op이다. 확인 방법도 같다. 종료 상태를 신뢰하지 말고 해당 unit의 journal을 읽어야 한다.

서버에서 알아 두어야 할 condition은 다음과 같다.

  • ConditionPathExists=/etc/inventory/api.conf 및 그 부정인 ConditionPathExists=!/etc/inventory/api.conf.
  • 패키지가 생성했지만 비워 둔 config 파일이나 데이터 디렉터리에 사용하는 ConditionFileNotEmpty= 및 ConditionDirectoryNotEmpty=.
  • 실제 kernel interface가 필요한 unit에 ConditionVirtualization=!container를 지정할 수 있게 하는 ConditionVirtualization=. 시스템이 보고하는 값을 systemd-detect-virt로 확인한다.
  • hostname 또는 machine ID와 일치시키는 ConditionHost=. 하나의 공용 unit 파일이 두 서버에서 다르게 동작하게 할 때 사용한다.
  • boot parameter 또는 최소 kernel 버전에 연결된 unit에 사용하는 ConditionKernelCommandLine= 및 ConditionKernelVersion=.

빈 assignment는 목록을 지운다. 따라서 drop-in에서 패키지가 제공한 condition을 제거할 수 있다.

[Unit]
ConditionPathExists=
ConditionPathExists=/srv/inventory/api.conf

network.target이 네트워크가 준비되었음을 의미하지 않는 이유

network.target은 상태가 아니라 동기화 지점이다. 부팅 시 이 대상 뒤에 순서를 지정하면 네트워크 관리 소프트웨어가 시작되었음을 의미한다. 인터페이스에 주소가 할당되었거나 인터넷 경로가 존재한다는 뜻은 아니다. 이 대상은 주로 반대 방향을 위해 존재한다. After=network.target 뒤에 순서를 지정한 unit은 종료 시 네트워크가 해제되기 전에 중지된다.

network-online.target이 실제로 기다리는 대상이다. 실행 중인 네트워크 관리자에 속한 wait-online 서비스가 이를 지원한다.

  • systemd-networkd가 링크를 관리하는 경우 systemd-networkd-wait-online.service. netplan을 통해 구성한 Ubuntu 서버에서는 일반적인 방식이다.
  • NetworkManager를 사용하는 경우 NetworkManager-wait-online.service.

이전 ifupdown 구성에서는 대신 networking.service을 사용하면 같은 효과를 얻는다. 어떤 대상을 사용하든 올바르게 구성하려면 한 줄이 아니라 2줄이 필요하다.

[Unit]
Wants=network-online.target
After=network-online.target

network-online.target은 기본 부팅 트랜잭션에 포함되지 않으며, 다른 unit이 자동으로 가져오지도 않는다. After=만 작성하면 아직 큐에 추가되지 않은 unit의 순서를 지정하게 되므로, 순서 지정이 전혀 작동하지 않는다. 앞에서 설명한 no-op이 가장 큰 비용으로 발생하는 경우다. Wants= 줄이 대상을 트랜잭션에 추가한다. 그래야 After= 줄이 기다릴 대상을 갖게 된다.

두 번째로 알아야 할 점은 "online"의 정의가 systemd가 아니라 wait-online 구현에 의해 결정된다는 것이다. systemd-networkd-wait-online은 자신이 관리하는 링크가 구성된 상태에 도달하면 반환한다. DNS가 해석되는지는 확인하지 않으며, 원격 호스트에 연결할 수 있는지도 확인하지 않는다.

이 정의 때문에 VPS에서 흔한 문제가 발생한다. netplan에 선언했지만 주소가 할당되지 않은 사설 네트워크용 두 번째 인터페이스가 있으면 wait 서비스가 시간 초과할 때까지 대기한다.

systemd-networkd-wait-online[612]: Timeout occurred while waiting for network connectivity.
systemd-networkd-wait-online.service: Failed with result 'exit-code'.

기본 시간 초과가 120초이므로 부팅에 2분이 추가된다. 해결 방법은 2가지다. netplan 파일에서 사용하지 않는 인터페이스를 optional: true로 표시하면 networkd가 해당 인터페이스를 기다리지 않는다. 또는 wait 서비스에 drop-in을 추가하고 --interface=로 필요한 링크를 지정하거나, --any을 전달해 링크 하나가 준비되는 즉시 반환하게 한다.

더 나은 방법은 이 대상이 필요하지 않도록 하는 것이다. 많은 서비스가 network-online.target 뒤에 순서를 지정하는 이유는 특정 주소 하나에 bind하기 때문이다. 이 주소가 부팅 시점에 아직 준비되지 않으면 다음과 같은 줄과 함께 실패한다.

nginx: [emerg] bind() to 203.0.113.10:443 failed (99: Cannot assign requested address)

커널은 해당 주소가 아직 준비되지 않았으므로 bind를 거부한다. net.ipv4.ip_nonlocal_bind=1을 설정하면 시스템이 아직 보유하지 않은 주소에도 프로세스가 bind할 수 있다. 나머지 문제는 restart policy로 처리할 수 있다. 일반적으로 소켓 하나의 문제를 해결하기 위해 전체 부팅을 네트워크 준비 상태까지 지연하는 것은 지나치게 큰 수단이다.

실행 중인 시스템에서 실제 systemd 의존성을 확인하는 방법

unit 파일만 보고 판단해서는 안 된다. drop-in, .wants/ 심볼릭 링크, 암시적 기본 의존성이 파일에 표시되지 않는 연결을 추가한다.

systemctl cat inventory-api.service

이 명령은 unit 파일과 모든 drop-in을 적용 순서대로 출력한다. 각 블록 위에는 원본 경로가 표시된다. 먼저 이 명령을 실행한다. /etc/systemd/system/inventory-api.service.d/에 있는 5줄짜리 override가 패키지에 포함된 파일보다 우선하며, 그렇지 않으면 확인할 수 없다.

systemctl show inventory-api.service -p Requires -p Wants -p After -p Before -p ConditionResult -p AssertResult

이 명령은 drop-in이 적용되고 systemd가 암시적 의존성을 추가한 뒤의 최종 값을 출력한다. ConditionResult=no는 “unit이 성공을 보고했지만 아무 작업도 하지 않았다”는 문제에 대한 직접적인 답이다.

systemctl list-dependencies inventory-api.service
systemctl list-dependencies --reverse inventory-api.service
systemctl list-dependencies --after inventory-api.service
systemctl list-dependencies --before inventory-api.service

기본 형식은 Requires=와 Wants=을 아래 방향으로 따라간다. --reverse는 현재 unit을 끌어오는 unit을 보여 준다. 이를 통해 부팅 시 해당 unit을 시작하는 target을 찾을 수 있다. --after와 --before은 실행 순서를 보여 준다. 실제로 무언가가 대기했는지 확인할 때 읽어야 하는 항목이 바로 이 두 가지다.

journalctl -b -u inventory-api.service --no-pager
journalctl -b -o short-precise -u inventory-api.service -u postgresql.service

두 번째 명령은 2개의 unit을 밀리초 단위 타임스탬프와 함께 시간순으로 섞어 출력한다. 이를 통해 추측이 아니라 실행 순서 경쟁 조건임을 입증할 수 있다. pg_isready 오류가 PostgreSQL이 database system is ready to accept connections을 기록하기 전에 발생하며, 두 시점 사이의 간격도 출력에 그대로 나타난다.

systemd-analyze verify /etc/systemd/system/inventory-api.service
systemd-analyze critical-chain inventory-api.service

verify는 systemd가 unit을 로드하는 방식으로 unit을 로드하고, 알 수 없는 지시어, 존재하지 않는 unit에 대한 의존성, 실행 순환, 파싱할 수 없는 구문을 보고한다. 시스템의 어떤 내용도 변경하지 않는다. critical-chain은 해당 unit의 시작을 지연시킨 실행 순서를 출력하며, 각 단계가 활성화된 시각도 표시한다. 이 명령은 현재 부팅 세션 중에 시작된 unit에만 사용할 수 있다.

unit 파일을 편집한 뒤에는 항상 sudo systemctl daemon-reload을 실행한다. 패키지에 포함된 unit을 변경하려면 sudo systemctl edit inventory-api.service를 사용한다. 이 명령이 drop-in을 대신 생성한다. /usr/lib/systemd/system/ 아래의 공급업체 파일을 직접 편집하면 다음 패키지 업그레이드 때 해당 파일이 교체될 때까지만 유지된다. 패키지가 소유한 파일을 건드리지 않고 서비스에 메모리 및 CPU 제한을 적용하는 방법도 동일한 drop-in 메커니즘을 사용한다.

순서 지정 주기와 journal에 남는 기록

양방향으로 순서를 지정하면 systemd는 transaction에서 작업 중 하나를 삭제해 루프를 해소하려고 합니다.

systemd[1]: Found ordering cycle on inventory-api.service/start
systemd[1]: Job postgresql.service/start deleted to break ordering cycle starting with inventory-api.service/start

systemd는 요청한 시작 작업에 필요하지 않은 작업만 삭제할 수 있습니다. 예를 들어 각 unit이 서로를 Requires=로 가리켜 루프의 모든 작업이 필수인 경우에는 systemd가 대신 처리를 포기합니다. journal에는 Unable to break cycle starting with inventory-api.service/start이 기록되고, 루프에 포함된 항목은 아무것도 시작하지 않으며, systemctl start는 Transaction order is cyclic. See system logs for details.로 실패합니다.

작업을 삭제할 때 systemd가 삭제할 작업을 선택하며, 사용자가 예상한 작업을 선택하지 않을 수도 있습니다. 그 결과 외부에서 확인하면 어떤 재부팅 뒤에는 서비스가 사라지고 다른 재부팅 뒤에는 나타나는 것처럼 보여 디버깅이 매우 어렵습니다. 대부분의 주기는 DefaultDependencies=no를 설정한 unit이 basic.target를 기준으로 다시 순서를 지정하거나, 이미 After=로 자신을 가리키는 unit에 Before=을 추가할 때 발생합니다. 재부팅하지 않고도 systemd-analyze verify로 이를 찾을 수 있습니다.

고정 unit

[Unit]
Description=Inventory API
Wants=postgresql.service network-online.target
After=postgresql.service network-online.target
ConditionPathExists=/etc/inventory/api.conf

[Service]
Type=notify
StateDirectory=inventory
ExecStart=/usr/local/bin/inventory-api
Restart=on-failure
RestartSec=5s

[Install]
WantedBy=multi-user.target

각 줄은 하나의 작업만 수행한다. Wants=은 이 unit의 수명을 종속 서비스와 연결하지 않고 두 종속 서비스를 트랜잭션에 포함한다. After=은 대기를 담당한다. 의존 관계와 시작 순서는 별도의 설정이므로 두 이름을 모두 다시 지정해야 한다. ConditionPathExists=은 패키지는 설치되어 있지만 설정이 없는 시스템에서 경고를 발생시키지 않고 unit을 조용히 건너뛴다는 뜻이다. 설정 기반 서비스에는 이것이 올바른 동작이다. Type=notify은 이 unit 뒤에 시작하도록 순서를 지정한 항목이 fork가 아니라 실제 준비 상태를 기다린다는 뜻이다. Restart=on-failure은 부팅이 한참 지난 뒤 데이터베이스가 중단되는 상황도 처리한다. 시작 순서는 최초 시작에만 적용되기 때문이다. 재시도를 얼마나 적극적으로 수행할지는 Restart= 및 RestartSec= 설정으로 제어한다.

신뢰하기 전에 확인한다.

sudo systemctl daemon-reload
systemd-analyze verify /etc/systemd/system/inventory-api.service
systemctl list-dependencies --after inventory-api.service
sudo systemctl start inventory-api.service
systemctl show inventory-api.service -p ConditionResult -p ActiveState -p Result

정상적인 unit은 ConditionResult=yes을 ActiveState=active과 함께 읽는다. Result=success은 마지막 실행에서 실패가 없었음을 확인한다. ConditionResult=no과 ActiveState=inactive이 함께 표시되면 unit이 건너뛰어진 것이다. 조건을 명시한 journal 줄에서 어떤 검사가 실패했는지 확인할 수 있다.

FAQ

Requires=가 다른 unit이 시작할 때까지 기다립니까?

아니다. Requires=와 After=은 별개의 설정이다. Requires=은 다른 unit을 같은 트랜잭션에 포함한 다음 systemd가 두 작업을 병렬로 시작하게 한다. 기다리려면 같은 unit을 지정하는 After=를 추가해야 한다. After=를 추가해야 하는 이유는 하나 더 있다. Requires= 의존성이 실패해도 After=가 함께 설정된 경우에만 해당 unit의 시작이 차단된다. 순서 지정이 없으면 다른 unit이 실패하기 전에 해당 unit이 이미 시작되기 때문이다.

network.target과 network-online.target 중 어느 뒤에 순서를 지정해야 합니까?

부팅 시 network.target는 네트워크 관리 소프트웨어가 시작되었다는 뜻일 뿐이다. 따라서 주소나 라우트가 준비되었다는 보장은 없다. 서비스 시작 시 사용할 수 있는 주소가 필요하면 network-online.target을 사용하고, Wants=network-online.target과 After=network-online.target을 모두 작성해야 한다. 해당 target은 기본 부팅 트랜잭션에 포함되지 않으며, After=만 설정하면 아무도 대기열에 넣지 않은 unit을 기다리게 되기 때문이다. 서비스가 특정 IP 하나에 bind할 때만 실패한다면 net.ipv4.ip_nonlocal_bind=1을 Restart=on-failure과 함께 사용하는 편이 부팅을 지연하지 않아 더 가볍다.

unit은 성공을 보고하지만 실제로는 실행되지 않는 이유가 무엇입니까?

Condition...= 테스트가 실패하면 해당 unit을 건너뛰고 시작 작업을 성공으로 보고한다. 따라서 실패로 표시되는 항목이 없다. systemctl show <unit> -p ConditionResult을 실행하고, ConditionResult=no로 이를 확인한다. 그런 다음 journalctl -b -u <unit>를 확인해 skipped이 포함된 줄을 찾는다. 최신 릴리스에서는 이 줄에 실패한 condition도 표시된다. systemctl status <unit>에는 충족되지 않은 정확한 directive도 표시된다.

Condition과 Assert의 차이는 무엇입니까?

두 설정은 동일한 테스트를 실행한다. Condition이 실패하면 해당 unit을 조용히 건너뛰며 작업은 계속 성공한다. Assert가 실패하면 시작 작업이 실패한다. systemctl start은 오류를 반환하고 journal에는 Assertion failed for <description>.이 기록된다. 어느 경우에도 unit이 failed 상태로 전환되지는 않는다. 따라서 systemctl --failed에도 표시되지 않는다. "이 unit은 이 머신에 적용되지 않는다"는 의미라면 Condition를 사용한다. 실제 대부분의 경우가 여기에 해당한다. unit을 시작하는 주체가 전제 조건 누락을 반드시 알아야 할 때만 Assert를 사용한다.

ExecStartPre가 status=203/EXEC로 실패하는 이유는 무엇입니까?

203/EXEC은 systemd가 명령을 전혀 실행하지 못했다는 뜻이다. 일반적인 원인은 절대 경로가 아닌 경로, 해당 머신에 존재하지 않는 바이너리, 실행 권한이 없는 파일, 또는 #! 줄에서 존재하지 않는 interpreter를 지정한 스크립트다. systemd의 다른 소수 코드는 고정된 표에서 나오므로 status=2/INVALIDARGUMENT은 명령이 2로 종료되었다는 뜻일 뿐이며 인수에 대해서는 아무것도 알려 주지 않는다. ExecStartPre=은 shell을 통해 실행되지 않는다는 점에 유의해야 한다. 따라서 pipe와 glob에는 /bin/sh -c '...'이 필요하다.

이 글이 도움이 되었나요?

#systemd#units#dependencies#ordering#troubleshooting