PodiCloudPodiCloud

Проєкт: від створення до домену

Загальний посібник. Усе, що однаково для будь-якого обробника: як створити проєкт, доставити в нього код, під’єднати домен і де дивитися, що відбувається.

Що таке проєкт

Проєкт у PodiCloud — це окремий контейнер із виділеними ресурсами тарифу (CPU, пам’ять, диск), власним каталогом файлів, доменами, базами даних і журналами. Сусідні проєкти його ресурси не займають. Усередині контейнера працює обробник: PHP, статика, Node.js, Python, Go, готовий бінарник, власний образ або проксі. Обробник обирається під час створення і не змінюється; усе інше можна міняти.

Один проєкт — один сайт або сервіс. Для другого сайту створіть другий проєкт.

1. Створення проєкту

Відкрийте panel.cs2bfp.net → Проєкти → Новий проєкт. Майстер веде по кроках: локація і тариф, обробник, підсумок.

Майстер нового проєкту: локація, категорія заліза, період оплати і картки тарифів
Крок 1: локація, категорія заліза, період оплати і тарифи.
  1. Локація. Де фізично працюватиме проєкт. Якщо в локації різне залізо, поруч з’явиться перемикач Категорія: той самий тариф на різному залізі коштує по-різному.
  2. Період оплати. 1, 3, 6 або 12 місяців; за довший період діє знижка, її одразу видно в картках.
  3. Тариф. У картці — ресурси, кількість баз, доменів і портів, обмеження мережі та перелік обробників, які тариф дозволяє. Натисніть на картку. Якщо є картка Конфігуратор, ресурси можна зібрати повзунками.
  4. Обробник. Плитка з технологією, версія (для PHP, Node.js, Python і Go) і налаштування обробника. Що саме заповнювати — у посібниках по обробниках: статика, PHP.
  5. Проєкт. Ім’я проєкту (латиниця; стане частиною логіна SFTP: обліковка.ім’я), назва для себе, домен (можна додати пізніше) і перемикач «Домен буде за Cloudflare», якщо DNS домену веде Cloudflare у режимі проксі.
  6. Підсумок. Перевірте рядок підсумку і суму: вона списується з балансу одразу, проєкт стартує приблизно за хвилину. Якщо балансу не вистачає, проєкт створиться заблокованим — поповніть баланс протягом 15 хвилин, інакше він видалиться.
Крок «Проєкт»: ім’я, назва, домен, перемикач Cloudflare, публічні порти і підсумок
Ім’я, домен і підсумок перед створенням.
Пароль SFTP показується один раз — одразу після створення. Не записали — у блоці SFTP картки проєкту є кнопка «Новий пароль».

2. Картка проєкту

Після створення відкривається картка проєкту. Угорі — стан (running), тариф і кнопки «Відкрити», «Перезапустити», «Зупинити». Вкладки: Огляд (ресурси й події), Керування (обробник, домен і TLS, SFTP, змінні, cron і процеси, порти, Git), Бази даних, Бекапи, Логи, Термінал, Файли. Кнопка «Документація» в шапці відкриває посібник для обробника проєкту.

3. Як доставити код

Файли проєкту лежать у його каталозі; усередині контейнера це /app. Є три способи покласти туди код.

Git-деплой

Найзручніший для власних проєктів: панель забирає гілку з репозиторію, виконує команду збірки (якщо вона задана) і перезапускає проєкт. Блок Git на вкладці «Керування»:

  1. Підключити репозиторій. Адреса [email protected]:org/repo.git (приватний, через ключ) або https://… (публічний), гілка і каталог у проєкті — куди покласти репозиторій цілком, наприклад src. Порожній каталог — у корінь проєкту. Підкаталог самого репозиторію обрати не можна: команди заходять у нього самі.
  2. Ключ деплою. Для приватного репозиторію натисніть «Створити ключ», скопіюйте відкриту частину і додайте в репозиторій як deploy key лише для читання (GitHub: Settings → Deploy keys). Закрита частина не покидає сервер.
  3. Деплой. Кнопка «Деплой» запускає ланцюжок: отримання гілки → збірка → перезапуск. Рядок Деплой показує крок і час, а по закінченні — результат, коміт і кнопку «Вивід» з логом. Повний лог — у файлах проєкту: logs/deploy.log і logs/build.log.
  4. Вебхук. «Створити адресу вебхука» дає посилання для репозиторію (GitHub: Settings → Webhooks, подія push). Після кожного push панель деплоїть сама. Адреса показується один раз.
