VPS 복제 후 중복된 /etc/machine-id 해결 방법
복제된 VPS가 동일한 /etc/machine-id를 가지면 DHCP 임대 충돌이 발생합니다. 파일을 안전하게 비우고 재생성하는 명령어와 골든 이미지 생성 전 필수 초기화 단계를 상세히 설명합니다. 재부팅을 포함한 올바른 적용 절차를 확인하십시오.
/etc/machine-id의 정의와 중복이 중요한 이유
복제된 VPS는 복제 원본 서버와 동일한 /etc/machine-id를 가지고 부팅되는데, 이 값은 단 하나의 설치 환경에만 고유하게 할당되어야 합니다. 해결 방법은 네 가지 명령어를 실행하는 것입니다. 파일을 비우고, D-Bus 복사본이 실제 파일인 경우 이를 삭제한 뒤, 재생성하고 재부팅합니다. 사람들이 흔히 건너뛰는 재부팅 단계가 변경 사항을 실제로 적용하는 핵심 과정입니다.
/etc/machine-id에는 줄 바꿈 문자로 끝나는 32자 길이의 소문자 16진수 문자열이 저장됩니다. 이를 디코딩하면 16바이트(128비트) 값이 됩니다. machine-id(5) 매뉴얼 페이지는 이 값을 기밀로 분류하며, 네트워크에 노출해서는 안 된다고 명시합니다. 이 값을 읽을 수 있는 대상은 나중에 해당 머신을 다시 식별할 수 있기 때문입니다. 이 값은 일반적으로 설치 시점이나 최초 부팅 시 생성되며, 이후 부팅 과정에서도 일정하게 유지됩니다.
여기서 세 가지 식별자가 혼동되기 쉬우므로 구분할 필요가 있습니다. 호스트네임은 사용자가 선택하며 언제든 변경할 수 있는 레이블입니다. /sys/class/dmi/id/product_uuid에 포함된 DMI(desktop management interface) 제품 UUID는 하이퍼바이저에서 제공하며 root 권한으로만 읽을 수 있습니다. 머신 ID는 세 번째 식별자로, 운영체제가 생성하며 시스템의 모든 사용자가 읽을 수 있습니다.
실제로 머신 ID를 읽는 대상
DHCP 클라이언트 식별자. 이것이 가장 큰 문제입니다. .network 파일의 [DHCPv4] 섹션에 있는 ClientIdentifier=은 networkd.conf(5)에 설정된 값을 기본값으로 사용하며, 이는 다시 duid를 기본값으로 갖습니다. 이는 IAID와 DUID(DHCP unique identifier)로 구성된 RFC 4361 클라이언트 ID입니다. networkd.conf(5)는 기본 DUID 유형을 vendor으로 명시하며, 여기서 DUID 값은 벤더 식별자(systemd)인 43793과 머신 ID의 해시된 내용을 사용하여 생성됩니다. DHCPv6도 동일한 DUID를 사용합니다. 동일한 머신 ID를 가진 두 개의 클론은 동일한 기본 DUID로 해시되며, IAID까지 일치하면 바이트 단위로 동일한 클라이언트 식별자를 전송하게 됩니다. 자동으로 생성된 IAID는 udev에서 얻은 영구적인 이름을 해시하며, 예측 가능한 이름이 없을 경우 MAC 주소를 사용합니다. 현재 인터페이스 이름이 같다고 해서 IAID가 반드시 일치하는 것은 아니므로, 머신 ID와 인터페이스 이름이 같더라도 MAC 주소가 다르면 서로 다른 클라이언트 식별자가 생성될 수 있습니다. 전체 클라이언트 식별자가 일치하면 DHCP 서버는 두 대의 서버를 하나의 클라이언트로 인식하여 두 장비 모두에 동일한 임대(lease)를 제공합니다. 이 경우 주소가 두 서버 사이를 이동하거나, 한 서버가 갱신을 시도할 때 다른 서버의 주소가 사라지는 현상이 발생합니다.
journald. 영구 저널 파일은 /var/log/journal/<machine-id>/에 저장되며, 휘발성 저널은 /run/log/journal/ 아래에 저장됩니다. 디렉터리 이름은 문자 그대로 해당 ID를 따릅니다. 머신 ID별로 저널을 그룹화하는 수집기는 클론들의 정체성을 하나로 병합해 버립니다. 반면 systemd-journal-remote는 출력 파일을 소스 엔드포인트의 호스트 이름이나 주소별로 분리합니다.
D-Bus. /var/lib/dbus/machine-id은 이 파일 형식이 시작된 곳입니다. 이 파일은 /etc/machine-id에 대한 심볼릭 링크이거나 자체 복사본을 담고 있는 별도의 실제 파일일 수 있으며, 이 복사본이 아래 절차에서 함정이 됩니다.
호스트별 에이전트. 모니터링 에이전트, 라이선스 검사 도구, 인벤토리 도구 및 백업 클라이언트는 머신 ID가 안정적이고 별도의 설정이 필요 없기 때문에 이를 기본 호스트 식별자로 사용하는 경우가 많습니다. 두 서버가 하나의 정체성을 보고하면 메트릭 시리즈가 병합되거나, 하나의 라이선스 시트가 두 대의 머신에 적용되는 문제가 발생합니다. 에이전트가 호스트 이름을 사용한다고 가정하지 말고, 에이전트가 어떤 방식으로 호스트 ID를 도출하는지 확인해야 합니다.
중복 여부를 확인하는 방법
두 서버 모두에서 다음 명령을 실행한 뒤 출력 결과를 비교하십시오.
cat /etc/machine-id
ls -l /var/lib/dbus/machine-id
sudo cat /sys/class/dmi/id/product_uuidcat /etc/machine-id
두 운영 서버의 machine-id가 동일하다면 한 서버를 다른 서버에서 복제한 것입니다. 하나의 명령어를 선호한다면 hostnamectl를 사용하여 Machine ID: 라인에서 동일한 값을 출력하는지 확인할 수 있습니다.
ls -l의 결과에 따라 다음 단계를 결정합니다. 심볼릭 링크는 다음과 같이 표시됩니다.
lrwxrwxrwx 1 root root 15 Aug 21 09:12 /var/lib/dbus/machine-id -> /etc/machine-idlrwxrwxrwx 1 root root 32 ... /etc/machine-id -> /var/lib/dbus/machine-id
-rw-r--r--로 시작하는 라인은 해당 파일이 이전 ID의 고유한 복사본을 담고 있는 실제 파일임을 의미합니다. 이 파일을 삭제해야 합니다. systemd-machine-id-setup은 하이퍼바이저 UUID나 난수 생성기를 참조하기 전에 이 파일을 먼저 읽기 때문입니다.
제품 UUID 또한 중요합니다. systemd-machine-id-setup(1)은 난수 생성으로 넘어가기 전에 KVM UUID를 먼저 사용합니다. 따라서 서비스 제공업체가 두 복제본에 동일한 SMBIOS(system management BIOS) UUID를 부여했다면, 해당 소스에서 ID를 재생성해도 동일한 machine-id가 생성됩니다. 제품 UUID가 서로 다르면 이러한 특정 충돌은 피할 수 있지만, 이전 ID 소스들이 여전히 우선순위를 갖습니다.
복제된 VPS에서 machine ID 재생성하기
순서가 중요합니다. systemd-machine-id-setup(1)은 먼저 /run/machine-id를 확인하고, 그다음 유효한 D-Bus machine ID, 그 후 system.machine_id 자격 증명을 확인한 뒤, 설정된 VM이나 컨테이너 UUID를 시도하고 마지막으로 무작위 생성을 수행합니다. 실제 /var/lib/dbus/machine-id이 남아 있으면 /run/machine-id가 우선순위를 갖지 않는 한, 제거하려던 것과 정확히 같은 값이 재생성됩니다. 도구가 /run/machine-id이나 자격 증명을 재사용하여 ID가 변경되지 않는다면, 이미지를 종료한 상태에서 machine ID를 비우고 고유한 식별 소스를 사용하여 부팅하십시오.
sudo truncate -s 0 /etc/machine-id
sudo rm -f /var/lib/dbus/machine-id # only if ls -l showed a real file
sudo systemd-machine-id-setup
sudo ln -sf /etc/machine-id /var/lib/dbus/machine-id
cat /etc/machine-id먼저 파일을 비우는 작업이 필수적입니다. 이 도구는 파일이 없거나 비어 있을 때만 작동하며, 이미 유효한 ID가 들어 있는 파일에는 아무런 작업을 수행하지 않기 때문입니다. systemd-machine-id-setup는 수행한 작업을 표준 오류(standard error)로 보고합니다. systemd 258 이상을 실행하는 KVM VPS에서 하이퍼바이저 UUID를 선택하면 다음과 같이 표시됩니다.
Initializing machine ID from SMBIOS/DMI UUID.systemd 255는 동일한 단계를 Initializing machine ID from VM UUID.로 표현합니다. 이전 ID 소스를 사용할 수 없을 때는 Initializing machine ID from random generator. 메시지가 나타납니다. cat /etc/machine-id이 다른 서버와 다른 값을 출력하기만 한다면 두 결과 모두 정상입니다.
심볼릭 링크는 D-Bus와 systemd가 하나의 값을 유지하도록 합니다. 별도의 실제 파일을 선호한다면 심볼릭 링크 명령 대신 sudo dbus-uuidgen --ensure을 실행하십시오. D-Bus 파일이 없으면 /etc/machine-id에서 유효한 ID를 복사합니다. /var/lib/dbus이 없으면 ln은 No such file or directory와 함께 실패하며, 이 경우 두 줄 모두 건너뛰어도 됩니다.
그 후 재부팅하십시오.
sudo reboot재부팅이 필수인 이유
이미 이전 값을 읽어 들인 모든 프로세스는 여전히 해당 값을 사용합니다. sd_id128_get_machine()은 스레드별로 ID를 캐싱합니다. 이미 ID를 읽은 스레드는 계속해서 이전 값을 반환하며, 아직 ID를 요청하지 않은 스레드만이 변경된 파일을 읽습니다. 따라서 실행 중인 데몬은 기존 스레드에서 이전 ID를 유지하다가, 나중에 시작하는 스레드에서만 새 ID를 가져올 수 있습니다. journald는 이미 /var/log/journal/<old-id>/system.journal를 열어둔 상태로 계속해서 로그를 추가합니다. systemd-networkd는 시작 시점에 DUID를 결정하며, 이후 갱신할 때마다 이전 클라이언트 식별자를 계속 전송합니다. 이는 보통 해결하고자 했던 바로 그 오류의 원인이 됩니다. D-Bus 역시 시작 시점에 ID를 읽습니다. 서비스를 하나씩 재시작할 수도 있지만, 하나를 놓치게 될 것이며 PID 1 또한 이전 값을 유지하고 있습니다.
재부팅 후에는 다음 두 가지를 확인하십시오.
cat /etc/machine-id
ls /var/log/journal/지속적 로깅이 활성화된 경우, /var/log/journal/에는 이제 새 ID로 명명된 두 번째 디렉터리가 생성되며 최신 항목은 그곳에 저장됩니다. 일반적인 journalctl는 현재 머신의 디렉터리만 읽으므로, 기본 보기에서는 복제 이전의 기록이 사라집니다. 기록은 여전히 디스크에 남아 있습니다. journalctl --merge는 이전 디렉터리를 포함한 모든 저널 디렉터리를 읽습니다. 해당 로그가 더 이상 필요 없다고 확신할 때 이전 디렉터리를 삭제하십시오.
이것이 바로 컨테이너가 이 절차를 연습하기에 부적절한 이유입니다. 컨테이너는 호스트 커널을 공유합니다. 컨테이너 내부에서 systemd를 자체 PID 1로 실행할 수는 있지만, 컨테이너가 직접 커널을 부팅하지는 않습니다. 컨테이너 내부에서 systemd-machine-id-setup는 이전 ID 소스가 실패한 후에만 구성된 컨테이너 UUID를 사용하며, 사용 가능한 소스가 없으면 임의의 ID를 생성합니다. 운영 환경과 동일한 방식으로 테스트하십시오. VM을 복제하고, 명령을 실행하고, 재부팅한 다음, 원본 머신과 ID를 비교하십시오.
복제 후가 아니라 스냅샷을 생성하기 전에 비우십시오
클론을 하나씩 수정하는 방식은 효과가 있습니다. 하지만 이미지 자체를 수정하는 것이 더 좋습니다. 잘못된 스냅샷에서 복원된 모든 서버는 동일한 값을 그대로 물려받기 때문입니다. 템플릿을 종료하기 직전에 이 작업을 수행하십시오.
sudo truncate -s 0 /etc/machine-id
sudo rm -f /var/lib/dbus/machine-id
sudo ln -s /etc/machine-id /var/lib/dbus/machine-id
sudo shutdown -h now파일의 내용을 비우십시오. 파일을 삭제해서는 안 됩니다. machine-id(5)은 여러 머신에서 사용하는 이미지의 경우 빈 파일을 유지할 것을 권장합니다. 파일이 빈 상태로 존재하면 이미지를 읽기 전용으로 사용할 때 실제 파일 위에 임시 파일을 바인드 마운트(bind-mount)할 수 있기 때문입니다. 읽기 전용 /etc 환경에서 부팅 시 생성된 ID는 해당 임시 파일에 저장되며, 파일 시스템이 쓰기 가능 상태가 되면 systemd-machine-id-setup --commit가 이를 기록합니다.
파일을 어떤 상태로 남겨두느냐에 따라 부수적인 효과가 발생합니다. machine-id(5)은 /etc/machine-id가 존재하고 비어 있는 경우, 해당 부팅을 첫 번째 부팅으로 간주하지 않는다고 명시합니다. 따라서 위에서 언급한 빈 파일은 ConditionFirstBoot=yes를 포함하는 유닛을 트리거하지 않습니다. 파일이 없거나 uninitialized이라는 문자열이 포함된 경우에는 다음 부팅이 첫 번째 부팅으로 처리됩니다. 이 경우 해당 유닛들이 실행되며 systemd는 유닛을 프리셋(preset)합니다. 템플릿을 빌드하기 전에 grep -rl ConditionFirstBoot /usr/lib/systemd/system/을 사용하여 이미지에서 어떤 작업이 실행될지 확인하십시오.
템플릿과 스냅샷은 서로 다른 객체이며, 이 차이에 따라 식별 정보가 복사되는지 여부가 결정됩니다. 템플릿은 의도적으로 준비하는 빌드 아티팩트인 반면, 스냅샷은 실행 중인 서버의 특정 시점 복사본이며 데이터와 함께 해당 서버의 식별 정보를 그대로 포함합니다.
클라우드 이미지는 올바르게 작동하는데 직접 만든 스냅샷은 그렇지 않은 이유
배포판의 클라우드 이미지는 복제될 것을 전제로 빌드되므로, machine ID가 비어 있는 상태로 제공되며 첫 부팅 시점에 이를 채워 넣습니다. cloud-init에는 정확히 이 과정을 위한 단계가 문서화되어 있습니다. cloud-init clean --machine-id는 systemd 시스템에서 /etc/machine-id을 uninitialized이라는 문자열로 설정하며, cloud-init CLI 참조 문서에서는 골든 이미지를 복제할 때 이를 모범 사례로 설명하고 있습니다. 따라서 해당 이미지로 부팅할 때마다 고유한 machine ID가 생성됩니다.
직접 생성한 스냅샷은 상황이 다릅니다. 스냅샷을 생성하는 시점에 이미 파일이 채워져 있기 때문에, 복원 과정에서 명시적으로 삭제하거나 교체하지 않는 한 해당 스냅샷으로 복원된 모든 서버는 동일한 값을 가지게 됩니다. 이는 실행 중인 서버를 새 VPS로 옮기는 경우와 같은 유형의 문제로, 복사본은 원본을 그대로 유지하지만 정작 복사되어서는 안 될 식별 정보까지 함께 복제되는 것입니다.
복제본이 추가로 복제하는 항목
- SSH 호스트 키.
/etc/ssh/ssh_host_*도 함께 복사되므로, 두 서버 모두 클라이언트에게 동일한 지문(fingerprint)을 제시하게 됩니다. 해당 파일들을 삭제한 뒤sudo ssh-keygen -A을 실행하거나, Debian 및 Ubuntu 환경이라면sudo dpkg-reconfigure openssh-server를 실행하십시오. 이후 클라이언트가 호스트 키 변경에 대해 경고를 표시하게 되는데, 이는 정상적인 동작입니다. - 호스트 이름.
sudo hostnamectl set-hostname app02를 사용하여 호스트 이름을 설정한 뒤,/etc/hosts이 새로운 이름을 올바르게 해석하는지 확인하십시오. - 정적 네트워크 설정. 고정 IP 주소를 가진 서버를 복제하면, 복제본이 네트워크에 연결되는 즉시 원본과 충돌이 발생합니다. 복제본을 네트워크에 연결하기 전에
/etc/netplan/을 읽어 보십시오. - 시스템 시계. 실행 중인 메모리 상태를 포함한 스냅샷을 복원하면, 게스트 OS나 하이퍼바이저가 보정하기 전까지 게스트의 시계가 뒤처질 수 있습니다. 복원된 VPS의 큰 시간 오차는 TLS 인증서 검증을 실패하게 만들고, 시간 동기화가 완료될 때까지 로그 순서를 뒤섞어 놓습니다.
복제본에 대해서도 새로운 VPS를 위한 초기 10분 점검 목록을 수행하십시오. 복제된 서버는 원본 서버의 사용자 계정, SSH 키, 방화벽 규칙, 예약된 작업 등을 그대로 물려받습니다. 복제본이 수행할 새로운 역할에 맞춰 이러한 설정들이 검토된 적은 없기 때문입니다.
FAQ
/etc/machine-id를 변경한 후 재부팅해야 합니까?
네. 머신 ID를 이미 읽은 소프트웨어는 캐시된 복사본을 계속 사용하므로, 실행 중인 시스템의 중요한 부분에 새 값이 반영되지 않습니다. journald는 이전 ID로 명명된 저널 디렉터리에 계속 기록하며, DHCP 클라이언트는 이전 값에서 파생된 클라이언트 식별자를 계속 전송합니다. 보통 이것이 변경을 수행한 이유입니다. 개별 서비스를 재시작하면 일부는 해결되지만, PID 1도 이전 값을 유지합니다. 재부팅한 후 cat /etc/machine-id을 사용하여 확인하고 다른 서버와 비교하십시오.
/etc/machine-id는 하드웨어 UUID와 동일합니까?
아니요. /sys/class/dmi/id/product_uuid의 DMI 제품 UUID는 하이퍼바이저에서 제공하며 root만 읽을 수 있습니다. 머신 ID는 운영 체제에 의해 생성되며 누구나 읽을 수 있는 일반 파일에 저장됩니다. 두 값은 한 방향으로 연결됩니다. KVM 게스트에서 이전 ID 소스가 적용되지 않으면 systemd-machine-id-setup는 하이퍼바이저 UUID로부터 새 머신 ID를 시드(seed)합니다. 두 복제본이 제품 UUID를 공유하고 재생성 과정에서 이를 사용한다면 동일한 머신 ID가 생성될 것이므로, 결과를 신뢰하기 전에 해당 파일도 비교하십시오.
/etc/machine-id를 삭제해야 합니까, 아니면 비워두어야 합니까?
이미지를 준비할 때는 비워두십시오. machine-id(5)은 빈 파일을 선호합니다. 이미지가 읽기 전용 /etc로 실행될 때 systemd가 그 위에 임시 파일을 바인드 마운트할 수 있기 때문입니다. 쓰기 가능한 시스템에서는 파일을 삭제해도 작동하며 일부 복제 스크립트는 그렇게 처리하지만, 빈 파일이 더 안전한 기본값입니다. cloud-init은 파일에 uninitialized라는 단어를 기록합니다. 이 값은 파일이 없는 경우와 마찬가지로 다음 부팅을 첫 번째 부팅으로 인식하게 하여 ConditionFirstBoot=yes이 포함된 유닛이 실행되도록 합니다. 빈 파일은 그렇게 하지 않습니다.
복제된 두 서버의 DHCP 주소가 왜 동일합니까?
두 서버가 동일한 클라이언트 식별자를 전송했기 때문입니다. systemd-networkd는 DHCPv4에 대해 기본적으로 ClientIdentifier=duid를 사용하며, 기본 DUID는 /etc/machine-id의 해시값으로 생성되므로 동일한 머신 ID는 동일한 기본 DUID를 생성합니다. 전체 클라이언트 식별자는 IAID까지 일치할 때만 동일해집니다. systemd는 udev에서 얻은 영구적인 이름으로부터 IAID를 생성하며, 예측 가능한 이름을 사용할 수 없을 때는 MAC 주소를 사용합니다. 현재 인터페이스 이름이 일치한다고 해서 이것이 보장되지는 않습니다. 전체 식별자가 일치하면 DHCP 서버는 해당 식별자를 기준으로 두 요청을 하나의 클라이언트로 처리하여 하나의 임대(lease)만 할당합니다. 각 서버에 고유한 머신 ID를 부여하고 둘 다 재부팅하십시오. 서버가 여전히 이전 주소를 제공한다면 DHCP 서버 자체에서 만료된 임대 정보를 삭제하십시오.