Англійський словник для розробників Fly.io

Fly.io - це платформа, яка запускає контейнеризовані програми поруч з вашими користувачами в десятках регіонів світу. Це популярно серед розробників, які будують повноцінні застосунки, API і фонові працівники, які хочуть низької затримки глобальних розгортань без управління Kubernetes. Fly.io має свою власну термінологію — Машини, Томи, Приватна мережа, Anycast — яка відрізняється від інших хмарних платформ. Якщо ваша команда розгортає на Fly.io, розуміння цього словника є необхідним для спілкування про розгортання, мережу, зберігання і вартість. Цей запис охоплює терміни, які найчастіше з’ являються в інженерних обговореннях Fly. io.

Ключовий словник

** flyctl ** Офіційний інструмент командного рядка для взаємодії з Fly.io. Використовуйте flyctl (часто називається fly ) для запуску програм, розгортання нових версій, керування Машинами, перевірки журналів, відкриття сеансів SSH і налаштування секретів. Більшість операцій Fly.io проходять через цей CLI.

• Приклад: « Запустити fly deploy з кореня проекту, щоб збудувати образ Docker і розгорнути його до набору регіонів — flyctl автоматично обробляє збирання і відсилання. » *

fly.toml Файл налаштувань у кореневому каталогу проекту Fly. io, який визначає назву програми, регіони, параметри збирання, HTTP-служби, перевірки стану та розподіл ресурсів. Це Fly.io еквівалент докер-композиції або Kubernetes манифесту. Приклад: «Підтвердження fly.toml для додавання регіону nrt і збільшення виділення пам’яті до 512 МБ — програма OOM-зривається в Токіо під час пікового трафіку.»

Машина Fly.io’s compute primitive — легка віртуальна машина, що запускає один образ контейнера. На відміну від традиційних VM, Машини можуть запускатися за мілісекунди і оплачувані тільки під час виконання. Програма може виконуватися на декількох комп’ ютерах у різних регіонах. Приклад: «У нас є три Машини в fra і дві в sea — балансувальник навантаження автоматично маршрутизує запити до найближчої здорової Машини.»

Голос Постійне блокове зберігання Fly.io, яке приєднується до Машини і переживає перезапуски і розгортання. На відміну від зберігання у контейнері, дані на томі не втрачаються при заміні машини. Томи залежать від регіону і можуть бути знімані.

• Приклад: « База даних SQLite має бути розміщена на томі — без цього, кожне розгортання стертиме дані, оскільки файлова система контейнера є ефемерною. »*

** Приватна мережа (6PN) ** Приватна мережа Fly.io IPv6, яка з’єднує всі машини в організації, навіть між регіонами. Програми спілкуються між собою через 6PN адреси (зона .internal DNS) без виставлення трафіку на публічний інтернет. Приклад: “Сервіс API викликає базу даних через 6PN — використовуйте .internal назву вузла замість публічної адреси, щоб трафік залишався в приватній мережі і не викликав витрат на вихід.”

Відродження сітки Зашифрована мережа тунелю, що підтримує приватну мережу Fly.io. Fly.io автоматично керує WireGuard між машинами, і ви також можете під’єднати свою локальну машину розробки до приватної мережі організації за допомогою fly wireguard create. Приклад: “Використовуйте fly wireguard create, щоб під’єднати ваш ноутбук до мережі WireGuard — тоді ви зможете отримати доступ до бази даних безпосередньо через адресу .internal.”

• В любое время Стратегія маршрутизації, за якої одна і та ж IP- адреса буде оголошено з декількох географічних місць одночасно, а вхідні з’ єднання буде автоматично маршрутизовано до найближчої точки присутності. Fly.io використовує Anycast для своїх спільних IP-адрес, тому запити автоматично обслуговуються найближчим регіоном. Приклад: «Маршрутизація Anycast Fly означає, що користувачі в Сингапурі автоматично потрапляють в регіон sin без будь-яких обманів DNS — це обробляється на рівні мережі.»

** Тигровий склад ** Fly.io глобально розповсюджений S3-сумісний сервіс зберігання об’єктів. Tigris автоматично реплікує об’ єкти поруч з місцем доступу до них, що робить його придатним для зберігання вивантаженого користувачем, статичного матеріалу та інших файлів, які потребують глобального читання з низькою затримкою.

• Приклад: « Вивантажити аватари користувачів на Tigris замість локального тома — Tigris буде кешувати файли, розташовані поруч з регіоном кожного користувача, тому завантаження зображень буде швидким у всьому світі. » *

Як використовувати цей словник