Під час деплою файли в каталозі замінюються вмістом гілки. Файли, яких у репозиторії немає (завантаження, кеш, .env), залишаються на місці.

SFTP

Блок SFTP: адреса сервера з портом, логін обліковка.проєкт, кнопки «Новий пароль» і «Під’єднатися» (відкриває sftp:// у Cyberduck, WinSCP, Transmit; у FileZilla введіть адресу і логін вручну). Логін заходить у корінь проєкту; «Обліковка з базовим шляхом» дає доступ лише до підкаталогу — зручно для підрядника.

Файли і термінал

Вкладка Файли — каталог проєкту в браузері: папки, завантаження перетягуванням, права, редактор текстових файлів до 2 МБ. Вкладка Термінал — оболонка всередині контейнера під користувачем проєкту: тут працюють composer, unzip, curl, git і команди вашого застосунку.

4. Домен і HTTPS

Блок Домен і TLS показує IP для A-запису. Створіть у DNS домену запис A на цю адресу (і для www, якщо потрібно). Коли запис розійдеться, сертифікат Let’s Encrypt випускається сам; HTTP перенаправляється на HTTPS перемикачем «Лише HTTPS».

  • Let’s Encrypt — автоматично, щойно домен указує на сервер.
  • Custom — свій сертифікат (наприклад, Cloudflare Origin), завантажується в розділі «Сертифікати».
  • Wildcard — для *.домен через DNS Cloudflare.
  • Без TLS — лише HTTP; для тестів.
Домен за Cloudflare. Якщо проксі Cloudflare (помаранчева хмарка) увімкнено, позначте це в проєкті: панель підбере режим і сертифікат. У Cloudflare поставте режим шифрування Full (strict) із сертифікатом Origin або Full.

Ваш застосунок працює за проксі панелі: TLS завершує проксі, до контейнера запит приходить по HTTP із заголовком X-Forwarded-Proto: https. На обробнику PHP застосунок бачить HTTPS як звичайно ($_SERVER['HTTPS']) — нічого вмикати не треба; на Node.js, Python і Go увімкніть довіру до проксі у фреймворку, щоб абсолютні адреси були з https://.

5. Змінні оточення, порти, cron

  • Змінні — блок «Змінні оточення»: пари КЛЮЧ=значення стають змінними середовища контейнера (секрети, адреса бази, APP_ENV). Після збереження проєкт перезапускається.
  • Порти — для сервісів не по HTTP (гра, VPN, бот із власним портом): панель видає зовнішній порт на сервері. Сайту порти не потрібні — HTTP іде через домен.
  • Cron і процеси — задачі за розкладом (* * * * *; команда виконується всередині контейнера в каталозі проєкту, вивід іде в «Логи») і фонові процеси, які панель тримає запущеними (черги, воркери).

6. Бази даних

Розділ Бази даних (або вкладка «Бази» в картці): «База для цього проєкту» створює базу і одноіменного користувача з повними правами. У картці бази — хост, порт, рядок під’єднання; пароль користувача показується один раз, його можна змінити. Ці значення вписуються в конфігурацію застосунку.

7. Де дивитися, що відбувається

  • Логи — живий вивід контейнера: вебсервер, помилки PHP, вивід вашого застосунку.
  • Події на вкладці «Огляд» — що робила панель: деплої, перезапуски, продовження.
  • logs/ у файлах проєкту — deploy.log і build.log.
  • Використання ресурсів — якщо CPU впирається в ліміт або пам’ять на межі, час підняти тариф: кнопка «Підвищити тариф» у шапці, діє одразу.

Не виходить — напишіть у Підтримку або на [LANDING_SUPPORT_EMAIL]: тікет бачать ті, хто бачить ваш проєкт. Відповіді на часті запитання — у FAQ.