Plane-ді Қазақстандағы өз серверіңізге орнату: продакшенге арналған Docker-нұсқаулық

Plane Docker арқылы өз серверіңізге бір кеште орнатылады: Community Edition үшін setup.sh скрипті немесе Commercial үшін prime-cli орнатушысы. Продакшен-орнатылым тағы бірнеше қадамды талап етеді, оларсыз жүйе алғашқы апатқа дейін жетпейді: plane.env ішіндегі әдепкі құпиясөздерді ауыстыру, домен мен SMTP-ны баптау, база мен файлдардың бэкаптарын автоматтандыру және жаңартуды пысықтау.

Нұсқаулық Plane-ді жергілікті хостердегі виртуалды машинада немесе өз контурында орнатып жатқан Қазақстандағы DevOps-инженерлерге, жүйелік әкімшілерге және тимлидтерге арналған. Барлық командалар 2026 жылғы қазандағы Plane ресми құжаттамасынан алынған. Орнатар алдында құжаттаманың өзекті нұсқасымен салыстырыңыз: скрипттер мен мәзір тармақтары релизден релизге өзгереді.

Community немесе Commercial: нені орнату керек

Plane-нің үш self-hosted редакциясы бар. Community Edition AGPL-3.0 лицензиясымен ашық, тегін және функциялары бойынша бұлттағы Free тарифіне сәйкес келеді. Commercial — бұлтпен толық функционалдық паритеті бар жабық редакция: ол әр жұмыс кеңістігіне 12 орын берілетін тегін жоспардан басталады, ал ақылы функциялар лицензиялық кілтпен қосылады. Airgapped — интернетке қолжетімділігі жоқ желілерге арналған Commercial нұсқасы.

Маңызды деталь: ақылы жоспарға өту үшін алдымен Commercial Edition-ға ауысу керек. Егер жарты жылдан кейін SSO немесе кеңейтілген құқықтар қажет болатынына сенімді болсаңыз, бірден Commercial орнатқан жөн. Редакцияларды толық салыстыру және құнын есептеу — Plane-нің қай нұсқасын таңдау керек деген мақалада.

Plane Kubernetes-ке де орнатылады. Егер компанияда кластер және оны сүйемелдейтін команда бұрыннан болса, бұл ақталады. Бұл нұсқаулықта бір виртуалды машинадағы Docker Compose-ты талдаймыз: мұндай орнатылым шағын және орта командалардың көпшілігіне жеткілікті, ал оны бір инженер сүйемелдей алады.

Серверге қойылатын талаптар және дайындық

Параметр	Құжаттама бойынша ең азы	Продакшенге не ұсынамыз
Процессор	2 ядро, x64 немесе ARM64	25 адамнан бастап командаға 4 ядро
Жад	4 ГБ	Plane ұсынғандай 8 ГБ
ОЖ	Ubuntu, Debian, CentOS, Amazon Linux, macOS, WSL2 бар Windows	Ubuntu немесе Debian-ның LTS-нұсқасы
Docker	Docker Compose-тың жаңа нұсқасы	Ресми скрипттен Docker Engine
Желі	80 және 443 порттары	Домен, TLS, жабық артық порттар
Диск	—	Тіркемелер мен жергілікті бэкаптарға қор, деректерге бөлек том

Орнатуға дейін дайындаңыз:

1. Қазақстандағы хостердегі немесе өз деректер орталығыңыздағы виртуалды машина.
2. Серверге A-жазбасы бар домен немесе субдомен, мысалы tasks.company.kz.
3. root ретінде немесе sudo құқығы бар пайдаланушы ретінде SSH арқылы қолжетімділік.
4. Хабарландыруларға арналған SMTP: корпоративтік пошта немесе пошта сервисі.
5. Осы серверден тыс бэкап көшірмелеріне арналған орын.

Қазақстан контексі. Қазақстандық хостердегі серверде деректер елде сақталады, ал төлем келісімшарт бойынша теңгемен жүреді. Орнату мен жаңарту скрипттерді GitHub-тан және образдарды Docker-тізілімдерінен жүктейтінін ескеріңіз. Егер АҚ серверге интернетке шығуды жапса, әдеттегі орнату сәйкес келмейді: өз тізіліміңізден жаңартылатын Airgapped редакциясы қажет.

Орнату

setup.sh арқылы Community Edition

Егер Docker әлі жоқ болса, оны орнатыңыз:

curl -fsSL https://get.docker.com | sh -

