이 섹션에서는 Debian 또는 Ubuntu 환경에서 AlloyDB Omni CLI를 사용하여 AlloyDB Omni를 설치하는 방법을 보여줍니다.
시스템 요구사항
다음 시스템 요구사항을 충족하는 Linux 머신이 있는지 확인합니다.
Debian 또는 Ubuntu와 같은 Debian 기반 OS를 실행하는 가상 또는 실제 머신
x86/AMD64 아키텍처의 CPU 2개 이상
2GB 이상의 RAM 최적의 성능을 위해 CPU당 8GB의 RAM을 할당하는 것이 좋습니다.
사용 가능한 저장공간이 20GB 이상이어야 합니다.
OS 내에서 무제한 루트 액세스
Linux 커널 버전 4.18 이상 최상의 성능을 위해 커널 버전 5.3 이상을 사용하는 것이 좋습니다.
Linux cgroup v2가 사용 설정되어 있습니다.
기본적으로 cgroup v2는 대부분의 최신 Linux 시스템에서 사용 설정됩니다.
cgroup v2가 사용 설정되어 있는지 확인하려면 셸에서 stat -fc %T /sys/fs/cgroup/를 실행합니다. cgroup v2가 사용 설정된 경우 명령어 출력에 cgroup2fs가 표시됩니다.
TCP 포트 5432가 다른 서비스에서 사용되지 않습니다.
클라우드 플랫폼에 AlloyDB Omni를 설치하는 경우 다음 인스턴스 유형을 사용하는 것이 좋습니다.
Google Cloud에서는 n2-highmem 인스턴스를 사용하는 것이 좋습니다.
Amazon Web Services에서는 R6i 인스턴스를 사용하는 것이 좋습니다.
Microsoft Azure에서는 Ebsv5 인스턴스를 사용하는 것이 좋습니다.
Debian 또는 Ubuntu 머신에 AlloyDB Omni CLI 및 Docker를 설치합니다.
[[["이해하기 쉬움","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-09-04(UTC)"],[[["\u003cp\u003eAlloyDB Omni can be installed on Debian or Ubuntu environments using the AlloyDB Omni CLI, providing a quick setup for your own environment.\u003c/p\u003e\n"],["\u003cp\u003eSystem requirements for running AlloyDB Omni include a Debian-based OS, minimum 2 CPUs, 2 GB RAM (8 GB per CPU recommended), 20 GB storage, and Linux kernel 4.18 or higher.\u003c/p\u003e\n"],["\u003cp\u003eThe installation process involves installing the AlloyDB Omni CLI and Docker, followed by running a command to install and launch the AlloyDB Omni server software.\u003c/p\u003e\n"],["\u003cp\u003eConnecting to AlloyDB Omni is achieved via \u003ccode\u003epsql\u003c/code\u003e after the server software is launched, allowing users to interact with the database using a command-line prompt.\u003c/p\u003e\n"],["\u003cp\u003eFor optimal performance on cloud platforms, specific instance types are recommended, such as \u003ccode\u003en2-highmem\u003c/code\u003e on Google Cloud, \u003ccode\u003eR6i\u003c/code\u003e on Amazon Web Services, and \u003ccode\u003eEbsv5\u003c/code\u003e on Microsoft Azure.\u003c/p\u003e\n"]]],[],null,["# Install AlloyDB Omni\n\nSelect a documentation version: 15.5.2keyboard_arrow_down\n\n- [Current (16.8.0)](/alloydb/omni/current/docs/quickstart)\n- [16.8.0](/alloydb/omni/16.8.0/docs/quickstart)\n- [16.3.0](/alloydb/omni/16.3.0/docs/quickstart)\n- [15.12.0](/alloydb/omni/15.12.0/docs/quickstart)\n- [15.7.1](/alloydb/omni/15.7.1/docs/quickstart)\n- [15.7.0](/alloydb/omni/15.7.0/docs/quickstart)\n- [15.5.5](/alloydb/omni/15.5.5/docs/quickstart)\n- [15.5.4](/alloydb/omni/15.5.4/docs/quickstart)\n- [15.5.2](/alloydb/omni/15.5.2/docs/quickstart)\n\n\u003cbr /\u003e\n\n| **Note:** Your use of AlloyDB Omni is subject to the agreement between you and Google that governs Google Cloud offerings. If you do not have a Google Cloud account, or have not otherwise entered into an agreement with Google that governs Google Cloud offerings, please do not proceed or download this software until you have done so. To create a Google Cloud account, see [the Google Cloud homepage](/docs/get-started).\n\n\u003cbr /\u003e\n\nThis quickstart shows you how to install AlloyDB Omni on your own\nenvironment in a few steps.\n\n- To install a production-ready AlloyDB Omni cluster in a Linux environment, see [Install\n AlloyDB Omni on Debian or Ubuntu](#linux).\n\nInstall AlloyDB Omni on Debian or Ubuntu\n----------------------------------------\n\nThis section shows you how to install AlloyDB Omni using the\nAlloyDB Omni CLI in your Debian or Ubuntu environment. \n\n#### System requirements\n\nEnsure that you have a Linux machine that meets the following system\nrequirements:\n\n- A virtual or physical machine running a Debian-based OS, such as Debian or Ubuntu.\n- A minimum of 2 CPUs, with x86/AMD64 architecture.\n- A minimum of 2 GB of RAM. For optimal performance, we recommend allocating 8 GB of RAM for each CPU.\n- At least 20 GB of available storage.\n- Unrestricted root access within the OS.\n- Linux kernel version 4.18 or higher. We recommend kernel version 5.3 or higher for best performance.\n- Linux cgroup v2 enabled. By default, cgroup v2 is enabled on most modern Linux systems.\n To check whether cgroup v2 is enabled, run\n `stat -fc %T /sys/fs/cgroup/` in a shell. If cgroup v2 is\n enabled, the command output shows `cgroup2fs`.\n\n- TCP port `5432` not in use by any other service.\n- If you are installing AlloyDB Omni on a cloud platform, then we recommend using the following instance types:\n - On Google Cloud, we recommend `n2-highmem` instances.\n - On Amazon Web Services, we recommend `R6i` instances.\n - On Microsoft Azure, we recommend `Ebsv5` instances.\n\n1. Install the AlloyDB Omni CLI and Docker on your Debian or Ubuntu machine:\n\n curl https://us-apt.pkg.dev/doc/repo-signing-key.gpg | sudo apt-key add -\n sudo apt update\n echo \"deb https://us-apt.pkg.dev/projects/alloydb-omni alloydb-omni-apt main\" \\\n | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list\n sudo apt update\n sudo apt-get -y install alloydb-cli docker.io\n\n2. Use the command-line program to install and launch the AlloyDB Omni\n server software:\n\n sudo alloydb database-server install\n\n3. Connect to AlloyDB Omni using `psql`:\n\n sudo docker exec -it pg-service psql -h localhost -U postgres\n\n The terminal window displays `psql` login text that ends with a\n `postgres=#` prompt.\n\nWhat's next\n-----------\n\n- [Run and connect to\n AlloyDB Omni](/alloydb/omni/15.5.2/docs/run-connect)\n\n- [Customize your AlloyDB Omni installation](/alloydb/omni/15.5.2/docs/install)"]]