Google Distributed Cloud를 사용하려면 노드 머신의 기본 운영체제를 구성해야 합니다. 이 페이지에는 필요한 구성을 완료하기 위해 필요한 단계가 포함되어 있습니다.
Google Distributed Cloud 요구사항 문제 해결에 대한 자세한 내용은 알려진 문제를 참조하세요.
시작하기 전에
지원되는 운영체제 버전과 Ubuntu 하드웨어 사용 설정(HWE) 커널을 사용 중인지 확인합니다. 지원되는 버전의 목록은 운영체제 선택을 참조하세요.
BPF Just In Time 컴파일러 사용 설정
운영체제의 커널에는 BPF Just In Time 컴파일러 옵션이 사용 설정되어 있어야 합니다(CONFIG_BPF_JIT=y).
이 옵션이 사용 설정되었는지 확인하려면 다음 명령어를 실행합니다.
grepCONFIG_BPF_JIT/boot/config-$(uname-r)
패키지 관리자 유효성 검사
다음 명령어를 사용하여 패키지 관리자가 올바르게 작동하는지 확인합니다.
sudoapt-getcheck
출력에 오류가 표시되지 않으며 다음 예시와 유사하게 표시됩니다.
# Reading package lists... Done
# Building dependency tree
# Reading state information... Done
Uncomplicated Firewall(UFW) 사용 중지
ufw을 사용 중지합니다.
sudo ufw disable
ufw가 사용 중지되었는지 확인합니다.
sudo ufw status
# Status: inactive
워크스테이션에 Docker 구성
Google Distributed Cloud는 다음 시나리오에서 Docker를 베어메탈 머신에 설치하는 데 도움이 됩니다.
베어메탈 머신에 Docker가 설치되어 있지 않은 경우 bmctl이 20.10.0 이상을 설치합니다.
베어메탈 머신에 Docker 19.03.5 이하를 설치한 경우 bmctl이 Docker를 버전 20.10.0 이상으로 업그레이드합니다.
출력과 다음 예시를 비교하여 클라이언트 및 서버 버전이 20.10.0 이상인지 확인합니다.
Client: Docker Engine - Community
Version: 25.0.3
...
Server: Docker Engine - Community
Engine:
Version: 25.0.3
시간 동기화 설정
시간 동기화는 지정된 외부 시간 참조를 사용하여 노드 머신에 시계를 설정하는 것으로 구성됩니다. 시간 동기화는 시간에 민감한 클러스터 활동(예: 이벤트 로깅 및 측정항목 수집)에 중요합니다.
노드 머신의 커널은 노드에서 실행되는 컨테이너의 시계를 제어합니다. 적절한 시간 동기화를 위해 chrony, systemd-timesyncd, ntp, 또는 ntpdate와 같은 사용 가능한 서비스를 통해 머신에 네트워크 시간 프로토콜(NTP) 서비스를 설치합니다. timedatectl을 실행하여 시스템 시계가 동기화되었는지 확인합니다. timedatectl의 출력에는 다음 상태가 포함되어야 합니다.
System clock synchronized: yes
Linux 커널 inotify 한도가 최소 이상인지 확인
Ubuntu 22.04를 실행하는 머신의 경우 최대 사용자 인스턴스 및 사용자 감시 수에 대한 Linux 커널 inotify 한도는 다음보다 크거나 같아야 합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-31(UTC)"],[],[],null,["You must configure the base operating system of your node machines to use\nGoogle Distributed Cloud. This page contains the steps you need to take to complete the\nneeded configuration.\nFor more information about troubleshooting Google Distributed Cloud requirements,\nsee the [known issues](/kubernetes-engine/distributed-cloud/bare-metal/docs/troubleshooting/known-issues).\n\nBefore you begin\n\nEnsure that you are using a supported version of your operating system and a\nUbuntu Hardware Enablement (HWE) kernel. For a list of supported versions, see\n[Select your operating system](/kubernetes-engine/distributed-cloud/bare-metal/docs/installing/os-reqs).\n\nEnable BPF Just In Time compiler\n\nThe kernel for your operating system must have the BPF Just In Time compiler\noption enabled (`CONFIG_BPF_JIT=y`).\n\n- To find out whether this option is enabled, run the following command:\n\n grep CONFIG_BPF_JIT /boot/config-$(uname -r)\n\nValidate the package manager\n\n- Use the following command to validate that the package manager is operating\n correctly:\n\n sudo apt-get check\n\n The output should show no errors and look similar to the following example: \n\n # Reading package lists... Done\n # Building dependency tree\n # Reading state information... Done\n\nDisable Uncomplicated Firewall (UFW)\n\n1. Disable `ufw`:\n\n sudo ufw disable\n\n2. Check that `ufw` is disabled:\n\n sudo ufw status\n # Status: inactive\n\nConfigure Docker on your workstation\n\nGoogle Distributed Cloud helps you install Docker on your bare metal machines in the\nfollowing scenarios:\n\n- If your bare metal machines don't have Docker installed, `bmctl` installs 20.10.0 or later.\n- If your bare metal machines have Docker 19.03.5 or earlier installed, `bmctl` upgrades Docker to version 20.10.0 or later.\n\n| **Note:** The workstation running `bmctl` needs non-root user access to Docker to start the temporary bootstrap (kind) cluster during installation. To enable non-root user access to Docker, go to [Manage Docker as a non-root user](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user).\n\nFollow these steps to manually install Docker:\n\n1. Remove any previous Docker version:\n\n sudo apt-get remove docker docker-engine docker.io containerd runc\n\n2. Update your package manager:\n\n sudo apt-get update\n\n3. Install Docker 20.10.0+:\n\n sudo apt-get install \\\n apt-transport-https \\\n ca-certificates \\\n curl \\\n gnupg-agent \\\n software-properties-common \\\n docker.io\n\n4. Verify you are now running version 20.10.0+:\n\n sudo docker version\n\n5. Compare your output with the following example to ensure the Client and Server versions are 20.10.0+ :\n\n Client: Docker Engine - Community\n Version: 25.0.3\n ...\n Server: Docker Engine - Community\n Engine:\n Version: 25.0.3\n\nSet up time synchronization\n\nTime synchronization consists of setting the clocks on your node machines, using\na designated external time reference. Time synchronization is important for\ntime-sentive cluster activities, such as event logging and metrics collection.\nThe kernel of your node machine controls the clock in containers that run on the\nnode. To ensure proper time synchronization, install a network time protocol\n(NTP) service on your machines, using any of the available services:\n[`chrony`](https://chrony.tuxfamily.org/), `systemd-timesyncd`,\n`ntp`, or `ntpdate`. Run `timedatectl` to verify the system clock is\nsynchronized. The output of `timedatectl` should contain the following status: \n\n System clock synchronized: yes\n\nEnsure Linux kernel `inotify` limits are at or higher than minimum\n\nFor machines running Ubuntu 22.04, Linux kernel `inotify` limits\nfor maximum user instances and user watches must be greater than or equal to the\nfollowing:\n\n- `fs.inotify.max_user_instances`: `8192`\n- `fs.inotify.max_user_watches`: `524288`\n\nTo ensure these values are set correctly on your node machines:\n\n1. Check the value of `max_user_instances`:\n\n cat /proc/sys/fs/inotify/max_user_instances\n\n2. If needed, update `max_user_instances` to the minimum value:\n\n echo 'fs.inotify.max_user_instances=8192' | sudo tee --append /etc/sysctl.conf\n\n3. Check the value of `max_user_watches`:\n\n cat /proc/sys/fs/inotify/max_user_watches\n\n4. If needed, update `max_user_watches` to the minimum value:\n\n echo 'fs.inotify.max_user_watches=524288' | sudo tee --append /etc/sysctl.conf\n\n5. If you updated either value, reboot the machine."]]