Орнатуға арналған бума құрып, скриптті жүктеп алыңыз:

mkdir plane-selfhost
cd plane-selfhost
curl -fsSL -o setup.sh https://github.com/makeplane/plane/releases/latest/download/setup.sh
chmod +x setup.sh
./setup.sh

Скрипт мәзірді көрсетеді: Install, Start, Stop, Restart, Upgrade, View Logs, Backup Data, Exit. 1 (Install) тармағын таңдаңыз. Скрипт plane-app бумасын құрып, оған docker-compose.yaml және plane.env файлдарын жүктейді. Содан кейін мәзірден шығып, plane.env файлын өңдеңіз (келесі бөлім), ./setup.sh скриптін қайта іске қосып, 2 (Start) тармағын таңдаңыз.

prime-cli арқылы Commercial Edition

Серверге root немесе sudo-пайдаланушы ретінде қосылып, орнатушыны іске қосыңыз:

curl -fsSL https://prime.plane.so/install/ | sh -

Орнатушы доменді domain.tld немесе subdomain.domain.tld форматында сұрап, режимді ұсынады. Express әдепкі конфигурацияны орнатады. Advanced сыртқы дерекқорды, Redis пен файлдар қоймасын көрсетуге мүмкіндік береді, ал продакшен үшін құжаттама дәл соны табанды түрде ұсынады. Сәтті орнату туралы хабарламадан кейін, егер ақылы жоспар сатып алсаңыз, лицензиялық кілтті белсендіріңіз.

plane.env баптау

Community Edition-да алғашқы іске қосуға дейін plane.env файлын қарап шығу керек. Файлды әр өзгертер алдында сервистерді тоқтатыңыз.

Айнымалы	Әдепкі мән	Не қою керек
WEB_URL	http://localhost	Толық мекенжай, мысалы https://tasks.company.kz
CORS_ALLOWED_ORIGINS	http://localhost	WEB_URL ішіндегідей мекенжай
APP_DOMAIN	localhost	Хаттамасыз доменіңіз
LISTEN_HTTP_PORT, LISTEN_HTTPS_PORT	80, 443	Қалдыру немесе порттар бос болмаса, ауыстыру
POSTGRES_PASSWORD	plane	Ұзын кездейсоқ құпиясөз
RabbitMQ құпиясөзі (RABBITMQ_*)	plane	Ұзын кездейсоқ құпиясөз; айнымалы атауын өз plane.env файлыңызбен салыстырыңыз
AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY	access-key, secret-key	MinIO үшін өз кілттеріңіз
SECRET_KEY	берілмеген	Кездейсоқ жол, бэкаптармен бірге сақтау
FILE_SIZE_LIMIT	5242880 (5 МБ)	Тапсырмаларға үлкен файлдар тіркелсе, ұлғайту
DATABASE_URL, REDIS_URL	бос	База мен Redis сыртқы болса, толтыру

Екі ереже. Әдепкі құпиясөздерді қалдырмаңыз: олар құжаттамада жарияланған. Ал plane.env файлын құпиялар менеджерінде сақтаңыз: онсыз база бэкапын қалпына келтіру қиындайды.

Алғашқы кіру және инстансты баптау

WEB_URL ішіндегі мекенжайды ашыңыз. «Let’s secure your instance» экранында пошта мен құпиясөзді енгізіңіз: Plane құжаттамасы бойынша инстансты бірінші көтерген адам оның әкімшісі болады. Осыдан кейін /god-mode панелі ашылады.

Әкімші панелінде ретімен мынаны жасаңыз:

• Инстанс атауын беріп, телеметрияны қалдыру-қалдырмауды шешіңіз.
• SMTP-ны баптаңыз. Құжаттама мұны орта файлы арқылы емес, интерфейсте жасауға кеңес береді.
• Аутентификация бөлімінде шақырусыз тіркелуді өшіріп, қажетті кіру тәсілдерін, соның ішінде редакцияңызда қолжетімді болса, SSO-ны қосыңыз.
• Әкімшіден басқа барлығына жұмыс кеңістіктерін құруға тыйым салыңыз.

Содан кейін жұмыс кеңістігін, бірінші жобаны құрып, пилоттық команданы шақырыңыз. Егер Jira-дан көшіп жатсаңыз, Plane импорттаушысы тапсырмаларды, түсініктемелерді, тіркемелерді, спринттерді және пайдаланушыларды көшіреді. Көшу жоспары Jira-дан Plane-ге көшу туралы мақалада талданған.