Архітектурні дискусії Fly.io часто зосереджені на відносинах між машинами, томами і регіонами. Зазвичай, у процесі розробки програм виникає питання: « Чи слід зберігати ці дані у томі, приєднаному до однієї машини, чи у Tigris для глобального доступу?» Відповідь залежить від того, чи слід зберігати дані поруч з обчислюваним об’ єктом (том) або поруч з користувачем (Tigris).

Мережеві розмови часто включають 6PN і розрізнення між публічним і приватним трафіком. Інженери нагадують один одному використовувати .internal hostnames для обміну даними між службами і резервувати публічні адреси для вхідних даних користувачів.

Приклад розмови

** Тейлор: ** Функція завантаження зображень для користувачів в Азії працює повільно. ** Сем: ** Ви зберігаєте вивантаження на локальному томі або у Tigris? Локальний том у fra. Мені переїхати до Тигру? ** Сем: ** Так — Tigris буде обробляти зображення з найближчого краю. І переконайтеся, що API-машина в sin може досягти її через 6PN, щоб уникнути вихідних платежів.

Practice

1. Відкрийте файл fly.toml проекту з відкритим кодом, розгорнутого на Fly. io, і визначте список регіонів, розмір машини та монтування томів. Опишете архітектуру двома реченнями, використовуючи словник з цього повідомлення.
2. Поясніть колегі різницю між об’ ємом Fly. io і сховищем Tigris — коли ви б вибрали кожен з них? Напишіть від двох до трьох речень, використовуючи « постійний », « регіональний » і « глобально розповсюджений »
3. Вправитись у розгортанні потоку дій уголос: « Я вніс зміну, оновив fly.toml і запустив [команду], щоб розгорнути. Нова Машина запустилася в [регіон] і балансувальник навантаження почав маршрутизувати трафік до неї після того, як перевірка стану пройшла»

Навігація та зв’язок

Будьмо чесними - перегляд коду не завжди є сонячним і веселим. Навіть досвідчені розробники борються з надання конструктивної критики, і нюанси професійної англійської є ключовими для чіткого спілкування в ці моменти. Це не просто вказівка на ваду; це пояснення * чому * це проблема і запропонування рішення таким чином, що запрошує до співпраці, а не до оборони. Поширена фраза, з якою ви зіткнетеся, це «nitpick», що не обов’язково означає, що проблема незначна - це часто відноситься до стилістичних або форматувальних проблем, які, хоча і технічно коректні, можуть бути поліпшені для послідовності в коді. Ви можете отримати коментар на зразок: « Ця назва змінної могла б бути більш описовою; розгляньте можливість використання userId замість просто id ». Це не звинувачення у поганому кодуванні; це запрошення до вдосконалення ясності і підтримки.

Інший поширений сценарій включає обговорення архітектурних рішень з вашою командою, особливо при запропонуванні змін до налаштувань Fly.io. Такі фрази, як «компроміс» є тут неймовірно важливими. Коли ви пропонуєте зміну типу тома - можливо, перехід з local на ebs для поліпшення продуктивності - вам потрібно буде сформулювати наслідки. Сказати «Давайте використаємо ebs» недостатньо; Ви повинні пояснити, «Перехід на ebs пропонує кращу продуктивність вводу/виводу, але вводить залежність від AWS EBS і збільшує витрати на зберігання. Це представляє собою компроміс між швидкістю і складністю операцій. “Також, при обговоренні конфігурацій мережі, розуміння таких термінів, як “Anycast” - маршрутизація трафіку через декілька географічно розподілених серверів для збільшення резервування - є життєво важливим. Пояснення цього неексперту вимагає ретельної фрази: «З Anycast, запити автоматично маршрутизуються до найближчого доступного сервера, забезпечуючи стійкість до збоїв і поліпшену затримку для користувачів у всьому світі»

Нарешті, пам’ ятайте, що розмови Slack часто вимагають точної мови при документуванні роботи. Хороший опис PR не просто « Виправлено помилку ». Це щось на зразок « Реалізовано механізм повторних спроб з експоненційним відновленням для невдалих з’ єднань з базою даних у службовому робочому процесі. Це вирішує проблему з перервними помилками з’ єднання, які спостерігалися під час пікових навантажень, і покращує загальну стабільність служби. Зміна використовує flyctl для оновлення файлу налаштувань.”

Ось приклад використання flyctl для оновлення параметра fly.toml:

flyctl config set SERVICE_WORKER_MAX_RETRIES 5 --scope=service-worker

Ця команда встановлює значення змінної налаштування SERVICE_WORKER_MAX_RETRIES у середовищі Fly. io робітника служби на 5, що забезпечує, що робітник служби спробує максимально п’ ять повторних спроб перед тим, як зазнає невдачі, якщо трапляється помилка з’ єднання. Це демонструє, як прямого контролю над конфігурацією можна досягти за допомогою інструментів CLI і точно відображає розмову про поліпшення стійкості.