PostgreSQL мен файлдардың бэкаптары

Plane бірнеше контейнерден тұрады. Олардың бәрін бэкаптау қажет емес, бірақ үш деректер қоймасының кез келгенін жоғалту ауыр тиеді.

Компонент	Неге жауап береді	Нені бэкаптау керек
plane-db (PostgreSQL)	Тапсырмалар, жобалар, пайдаланушылар, түсініктемелер, беттер	Міндетті түрде, күн сайын
plane-minio (файлдар қоймасы)	Тіркемелер, суреттер, сипаттамалардағы файлдар	Міндетті түрде, базамен бірге
plane-redis	Кэш және қызметтік деректер	Штаттық бэкапқа кіреді, маңыздылығы төменірек
plane-mq (RabbitMQ)	Фондық тапсырмалар кезегі	Қажет емес
api, worker, beat-worker	Бэкенд және кесте бойынша фондық тапсырмалар	Қажет емес, образдардан қалпына келтіріледі
web, space, admin, live	Интерфейс, жария беттер, админка, нақты уақыттағы жұмыс	Қажет емес
proxy	Кіріс сұраныстар және TLS	Қажет емес, бірақ өз TLS схемаңыз болса, сертификаттарды бөлек сақтаңыз
plane.env	Конфигурация және құпиялар	Міндетті түрде, қолмен

Community Edition-да ./setup.sh іске қосып, 7 (Backup Data) тармағын таңдаңыз. Скрипт pgdata.tar.gz, redisdata.tar.gz және uploads.tar.gz файлдарын plane-app/backup/<уақыт белгісі> бумасына сақтайды. Қалпына келтіру үшін құжаттама бөлек скрипт ұсынады:

curl -fsSL -o restore.sh https://raw.githubusercontent.com/makeplane/plane/refs/heads/preview/deployments/cli/community/restore.sh
chmod +x restore.sh
./restore.sh <*.tar.gz мұрағаттары бар бума>
./setup.sh start

Қалпына келтірер алдында Plane орнатылған, іске қосылған, содан кейін тоқтатылған болуы керек.

Commercial-да бэкапты sudo prime-cli backup жасайды, мұрағаттар әдепкі бойынша /opt/plane/backups ішінде жатады. Қалпына келтіру: sudo prime-cli restore, ол ағымдағы деректерді қайта жазады, сондықтан алдымен қажетті мұрағат таңдалғанына көз жеткізіңіз. plane.env файлын (Commercial-да ол /opt/plane ішінде) екі редакцияда да қолмен көшіріңіз.

Сол сервердегі бэкап сервердің өзін жоғалтудан қорғамайтынын есте сақтаңыз. Егер хостерде диск істен шықса немесе виртуалды машина қателесіп жойылса, мұрағаттары бар жергілікті бума деректермен бірге жоғалады.

Штаттық скрипттерде не жоқ және нені өзіңіз қосуыңыз керек: cron арқылы кесте бойынша іске қосу, мұрағаттарды басқа алаңға көшіру және кемінде тоқсанына бір рет бөлек машинада қалпына келтіруді тексеру.

Жаңарту және мониторинг

Community Edition-ды жаңарту тәртібі:

1. Бэкап жасаңыз.
2. Жаңа setup.sh скриптін орнатудағыдай командамен жүктеп алыңыз.
3. ./setup.sh іске қосып, 5 (Upgrade) тармағын таңдаңыз.
4. variables-upgrade.env файлын өз plane.env файлыңызбен салыстырып, жаңа айнымалыларды көшіріңіз. Скрипт plane.env файлының өзін қайта жазбайды.
5. Сервистерді 2 (Start) тармағымен іске қосып, кіруді, тапсырма құруды және файл жүктеуді тексеріңіз.

Нұсқаулық 0.14.0 және одан жоғары нұсқаларға қатысты. Ескірек нұсқалардан алдымен 0.14.0 нұсқасына бөлек өту қажет. Commercial-да жаңарту екі командамен жасалады: sudo prime-cli update-cli және sudo prime-cli upgrade.

Мониторинг үшін қарапайым жинақ жеткілікті: WEB_URL ішіндегі мекенжайдың қолжетімділігін сырттан тексеру, диск пен жадтың толуына алерт, жаңа бэкаптың пайда болғанын күн сайын тексеру. Сервистер логтарын setup.sh мәзіріндегі 6 (View Logs) тармағымен қараңыз.

Типтік мәселелер

• Кіру жұмыс істемейді немесе сұраныстар CORS қателерімен құлайды. WEB_URL, CORS_ALLOWED_ORIGINS және APP_DOMAIN дұрыс хаттамамен бір мекенжайды көрсетіп тұрғанын тексеріңіз.
• Сервистер іске қосылмайды. Көбіне 80 немесе 443 порттарын басқа веб-сервер алып қойған. Оларды босатыңыз немесе LISTEN_HTTP_PORT пен LISTEN_HTTPS_PORT мәндерін ауыстырыңыз.
• Хаттар келмейді. SMTP /god-mode ішінде бапталмаған немесе хостер шығыс пошта порттарын бұғаттайды.
• Тіркемелер жүктелмейді. Файл FILE_SIZE_LIMIT мәнінен үлкен немесе MinIO кілттері қате берілген.
• Жаңартудан кейін бір нәрсе бұзылды. variables-upgrade.env файлындағы жаңа айнымалылар көшірілмеген. Файлдарды салыстырып, қайта іске қосыңыз.
• Жүйе баяулайды. Жад ұсынылған 8 ГБ-тан аз, ал команда өсті. Ресурстар қосыңыз немесе базаны бөлек серверге шығарыңыз.

Біз мұны қалай жасаймыз

Біз орнатудан бастамаймыз. Алдымен диагностика: Plane-ге қанша адам келеді, қай редакция керек, сервер қайда болады және оның иесі кім болады. Содан кейін Plane-ді Қазақстандағы серверге орнатамыз, құпияларды ауыстырамыз, TLS, SMTP, SSO, басқа алаңға көшірмесімен кесте бойынша бэкаптарды және мониторингті баптаймыз. Бір командамен пилот іске қосамыз, содан кейін ғана қалғандарын көшіреміз.

Толығырақ — Jira және Plane таск-трекерлерін енгізу бетінде. Өз DevOps-инженеріңіз болмаса, сонда серверді сүйемелдеуге де тапсырыс беруге болады.

---

Дереккөздер. Plane ресми құжаттамасы (Docker Compose арқылы орнату, орта айнымалылары, бэкап және қалпына келтіру, жаңарту, әкімші панелі, редакциялар) және жобаның GitHub-тағы репозиторийі. Деректер 2026 жылғы қазандағы жағдай бойынша.

Терминдер қарапайым тілмен

Docker және Docker Compose

Бағдарламаны дайын оқшауланған «контейнерлерде» іске қосу тәсілі. Compose Plane-нің барлық бөліктерін бір серверде бір командамен көтереді, сондықтан орнатылымды бір инженер сүйемелдей алады.

Self-hosted

Компания вендордың бұлтында пайдаланбай, өз серверіне орнататын бағдарлама. Деректер сізде қалады, бірақ орнату, бэкаптар және жаңартулар да сіздің мойныңызда.

AGPL-3.0

Community Edition шығарылған ашық лицензия. Plane-ді өзіңізде тегін орнатып, пайдалануға рұқсат береді; егер кодты өзгертіп, желі арқылы қолжетімділік берсеңіз, өзгерістерді ашу керек.

Airgapped

Интернеттен толық ажыратылған желіге арналған Plane редакциясы. Қауіпсіздік қызметі серверге сыртқа шығуға тыйым салғанда қажет; бұл жағдайда жаңартулар компанияның өз образдар қоймасынан алынады.

SMTP

Электрондық поштаны жіберу хаттамасы. Ол арқылы Plane хабарландырулар мен шақыруларды жібереді; SMTP бапталмаса, қызметкерлерге хаттар келмейді.

SSO (Single Sign-On)

Бірыңғай кіру: қызметкер Plane-ге басқа корпоративтік жүйелердегідей есептік жазбамен кіреді. Plane-де бұл функция Commercial-дың ақылы жоспарларында бар.

plane.env

Plane баптаулары файлы: сайт мекенжайы, база мен қойманың құпиясөздері, құпия кілт. Оны іске қосуға дейін толтырып, бөлек сақтау керек, әйтпесе бэкапты қалпына келтіру қиындайды.

PostgreSQL бэкапы

Тапсырмалар, жобалар, пайдаланушылар және түсініктемелер жататын Plane-нің негізгі дерекқорының резервтік көшірмесі. Тіркемелердің көшірмесімен бірге күн сайын жасалады және сынақ қалпына келтірумен тексеріледі.