2018-08-11

О ГИС

ГИС — это Географическая Информационная Система. Именно поэтому 2ГИС так называется. Это и геоинформационная система, то есть карта, и Городская Информационная Система, то есть справочник организаций.
Но 2ГИС — это, так сказать, read-only GIS. Вы можете посмотреть, поискать, построить маршрут. Но ничего не можете менять.
В серьёзном взрослом мире нужно таки менять. Рисовать карты. Рисовать что-нибудь на картах. Типичный пример: OpenStreetMap. Это общенародная карта, где всякий может подрисовать свой гараж или тропинку в саду.
Но OSM собирает только картографические данные. А иногда нужно просто нарисовать что-то в привязке к местности. Я не геодезист и не архитектор, но, подозреваю, этим людям постоянно нужно что-то проектировать именно на карте. И для них существуют специальные GIS программы. Так же как для инженеров/чертёжников существуют CAD.
Хотел сказать, что единственной вменяемой свободной GIS является QGIS. Именно ею я и пользовался. Но Википедия говорит, что десятки их. Десятки только свободных. Но я всё равно рекомендую QGIS.
QGIS splashscreen
(На самом деле уже релизнулась версия 3.2, но во второй ветке сплешскрины красивее.)
Для чего вам может понадобиться ГИС? Почти для всего, где вам нужна будет карта. И надо на этой карте что-то нарисовать. Наложить треки, расставить точки, подсчитать расстояния. Да хотя бы редактировать OSM. Простые гугло/яндекс карты далеко не всё это могут.
Например, такая задача. Есть местность, где производятся некие инженерно-копательные работы. Вам, как программисту, нужно отобразить на карте план этих работ, дополнить всякими метками и графиками. В веб-приложении. И чтобы было сэкси.
Как бы не проблема. Есть Mapbox или Leaflet. Они могут отображать на своих слоях любой GeoJSON. Понятно, что GeoJSON можно просто сохранить в БД и выдавать по запросу. Или можно генерировать его из каких-то пространственных данных в другом формате.
Но где взять эти пространственные данные? Где взять эти точки, линии и многоугольники, с широтой и долготой по WGS 84? Если всё, что у вас есть — некий план, нарисованный в Paint. Хорошо хоть, в масштабе.
QGIS screenshot
Открываем QGIS и создаём новый проект...
Технически QGIS проект — это просто каталог слоёв. В виде файла с расширением .qgs в формате XML. А сами слои — это уже отдельные файлы, и не только файлы. Слои можно упорядочивать, группировать, скрывать или отображать, добавлять новые, удалять из проекта. Можно редактировать, но не все.
Условно можно выделить три типа слоёв.
Векторные слои. Самые важные, ибо вся работа, как правило, делается в них. Эти самые точки, линии да многоугольники — есть векторные сущности.
Векторные данные можно загружать из БД. Из PostgreSQL, возможно с PostGIS, хотя он умеет пространственные данные и просто из коробки. Из SpatiaLite — геопространственного расширения SQLite.
Векторные данные можно брать из файлов. Тот же GeoJSON сгодится. Треки в виде GPX файлов. Можно даже импортировать настоящие автокадовые чертежи в DWG. Только сначала нужно их конвертировать в DXF.
Если не связываться с базами данных, то самый ходовой формат для векторного слоя — так называемые Shapefiles. В одном Shapefile можно хранить только один тип данных: точки, линии или полигоны. QGIS умеет редактировать shapefiles в полном объеме.
Технически это на самом деле несколько файлов. .shp — бинарный файл с географическими координатами. .dbf — табличка dBase со свойствами наших географических примитивов. И ещё несколько для всяких связей, индексов и описания используемой системы координат.
Да, добавляешь в проект десяток слоёв, и вот уже в папочке проекта завалялась сотня странных файлов. А учитывая, что один и тот же файл можно умудриться включить в проект в виде разных слоёв, например, с разным отображением, то вообще кошмар.
Shapefile vs
Второй тип слоёв: растровые. Обычные картинки из пикселей. Их тоже можно натянуть на карту. Обычно предпочитают TIFF, потому что в него можно включить метаинформацию о тех же координатах. А вот рядом с PNG могут снова образоваться вспомогательные файлы.
Третий тип слоёв: тайловые подложки. Если рисуем на местности, нужно эту местность для начала как-то представить. И, с помощью плагина OpenLayers мы можем добавить в наш проект слой с картинкой из OpenStreetMap, или карт Google, или даже спутниковых снимков от Bing или снова от Google. Это будет работать как обычные веб-карты (только медленнее), тайлы будут качаться из интернетов.
Шаг нулевой выполнен. Добавлен нижний слой с тайлами из OpenStreetMap.
Плагины. QGIS написан на PyQt. И плагины к нему пишутся на Python. Тысячи их. Собственно, весь QGIS — это сборище плагинов.
Шаг первый. Мы нашли местность. Теперь на эту местность нужно натянуть план из растровой картинки. Это называется Georeferencing.
Дело в том, что естественными координатами растрового изображения являются координаты его пикселей. Столько-то пикселей по горизонтали, столько-то по вертикали. Это ещё и целые числа. Это соотносится с нашими вещественными широтой и долготой, которые в градусах глобуса, почти никак. Вот координаты в пикселях и нужно преобразовать в координаты в градусах на глобусе. И хорошо ещё, если обойдётся линейным преобразованием.
Тут нужно ещё помнить, что глобусы тоже бывают разные. Но, слава богу, в этих наших веб-картах, с проекцией Меркатора, принята система координат под названием EPSG:3857 (она же "WGS 84 / Pseudo-Mercator"). Только, внимание, единица изменения тут — метры! А если нужны градусы (а они нужны), но нужны другие координаты: EPSG:4326 (они же просто "WGS 84"). Причём в GeoJSON принято сию систему координат (CRS — Coordinate Reference System) называть urn:ogc:def:crs:OGC:1.3:CRS84.
У каждого слоя может быть своя система координат. Слава богу, QGIS умеет самостоятельно всё пересчитывать на лету. Постарайтесь не запутаться. И помните, что первая координата: X — это долгота (longitude), потому что по горизонтали. А вторая координата: Y — это широта (latitude), потому что по вертикали.
Поехали дальше. Нужно сделать georeferencing растровой картинки. Смысл в том, чтобы сопоставить некоторые референсные точки на картинке (в пикселях) с точками на карте (в широте и долготе). Двух точек достаточно для линейного преобразования. Но лучше расставить больше точек, чтобы сгладить погрешности, да и попробовать что-нибудь нелинейное. Как правило стоит обозначить что-нибудь по углам картинки, и ещё что-нибудь в середине.
Как нам это сделать? Я нашёл аж три способа.
Номер раз. Стандартный плагин Georeferencer GDAL. Eго не нужно скачивать, достаточно просто включить. Даёт, пожалуй, наиболее точный результат. При точных входных данных, конечно. Умеет красивые нелинейные преобразования. Если у вас на картинке есть линии, которые должны быть соответствующими линиями на карте, у вас есть неплохой шанс точно натянуть картинку на эти линии.
Алгоритм работы такой. В отдельном окошке загружаем картинку. Затем тыкаем на точку картинки и задаём координаты этой точки на карте. Для поиска координат на карте пригодится другой стандартный плагин Coordinate Capture. Помните, X — это долгота, а Y — это широта.
Georeferencing points
Когда мы натыкали достаточно точек, и сохранили их в отдельном файлике для этой картинки, можно попробовать выгнуть картинку, сохранить выгнутую, и добавить её слоем в наш проект. Можно выбрать несколько видов трансформации. Мне больше всего понравился "Projective". Это линейная трансформация, то есть она не изогнёт картинку дугой. Это линейная трансформация в трёх изменениях, то есть двумерная картинка обрабатывается матрицей три на три, и получается какая угодно наклонная проекция на плоскость карты. Получается неплохо.
Georeferencing transformations
Если результат нас не устраивает, удаляем слой из проекта, и возвращаемся к проставлению дополнительных опорных точек, или даже удалению лишних. Не очень интерактивненько.
Способ номер два. Плагин Freehand raster georeferencer. Как понятно из названия, всё придётся делать руками. Сюда сместить, тут наклонить, тут поднянуть. Прямо таскаете картинку (её лучше сделать полупрозрачной) по карте, пока не ляжет нормально. Получается быстро. Кривые картинки мостить удобнее. Но, конечно, никакой суперточности. Для нашего плана из Paint — самое то, пожалуй.
Freehand georeferencer
Способ номер три. Плагин Raster Bender. Плагин экспериментальный, так что не забудьте разрешить установку экспериментальных плагинов. Им я так и не воспользовался, извините. Но иконка зачотная.
Bender
Зато я воспользовался его ближайшим родственником: плагином Vector Bender.
Дело в том, что ещё мне понадобилось натянуть на карту чертёж в том самом DWG. То есть сделать georeferencing для векторных данных. И если для растра есть несколько вполне приличных способов, то для вектора всё как-то не очень. Из более-менее стандартных средств есть разве что Affine Transformations. Но там нужно матрицу трансформации тупо задать руками. А откуда взять цифры? Облазать полкарты с линейкой? И всё равно промазать?
Вот тут Vector Bender и пригодился. Он тоже экспериментальный, так что будьте осторожны. И он не то, чтобы сильно удобный в использовании.
В процессе создаётся целый новый слой. С прямыми. Которые обозначают векторы трансформации. То есть нужно указать, какая точка куда перемещается. А потом переместить. А потом ещё указать, если промахнулись.
В отличие от штатного растрового Georeferencer, Vector Bender определяет тип трансформации по количеству векторов. Линейная будет, если будет задано ровно два вектора перемещения. Это не удобно. А если задать больше, он будет править геометрию. Очень локально, пытаясь прилепить вот эту ближайшую точку вот сюда.
Ладно. Картинку на карту натянули. Где нам взять GeoJSON? Да просто обвести картинку. Создать новый векторый слой (в Shapefile), и натыкать в нём точек, если нужно пометить точки. Или нарисовать линий, если нужно обвести линии. А потом этот слой сохранить в GeoJSON.
Не забудьте указать EPSG:4326 при сохранении. И выставьте точность в шесть знаков после запятой. Квадриллионные доли градуса, которые предлагаются по умолчанию, вам не нужны.
Ну и всё. Извините, что не прикладываю скриншоты со своего QGISа. Ибо NDA.

2018-07-14

Об Астане

Из Астаны (тогда ещё Акмолы) я уехал в 1997. Потом, пока учился, проводил там лето. С тех пор продолжаю наезжать на несколько дней каждые год-два.
Астана выросла. Если верить карте, то она теперь аж по двадцать километров с севера на юг, и с запада на восток. Почти как Омск. Только в Омске через весь город идёт лишь две-три дороги вдоль Иртыша. А в Астане, так как строят заново и в пустой степи, есть много широких параллельных магистралей.
Астана выросла. Если верить Википедии, там уже второй год как больше миллиона жителей. Но на улицах это как-то незаметно. Да, в торговых да развлекательных центрах, возле популярно-туристических мест, особенно на день города, — толпы народу. Но просто на улицах как-то до странного пустынно. Или это потому что улицы широкие, и автобусы ходят часто? Или это потому что в эти дни днём было довольно жарко?
Генеральный план
Автобусы действительно ходят часто. Как и написано, каждые 10-15 минут. На многих остановках поближе к центру висят табло, где честно показывается, через сколько минут какой автобус на эту остановку подойдёт. Почти как табло в аэропортах и на вокзалах. И автобусы действительно подходят.
В автобусах можно расплатиться наличными, девяносто теньге со взрослого носа (где-то чуть меньше двадцати рублей). Расплатиться кондуктору. Кондукторы тут встречаются весьма колоритные. Они могут, как морские волки, стоять, ни за что не держась, на крутых поворотах. Они могут, как вежливые дворецкие, выяснять у пассажиров, не выходят ли они на следующей остановке, громогласно доносить эти сведения водителю, и чуть ли не самостоятельно предупредительно открывать двери перед тобой.
А вот водители автобусов явно брали уроки у омских маршрутчиков. Везут дрова. Резко ускоряются, резко тормозят, входят в повороты на скорости выше разумной. Подрезают друг друга на остановках, блокируют, и высаживают пассажиров в вонючий бок другого автобуса. У них что, KPI такой кривой, что им нельзя не торопиться? Хорошо хоть, что все эти непотребства они делают на выделенной автобусной полосе.
Кстати, а почему автобусы? Почему не электробусы? Это же модно, молодёжно и экологично. Дорого?
Небоскрёбы
Много потёртых, ушатанных, помятых, старых японских автомобилей. То ли тут требования к тех. состоянию автомобилей менее строгие. То ли какая-то особенность местного автострахования, что вмятины никого не волнуют.
От аэропорта куда-то в город строят то ли монорельс, то ли просто надземное метро. Собирались это соорудить ещё к Expo 2017, но начали строить только сейчас. Вдоль дороги возводят железобетонные Y-образные опоры, очень похожие на опоры метромоста в Омске. Строит китайский подрядчик, силами китайских рабочих, на деньги китайского инвестора, в Астане.
Строят много. Строят везде. Город всё дальше и дальше расползается по степи. Скоро будет поглощать многочисленные озёра и болота вокруг.
Новый пешеходный мост
Казалось, что после Байтерека и соответствующего бульвара с небоскрёбами по бокам, благодаря которым город существенно шагнул на левый берег Ишима, уже ничего не будет. Ан нет. К тому самому Expo 2017 построили не только выставочные павильоны, но и здоровенный торговый центр «MEGA Silk Way», и целый квартал больниц.
Скоро застроенный левый берег Ишима сравняется по площади с историческим правым берегом. А в середине этого левого берега есть квадратный километр ботанического сада. Целый квадратный километр, засаженный деревьями. Они ещё маленькие, но через несколько лет это может стать очень интересным местом для прогулок.
Действительно, строят не только министерства и жилые кварталы. Очень очень много новых больниц. Половина из них названы национальными («ұлттық») или именем действующего президента. Аэропорт, кстати, тоже именем президента теперь назван.
По всему городу начали появляться велодорожки. С забавными поднятыми наклонными урнами возле них. Типа чтобы можно было на ходу бяку выкинуть. Но велосипедистов что-то мало видно. Имеются парковки, где можно взять велосипед напрокат. Но я лишь раз видел, чтобы кто-то ими пользовался.
Скульптура
Мы попали на празднование двадцатилетия столицы. И день рождения президента заодно. Не очень заметно, чтобы это как-то особо затронуло горожан. Ну да, в пятничный выходной все пошли гулять по паркам. Как и в любой другой выходной. По отзывам, многие просто уехали из города на длинные выходные.
Зато на многих мало-мальски солидных площадях поставили сцены и были концерты. Мы попали лишь на сцену у Байтерека, где проходил фестиваль современной этнической музыки. Ребята из Грузии, с шикарным этническим акцентом, пели песни «про любовь» и «для женщин». По-грузински, под аккомпанемент бас-гитары, клавишных и ударных. Современная же, хоть и этническая, музыка.
Ещё мы сходили в павильон «Нұр Әлем», что остался после Expo. Это здание в виде гигантского стеклянного шара. С выемкой под муляжи ветрогенераторов на верхушке. Поэтому его называют «звездой смерти». Теперь там получился неплохой музей, посвящённый различным способам добывания энергии. Очень хороши интерактивные стенды, но их маловато.
Нур Алем снаружи
Я не устаю удивляться, как в современных музеях используют проекторы. В этот раз это были громадные анимированные пространства, где на всех стенах и потолке показывали историю птицы Самрук (которая как раз откладывает золотое яйцо-солнце в дерево Байтерек) и дракона Айдахара. Тюркская мифология — такая мифология.
Нур Алем внутри
Кажется, Астана становится настоящим городом. Не искусственно выращенной столицей, а настоящим. Живёт своей жизнью. Растёт. На какие деньги? А кто ж знает. Зато, чтобы найти ямы на дорогах, нужно очень постараться.
Страна становится суверенной не только, когда у неё появляется свой язык и валюта. Ещё появляются свои правила блокировки Интернета, свои платёжные системы, свои правила избрания президента и начисления пенсий. Даже роуминг становится таким же дорогим, как в Европе. В этом смысле Казахстан действительно теперь ощущается как другая страна, а не как площадка для запуска российских ракет.
Кстати, а вы знаете, что Казахстан собирается переходить на латиницу? При этом они обойдутся лишь апострофами над некоторыми буквами, и почти без диграфов. Имхо, с латиницей будет лучше. Будет сильно меньше проблем с казахофикацией. Наконец-то появятся красивые шрифты на вывесках, а не тот один-единственный уродливый шрифт, что везде вывешивают сейчас. Забавно, что название страны, «Қазақстан», по свежим правилам латиницы будет писаться как «Qazaqstan». Да, с буквы «Q».

2018-06-30

О коде

Мы — программисты. Мы пишем код.
Мы — девопсы. Или сисадмины. Или инженеры по инфраструктуре. Мы пишем конфиги.
Infrastructure
Существует множество правил и техник как правильно писать код. От паттернов до SOLID. В общем, всё сводится к тому, чтобы избегать дублирования кода, переиспользовать код, делать код таким, чтобы его можно было переиспользовать без изменения самого кода.
В результате, хорошо написанный код гибко настраивается, чтобы его можно было применить в большем количестве случаев. А параметры настройки часто пишутся в файлах конфигурации, конфигах.
Если нужно ещё больше гибкости, то встраивают какой-нибудь язык программирования. Часто интерпретируемый. (Привет, JavaScript. Привет, Lua.) И, помимо основного кода, у нас появляются скрипты.
Например, игры. Со времён Quake (и даже раньше) у любой серьёзной игры есть движок. Это — код, написанный программистами. И ресурсы. Это — конфигурация, написанная гейм-дизайнерами. Со своими скриптами на QuakeC. И именно ресурсы делают игру игрой. Движок лишь предоставляет техническую возможность.
Где проходит граница между кодом и конфигом?
Если мы сделали классный и расширяемый код, не пора ли сделать классные, удобные и расширяемые конфиги к нему?
Есть ли паттерны и SOLID для конфигов?
Очевидно, есть. Только никто ещё не написал про это книжку. Возможно, потому, что не существует конфигов «общего назначения».
Посмотрите, как организована конфигурация того же Nginx в Debian-based дистрибутивах. В каталоге /etc/nginx/sites-available, в отдельных файлах, имеются конфигурации виртуальных хостов. Чтобы включить виртуальный хост, нужно создать симлинк в каталог /etc/nginx/sites-enabled. Чтобы выключить, нужно убрать симлинк. Чтобы добавить новый виртуальный хост, достаточно добавить новый файл, и сказать Nginx перечитать конфиги. Не нужно править уже существующие конфиги. Имхо, это вполне очевидное следование заветам SOLID.
Причём со стороны самого Nginx тут нет ничего сверхъестественного. Он читает лишь один файл /etc/nginx/nginx.conf. Но в этом файле имеется несколько директив include. «include» является точкой расширения конфига. И позволяет применять паттерны. Как те, которые приняты в Debian.
А Ansible? Изначальная идея очень проста. Есть модули, которые делают что-то полезное. Которые написаны на настоящем языке программирования Python. И которые могут переиспользоваться. Мы пишем последовательность вызова модулей, с соответствующими параметрами. То, что в Ansible называется task. Пишем в YAML файле. То есть пишем конфиг.
Но мы тоже хотим переиспользовать и расширять эти YAML файлы. И есть много способов в Ansible для этого. Можно переопределить переменные (а переменные могут влиять на поведение). Повторяющиеся наборы задач выделяют в роли, которые можно распространять и переиспользовать. Наборы хостов, на которые можно применить эти роли, образуют inventory. Ну и инклюды тоже никто не отменял.
Кстати, о переменных. Переменные окружения — неотъемлемая особенность процессов Unix. И они, нежиданно, снова в ходу для этих наших контейнеров. Казалось бы, каким образом можно огранизовать набор ключей и значений? Но и тут у нас есть наследование и возможность переопределить.
А Terraform? Хоть тут вовсе не императивный, а вполне себе декларативный язык, о расширении и переиспользовании разработчики позаботились.
Снова переменные, которые можно задать и переопределить кучей разных способов. Переиспользуемые модули. Публичные репозитории готовых модулей. Workspaces, чтобы добавить ещё одно изменение, где этот код может быть переиспользован.
Reusable
Что бы ни считали разработчики, что с момента написания достаточно SOLIDного кода, когда все мыслимые настройки вынесены в файлы конфигурации, и их работа закончена, на самом деле потом начинается программирование конфигов. Программирование на XML (о, да, XSLT), на YAML, на HCL. (Только не на JSON, пожалуйста. Потому что в JSON нет комментариев.)
Конфиги — тоже код. Рано или поздно, так или иначе. И нужно предусмотреть способы расширения. И предложить шаблоны использования. Раз уж сами по себе языки разметки ничего подобного не умеют.

2018-06-12

О Terraform

Я освоил Terraform. Это ещё один замечательный инструмент от HashiCorp. Это те ребята, которые за immutable infrastructure. Которые сделали Vagrant, Consul, Packer и кучку других инструментов, популярных в альтернативной-Docker вселенной.
Terraform делает только одну задачу. И делает её хорошо. Задача эта: создать, собрать и настроить и ввергнуть во тьму ресурсы. Любые ресурсы, которые можно описать в виде набора свойств, понятных провайдеру этих самых ресурсов. В первую очередь речь идёт о ресурсах наших любимых вычислительных облаков. AWS и Azure. И множества других.
Terraform — это не есть единое API для всех облаков. За единым API попробуйте сходить к Kubernetes. Terraform — это единый способ описания ресурсов. Возможно, сразу в нескольких облаках. Но вот сами типы ресурсов, их имена и атрибуты, будут в каждом облаке свои. И в них придётся разобраться.
Зато описания ресурсов будут в текстовом виде. В файлах формата HCL (это нечто среднее между JSON и YAML). В вашей системе контроля версий. Это и называется Infrastructure as Code.
Terraform logo
Terraform написан на Go. Так что вся установка сводится к распаковке единственного бинарного файла из архива, прописыванию его в PATH и настройке автодополнения в вашей shell.
Поехали по терминологии.
Конфигурация. Configuration. Это набор *.tf файлов в текущем каталоге, то есть где вы запустили terraform. В этих файлах вы описываете то, что вам нужно создать и поддерживать. Не важно, как вы эти файлы назовёте. Не важно, в каком порядке в них всё опишете. Есть только небольшое соглашение, что должны быть файлы: main.tf — типа заглавные определения, variables.tf — все входные переменные, outputs.tf — все выходные переменные данной конфигурации.
Провайдеры. Providers. Плагины, отдельные бинарники, которые определяют весь остальной набор того, что можно задать в конфигурации. Они скачиваются при инициализации конфигурации. Инициализация делается командой terraform init.
Вот как может выглядеть описание провайдера для амазонового облака (AWS):
provider "aws" {
    version = "~> 1.20"
    region = "${var.aws_region}"
    profile = "${var.aws_profile}"
}
Конструкции с фигурными скобками — это interpolations. В данном случае берутся значения двух входных переменных.
Переменные. Variables. Входные значения для вашей конфигурации. Их надо явно описать:
variable "aws_profile" {}
variable "aws_region" {}
Переменные бывают трёх типов: строка, список, map. В данном случае тип не указан, и подразумевается строка. С поддержкой вложенных типов, типа списка mapов, всё настолько неопределённо, что лучше считать, что вложенных типов нет.
Значения для переменных, как и положено, можно передавать кучей разных способов. Через переменные окружения типа TF_VAR_aws_profile. Через параметры командной строки типа -var 'aws_profile="terraform"'. Через файлы *.tfvars, которые нужно явно передавать в командной строке: -var-file ../test.tfvars. Через файлы *.auto.tfvars в текущем каталоге, которые подгружаются автоматически. Понятное дело, есть правила переопределения переменных, а mapы даже мержатся.
Есть ещё выходные переменные. Это некоторые значения, которые являются выходом вашей конфигурации. Эти значения потом можно легко получить командой terraform output.
Ресурсы. Resources. То, ради чего всё это и затевается. Ресурсы, поддерживаемые провайдером, которые нужно создать, или модифицировать, или удалить.
У каждого ресурса есть тип, зависящий от провайдера, имя, в контексте данной конфигурации, и набор аргументов, которые нужно передать ресурсу. Также ресурс имеет некоторые атрибуты, это какие-то, возможно, вычисляемые значения, которые становятся известны, когда ресурс создан.
Вот как может выглядеть, например, создание S3 бакета:
resource "aws_s3_bucket" "frontend_bucket" {
    bucket = "${var.environment}-frontend"
    acl = "public-read"
    website {
        index_document = "index.html"
        error_document = "index.html"
    }
    tags {
        Name = "${var.deployment} Frontend"
        Environment = "${var.environment}"
        Deployment = "${var.deployment}"
    }
}
Атрибуты одних ресурсов могут быть указаны как interpolations при создании других ресурсов. Тогда Terraform понимает, что ресурсы имеют зависимость, и создаёт их в правильном порядке.
resource "aws_cloudfront_distribution" "frontend_s3_distribution" {
    origin {
        // вот ссылка на S3 bucket
        domain_name = "${aws_s3_bucket.frontend_bucket.bucket_domain_name}"
        origin_id = "S3-${var.environment}-frontend"
    }

    //... у CloudFront Distribution ооочень много аргументов
}
Чаще всего ресурсы один в один соответствуют тем ресурсам, что можно создать через API или в консоли управления облаком. Но иногда встречаются и «псевдоресурсы», которые представляют собой команды модификации «настоящих» ресурсов.
Например, Security Groups в AWS. Часто нужно, чтобы одна Security Group ссылалась на другую, а та ссылалась на эту. В консоли это проблем не вызывает, создаём обе, а потом модифицируем права доступа, чтобы они ссылались друг на друга.
Terraform так не умеет. Он считает, что все ресурсы должны быть созданы за один присест, без многошаговых модификаций, в порядке, согласно их зависимостям (а если нет зависимостей, то даже параллельно). А здесь получается циклическая зависимость, которая Terraform не устраивает.
Для решения проблемы придумали «псевдоресурс» aws_security_group_rule, который фактически является шагом модификации «настоящего» ресурса aws_security_group. Циклическая зависимость разрывается. Настоящие ресурсы создаются в несколько шагов.
// первая security group
resource "aws_security_group" "alb_security_group" {
    name        = "${var.environment}-alb-security-group"
    description = "Allows HTTPS from Anywhere into ALB"
    vpc_id      = "${var.vpc_id}"

    // здесь правила доступа прописаны внутри ресурса
    ingress {
        from_port   = 443
        to_port     = 443
        protocol    = "tcp"
        cidr_blocks = [ "0.0.0.0/0" ]
        ipv6_cidr_blocks = [ "::/0" ]
    }

    egress {
        from_port   = 0
        to_port     = 0
        protocol    = "-1"
        // тут ссылаемся на вторую security group
        security_groups = [ "${aws_security_group.ecs_cluster_security_group.id}" ]
    }
}

// вторая security group
resource "aws_security_group" "ecs_cluster_security_group" {
    // тут нет ссылок на первую security group
    name        = "${var.environment}-ecs-cluster-security-group"
    description = "Allows traffic from ALB"
    vpc_id      = "${var.vpc_id}"
}

// правило доступа для второй security group
resource "aws_security_group_rule" "allow_alb_for_ecs" {
    security_group_id = "${aws_security_group.ecs_cluster_security_group.id}"

    type = "ingress"
    from_port = 0
    to_port = 0
    protocol = "-1"
    // вот тут ссылка на первую security group
    source_security_group_id = "${aws_security_group.alb_security_group.id}"
}

// еще одно правило доступа для второй security group
resource "aws_security_group_rule" "allow_egress_for_ecs" {
    security_group_id = "${aws_security_group.ecs_cluster_security_group.id}"

    type = "egress"
    from_port = 0
    to_port = 0
    protocol = "-1"
    cidr_blocks = [ "0.0.0.0/0" ]
    ipv6_cidr_blocks = [ "::/0" ]
}
Обратите внимание на передачу списков. Почему такие вольности, и почему кавычки обязательны, я не знаю.
    // одиночное значение можно обернуть в список
    list = [ "${var.single}" ]
    // список можно передать как список
    list = "${var.list}"
    // а можно обернуть в скобки
    list = [ "${var.list}" ]
    // а можно даже к списку добавить ещё значение
    list = [ "${var.list}", "${var.single}" ]
    // или даже объединить два списка
    list = [ "${var.list1}", "${var.list2}" ]
Источники данных. Data Sources. Провайдеры умеют не только создавать ресурсы, но и запрашивать атрибуты уже имеющихся ресурсов. Например, чтобы вставить какие-нибудь свойства в ваши ресурсы. Для этого и нужны источники данных.
Но есть и более интересные применения. Например, провайдер template позволяет читать локальные файлы-шаблоны, подставляя туда переменные. Синтаксис шаблонов полностью повторяет синтаксис interpolations. Что довольно убого. Циклов, например, туда не завезли.
Но есть очень интересный способ «добавить» циклы в шаблоны. Дело в том, что и у ресурсов, и у источников данных есть аргумент count. По умолчанию он равен одному, и создаётся ровно один ресурс или источник данных. (Если поставить нуль, то ничего создано не будет). А если поставить больше единицы, то будет создано несколько ресурсов или источников данных. И все атрибуты этих ресурсов или источников данных можно получить в виде списка. Это общая практика в Terraform: по спискам аргументов формировать списки ресурсов. А уж превратить список значений в тот же массив JSON — дело техники.
// определение провайдера
provider "template" {
    version = "~> 1.0"
}

data "template_file" "container_definition" {
    // читаем этот файл
    template = "${file("${path.module}/container-definition.json")}"
    // столько раз, сколько у нас задано контейнеров
    count = "${length(var.containers)}"

    vars {
        // тут доступ к элементу списка
        name = "${element(var.containers, count.index)}"
        // тут много списков...
        image = "${element(aws_ecr_repository.repository.*.repository_url, count.index)}"
        cpu = "${element(var.container_cpu_limits, count.index)}"
        memory = "${element(var.container_memory_limits, count.index)}"
        port = "${element(var.container_ports, count.index)}"
        region = "${var.region}"
        log_group = "${aws_cloudwatch_log_group.log_group.name}"
        log_stream_prefix = "${element(var.containers, count.index)}"
        environment = "${element(var.container_environments, count.index)}"
    }
}

resource "aws_ecs_task_definition" "task_definition" {
    family                   = "${var.environment}-${var.service}"
    // тут формируем json array из списка отрендеренных шаблонов
    container_definitions    = "[ ${join(",", data.template_file.container_definition.*.rendered)} ]"
    requires_compatibilities = ["FARGATE"]
    network_mode             = "awsvpc"
    cpu                      = "${var.cpu_limit}"
    memory                   = "${var.memory_limit}"
    execution_role_arn       = "${var.ecs_execution_role_arn}"
    task_role_arn            = "${var.ecs_execution_role_arn}"
}
Обратите внимание, для доступа ко всем переменным и атрибутам используется единый синтаксис с префиксами.
  • var.var_name — значение переменной
  • resource_type.resource_name.attribute_name — значение атрибута ресурса, определённого в данной конфигурации
  • resource_type.resource_name.*.attribute_name — список значений атрибутов ресурса, если count был больше единицы
  • data.data_source_type.data_source_name.attribute_name — значение атрибута источника данных
  • data.data_source_type.data_source_name.*.attribute_name — список значений атрибутов источника данных, если count был больше единицы
  • count.index — индекс текущей «итерации» «цикла», если count больше единицы
  • path.module — путь (в файловой системе) текущего модуля
  • module.module_name.module_output — значение выходной переменной модуля
Почти со всеми этими выражениями можно интерактивно поиграть, если выполнить команду terraform console.
Модули. Modules. Любая конфигурация в Terraform может рассматриваться как модуль. Текущая конфигурация, в текущем каталоге, называется root module. Любые другие конфигурации, в других каталогах файловой системы, из реестра модулей от HashiCorp, из репозитория на GitHub или Bitbucket, просто доступные по HTTP, можно подключить к текущей конфигурации и использовать.
При подключении модулю даётся имя. Под этим именем он будет здесь доступен. Нужно указать местоположение модуля. Одно и то же местоположение модуля можно подключать несколько раз под разными именами. Так что думайте об опубликованных конфигурациях как о классах, которые можно переиспользовать. А конкретное подключение здесь можно считать экземпляром класса. Наследования только нет :) Зато делегирование — пожалуйста. Модули могут использовать другие модули.
Кроме имени, модулю при подключении нужно задать аргументы. Это те самые входные переменные. Внутри модуля они будут использоваться как ${var.var_name}. А результат работы модуль предоставляет в виде выходных переменных. На них в данной конфигурации можно ссылаться как ${module.module_name.var_name}. В общем-то, почти аналогично использованию ресурсов.
// подключаем модуль и даём ему имя "vpc"
module "vpc" {
    // определение модуля берём из локальной ФС двумя уровнями выше
    source = "../../modules/vpc"

    // передаём аргументы
    environment = "${var.environment}"
    deployment = "${var.deployment}"
    region = "${var.aws_region}"
    availability_zones = "${var.aws_availability_zones}"

    // хардкодим аргументы
    vpc_cidr = "172.31.0.0/16"
    public_subnets_cidr = [ "172.31.64.0/24", "172.31.68.0/24", "172.31.69.0/24" ]
    public_subnets_ipv6_cidr = [ "2600:1f14:ee6:6300::/64", "2600:1f14:ee6:6301::/64", "2600:1f14:ee6:6302::/64" ]
    private_subnets_cidr = [ "172.31.65.0/24", "172.31.66.0/24", "172.31.67.0/24" ]
}

// вывод модуля транслируем в вывод данной конфигурации
output "public_subnet_ids" {
    // на вывод модуля ссылаемся так
    value = [ "${module.vpc.public_subnet_ids}" ]
}

output "private_subnet_ids" {
    value = [ "${module.vpc.private_subnet_ids}" ]
}
Резюмируем. Имеем набор *.tf файлов в текущем каталоге. Это — конфигурация. Или root module. Который может подключать другие модули из разных мест. Другие модули — это такие же *.tf файлы. Они принимают переменные и возвращают переменные. По ходу дела описывают ресурсы и используют источники данных.
Имеем полное декларативное описание того, что мы хотим получить. Как это работает?
Состояние. State. Второе, после конфигурации, ключевое понятие Terraform. Состояние хранит состояние ресурсов. Как оно обстоит на самом деле в этом облаке. По умолчанию состояние — это один большой (не сильно большой) JSON файл terraform.tfstate, который создаётся в текущем каталоге.
Этот файл состояния можно хранить в системе контроля версий. Но, если сильно много разработчиков будут править конфигурацию Terraform, состояние тоже будет часто меняться. И придётся постоянно править конфликты, не говоря уже о том, что не стоит забывать делать pull.
Поэтому лучше использовать remote state. Состояние можно хранить в Consul. А, в случае AWS, в S3. Тоже будет один файлик, но в облаке, и с версионированием. И будет всем доступен, и постоянно будет из облака дёргаться. Норм.
Поехали.
Сначала нашу конфигурацию нужно проинициализировать. Команда terraform init выкачивает плугины (провайдеры, бэкенды для remote state), модули (с GitHub, например), и сваливает это в скрытый подкаталог .terraform. Этот подкаталог не нужно хранить в системе контроля версий. Но он нужен для нормальной работы Terraform. Поэтому terraform init -input=false — обязательный шаг, чтобы запускать Terraform из CI.
Вторая команда для использования Terraform в обычной жизни: terraform apply. На самом деле она выполняет несколько шагов.
Шаг первый. Refresh. Terraform сравнивает текущее известное состояние с реальным состоянием ресурсов в облаке. Провайдер производит кучу запросов на чтение через облачное API. И состояние обновляется. При первом запуске состояние является пустым. Значит, обновлять нечего, и Terraform считает, что ни одного ресурса не существует.
Шаг второй. Plan. Terraform сравнивает текущее известное (и только что обновлённое) состояние с конфигурацией. Если в состоянии ресурса нет, а в конфигурации он есть, ресурс будет создан. Если в состоянии ресурс есть, а в конфигурации его нет, ресурс будет удалён. Если изменились аргументы ресурса, то, если это возможно, ресурс будет обновлён на месте. Или же ресурс будет удалён, а на его месте будет создан новый ресурс того же типа, но с новыми аргументами.
План будет представлен пользователю. С полным указанием того, что будет создано, удалено, или изменено. В той мере, насколько это известно до начала настоящего выполнения. (Идентификаторы ресурсов, например, как правило назначаются случайно, и становятся известны лишь после настоящего создания ресурса.) Надо ответить «yes», чтобы перейти к следующему шагу.
Шаг третий. Apply. Собственно, применение плана, созданного на предыдущем шаге. Согласно зависимостям. При этом снова изменяется состояние, туда записываются все настоящие свойства созданных ресурсов.
Ну вот и всё. Всё просто. Сверяемся, сравниваем, высчитываем разницу, накатываем изменения. В отличие от Ansible, сверка состояния делается один раз перед построением плана и для всей конфигурации сразу.
А теперь — нюансы.
Terraform — прост и упрям. И он не делает rollback.
К сожалению, в большинстве случаев создание даже одного ресурса — не атомарно. Даже создание S3 bucket — это с десяток разных вызовов, в основном, чтобы отдельно выяснить разные свойства этого бакета (get запросы). Если какой-то запрос не выполнился (а в моём случае наиболее частой причиной ошибок был недостаток прав на отдельные операции), Terraform считает, что создание ресурса провалилось.
Но в реальности ресурс таки мог создаться. Но это может не найти отражения в состоянии Terraform. И при повторном запуске может случиться повторная попытка создания ресурса, которая может сломаться теперь уже из-за конфликта имён. Или в облаке может оказаться более одного желаемого ресурса.
Кроме того, Terraform совсем не в курсе ресурсов, созданных автоматически при вызове API облака (пример: Elastic Network Interface в AWS создаются неявно). И не в курсе ресурсов, не описанных в конфигурации, но от которых могут зависеть его ресурсы (пример: Security Group в AWS не получится удалить, пока хоть кто-то её использует, но вот кто этот кто, Terraform знать не всегда может).
Но Terraform упрям. Так что после правки прав доступа, правки ошибок в конфигурации, и нескольких запусков terraform apply, облако таки неумолимо перейдёт в желаемое состояние. Плюс может остаться немного мусора — ненужных ресурсов, которые были созданы, но не были удалены. Мусор придётся подчистить ручками.
Потом, полагаю, придёт культура всё делать через Terraform, и сразу угадывать нужные права. И мусора будет меньше.
Можно ли перенести инфраструктуру, набитую ручками в консоли, в Terraform? Можно.
Пишете конфигурацию. Лучше добавлять один ресурс за одним. Делаете terraform import. По сути, вы сопоставляете имена ресурсов в конфигурации (resource_type.resource_name) с реальными идентификаторами существующих ресурсов (они разные для разных типов ресурсов). Terraform пытается прочитать атрибуты ресурсов и записать их в состояние. Делаете terraform plan и смотрите, не пытается ли Terraform что-то поправить. Если пытается, правите конфигурацию, и снова смотрите на план. В идеале Terraform скажет, что всё ок, и ничего править не будет. В случае похуже он всё-таки что-нибудь пересоздаст.
Аналогичным образом, только используя terraform refresh, можно привести конфигурацию в соответствие с теми изменениями, которые кто-то сделал своими шаловливыми ручками. (И ручки потом оторвать).
Импорт не всегда работает идеально. Совсем не работает для «псевдоресурсов», о которых я говорил ранее. Сложности возникают со сложными ресурсами, с множеством вложенных сущностей, вроде тех же Security Group или Route Table в AWS. Но после terraform apply и перетряхивания внутренностей ресурсов в угоду Terraform, всё устаканивается.
Рефакторинг. Рефакторинг конфигурации Terraform. Он возможен. Нужно только действовать аккуратно.
Переименование ресурса. Скорее всего Terraform предложит удалить старый ресурс, и создать новый, с новым именем. Если это неприемлемо, можно попробовать удалить ресурс из состояния командой terraform state rm, а потом сделать terraform import. Есть ещё специальная команда terraform state mv, которая вроде как специально предназначена для этого рефакторинга. Но я с помощью state mv как-то добился стабильного крэша Terraform. С тех пор остерегаюсь.
Разбиение одной большой конфигурации на несколько маленьких. На это есть несколько причин.
Причина первая. terraform apply выполняется не сильно быстро. И чем больше ресурсов имеется в конфигурации, тем медленнее. Ему же надо проверить состояние каждого ресурса, даже если в конфигурации этот ресурс и не менялся. Имеет смысл выделить части конфигурации исходя из частоты изменений и «охвата территории». Скажем, VPC вам придётся настраивать лишь один раз, и потом почти никогда не менять. ECS кластер вы будете создавать каждый раз, когда будет появляться новое окружение, и потом опять без изменений. А сервисы нужно подновлять каждый индивидуально почти при каждом деплое.
Причина вторая. Terraform пока плохо работает с версионируемыми ресурсами. Типичный пример: ECS Task Definition. Этот ресурс нельзя удалить, только пометить как неактивный. Этот ресурс нельзя изменить, только создать новую ревизию. Поэтому на каждый terraform apply будет «удалён» старый Task Definition, и создан новый Task Definition, даже если в конфигурации ничего не менялось. И обновлён ECS Service, который этот Task Definition использует.
Это приведёт к тому, что этот Service обновит и перезапустит свои таски. То есть произойдёт настоящий редеплой. Это хорошо, потому что можно делать редеплой ECS сервисов с помощью Terraform. Это плохо, потому что я не хочу редеплоить все два десятка моих сервисов одновременно по terraform apply одной большой конфигурации. Сервисы нужно выносить в отдельные конфигурации Terraform.
Хорошо. Создать ещё одну папочку с *.tf файлами рядом — не проблема. Перенести туда управление ресурсами с помощью terraform import тоже можно. Но ведь наши сервисы должны кое-что знать о кластере: имя кластера, те же Security Groups, ещё параметров по мелочи.
Конфигурации зависят от других конфигураций. Из более общих конфигураций нужно передать параметры более конкретным конфигурациям. Кластер должен знать о VPC, сервисы должны знать о кластере.
Можно передать всё, что нужно, горстку нужных идентификаторов, ручками. Как входные переменные нашей конфигурации. Будет работать. Если вы правильно скопируете эти идентификаторы.
Но есть более спортивный способ. Если у нас есть remote state, его можно подключить как источник данных, и прочитать выходные переменные совершенно другой конфигурации, чьё состояние мы подключили.
// наше состояние
terraform {
    backend "s3" {
        bucket = "my-lovely-terraform"
        key    = "environment/service/terraform.tfstate"
        region = "eu-west-1"
    }
}

// состояние региона
data "terraform_remote_state" "region" {
    backend = "s3"
    config {
        bucket = "my-lovely-terraform"
        // в другом файлике в S3
        key    = "environment/region/terraform.tfstate"
        region = "eu-west-1"
    }
}

// состояние кластера
data "terraform_remote_state" "cluster" {
    backend = "s3"
    config {
        bucket = "my-lovely-terraform"
        // в другом файлике в S3
        key    = "environment/cluster/terraform.tfstate"
        region = "eu-west-1"
    }
}

module "service" {
    source = "../../modules/ecs-service"

    // ссылаемся на выходные переменные других конфигураций
    cluster = "${data.terraform_remote_state.cluster.cluster_name}"
    ecs_execution_role_arn = "${data.terraform_remote_state.cluster.ecs_execution_role_arn}"
    vpc_id = "${data.terraform_remote_state.region.vpc_id}"
    subnet_ids = "${data.terraform_remote_state.region.private_subnet_ids}"
    security_group_ids = [ "${data.terraform_remote_state.cluster.cluster_security_group_id}", "${data.terraform_remote_state.region.security_group_ids}" ]

    //... в этом модуле у меня ещё много аргументов
}
Кроме модулей, у нас появляется возможность держать конфигурацию более-менее независимых кусков ресурсов отдельно. Это может быть удобно.
Terraform vs
Кажется, Terraform приживётся. Кажется, можно выкинуть Ansible, и оставить для управления контейнерами в AWS лишь terraform, docker и aws. Собственно, почему я пошёл в Terraform? Потому что Ansible, как оказалось, не умеет Fargate.
Terraform не заменяет Ansible, а дополняет его. Terraform создаёт ресурсы (виртуальные машины, где угодно), а Ansible настраивает их (через ssh). Другое дело, что если ресурсы — Docker контейнеры, то их и настраивать (изнутри) не нужно.

2018-06-11

Об AWS

Переход на Terraform заставил меня узнать об амазоновом облаке такие вещи, которые лучше бы я и не знал. О Terraform — в следующий раз. А сейчас — снова об AWS.
AWS Regions
Регионы. Regions. Датацентры Амазона разбросаны по всему миру. Ну кроме России. У регионов очень милые имена. В Ирландии — eu-west-1. Во Франкфурте — eu-central-1. В Орегоне (штат США такой, на западном побережье) — us-west-2. В Северной Вирджинии (это уже восток США) — us-east-1. N. Virginia — это «домашний» регион AWS, здесь раньше всего появляются новые плюшки.
Как правило, все ресурсы Амазона привязаны к конкретному региону, и живут именно в нём. Даже там, где существуют глобальные пространства имён, вроде бакетов S3, всё равно данные хранятся в конкретном регионе.
Зоны доступности. Availability Zones. Их несколько (как правило три) в каждом регионе. Амазон вроде как обещает, что никогда не будет отключать регион весь сразу, а только отдельные зоны доступности. Поэтому настоятельно рекомендуется размещать отказоустойчивые кластеры одновременно в нескольких зонах. Имя зоны доступности получается из имени региона добавлением буковки. В Орегоне, например, есть три зоны: us-west-2a, us-west-2b, us-west-2c.
Самый главный (и исторически первый) ресурс в амазоновом облаке — это виртуальные машины EC2. Elastic Compute Cloud. Вот эти вот зоны доступности и многое остальное, о чём я расскажу позднее, оно идёт от EC2. И даже если вы не работаете с EC2 напрямую, наверняка почти все сервисы Амазона работают поверх EC2. И многие соображения и ограничения из EC2 распространяются и на эти сервисы.
Идентификаторы ресурсов. О-о-о... Тут полнейший разнобой. Чаще всего встречается буквенно-цифровое обозначение, где по первым буквам можно догадаться, что это за ресурс. i-0de8aad2fb20a47ce — это идентификатор инстанса EC2. subnet-3447c77f, vpc-5e757727 — это подсеть и VPC. А вот такое: E1VO622G1KKGV1 — это CloudFront Distribution. Но похоже, что рано или поздно всё перейдёт на ARN (Amazon Resource Name) — идентификаторы, технически очень похожие на URN. Вот тот же самый CloudFront Distribution, но в виде ARN: arn:aws:cloudfront::999999999999:distribution/E1VO622G1KKGV1. А вот ARN Application Load Balancerа: arn:aws:elasticloadbalancing:us-west-2:999999999999:loadbalancer/app/sitec-test-alb/fb97bc09692c72ea.
VPC, subnets
Ничто не мешает заводить EC2 инстансы (и даже Fargate контейнеры), и раздавать им сразу публичные IP адреса (пока они есть, и пока они не заблокированы). Но когда у вас куча микросервисов, вовсе не обязательно выставлять каждый из них голой попой в Интернеты (и платить за публичный IP для каждого). То же касается и всяких баз данных и кэшей (которые managed сервисы в Амазоне). Их все можно элегантно объединить в VPC, Virtual Private Cloud.
Можно подумать, что VPC — это просто серая сеть, которая объединяет созданные в ней ресурсы. Так оно и есть. Но несколько сложнее.
VPC создаётся на весь регион. Но внутри должна содержать подсети, subnets. А каждая подсеть уже создаётся для конкретной availability zone. У подсети определён CIDR блок адресов. Либо серые IPv4, какие выберете. Либо настоящие IPv6, какие разрешит Амазон. Ресурсы в VPC всегда создаются в определённой подсети, и получают IP адрес из её блока.
Точнее не сами ресурсы, а их сетевые интерфейсы, Elastic Network Interfaces. Такие интерфейсы в VPC получают не только EC2 инстансы, но и RDS инстансы, и ElastiCache инстансы, и задачи Fargate, и даже NAT Gateway и Elastic Load Balancer. И ко всем ним применимы правила, о которых далее.
Из VPC нужно ходить в интернеты. Чтобы пакеты какие-нибудь скачать. Чтобы к DynamoDB или ECS подрубиться. Хоть это и амазоновые сервисы, но с точки зрения «из VPC» они находятся «там».
Internet Gateway
Способ выйти в интернеты номер раз. Нужен Internet Gateway. Он один на весь VPC. Ну просто ресурс такой, у него даже настроек нет. Нужно, чтобы у EC2 инстанса или ELB в подсети был настоящий IP адрес. Нужно прописать маршрут в таблице маршрутизации (Route Table), что, мол, в интернеты ходить через этот Gateway. Ну и связать данную подсеть с этой таблицей маршрутизации.
На каждую avaiability zone нам нужна своя подсеть. Назовём их публичными. Одна таблица маршрутизации, тоже публичная. Где будет сказано, что в 0.0.0.0/0 и ::/0 (не забываем про IPv6) нужно ходить через Internet Gateway. И Route Table Accosiations, чтобы сказать, что каждая из наших публичных подсетей работает с данной таблицей маршрутизации. Но это пока ещё не всё.
NAT Gateway
Способ выйти в интернеты номер два. Здесь не нужны публичные IP на каждом интерфейсе. Потому что будет NAT. Нужен NAT Gateway. Этой штуке нужно выдать публичный Elastic IP и разместить её Elastic Network Interface в одной из публичных подсетей, что мы создали ранее. Достаточно будет одного NAT Gateway на VPC.
А теперь мы можем создать ещё подсети. Снова в каждой availability zone. И ещё одну таблицу маршрутизации. Только в маршрутах теперь указываем, что в интернеты ходить надо через NAT Gateway. Связываем новые подсети с этой новой таблицей маршрутизации. Теперь интерфейсам в этих подсетях не нужно иметь публичный адрес. Их трафик будет натиться на NAT Gateway. Так как прямые подключения из интернетов в эти подсети будут невозможны, назовём их приватными. Как и в случае любого NAT, мы сэкономили на публичных адресах.
В случае IPv6 экономить на адресах нужды нет. Но ограничить входящие подключения тоже хочется. От греха подальше. Для этого нужен Egress-Only Internet Gateway. Он работает так же как обычный Internet Gateway, но пропускает только исходящие (egress) соединения.
VPC network
Аналогично работает Elastic Load Balancer (ELB). Его интерфейсы, где он слушает входящий трафик, должны быть расположены в публичной подсети, и иметь реальный IP. Ему главное эти подсети указать, а остальное он сам сделает. А дальше он будет прокидывать запросы на ваши бэкенды уже в приватных подсетях. Только ему нужно, чтобы его интерфейс и интерфейс бэкенда были в одной avaiability zone. Так что одним адресом на всю VPC не отделаетесь. Нужно по адресу и интерфейсу на каждую зону доступности.
Ну а теперь последний, но очень толстый нюанс. Security Groups.
Все эти наши Elastic Network Interface, что EС2 инстансов, что Fargate taskов, что load balancerов, что RDS или ElastiCache, обязательно привязаны к некоей Security Group. А часто даже к нескольким Security Group. Будем говорить, что интерфейс (или сервис) находится в Security Group.
А сами эти Security Group — это такой firewall. Точнее то, что в классических файерволах называют «zone». Некая зона, или группа ресурсов, для которой заданы правила фильтрации входящего и исходящего трафика, а также правила проброса трафика между зонами.
Вот и для Security Group можно задать правила для входящего трафика. С каких IP адресов, на какие порты можно. Из какой другой Security Group можно. Можно задать правила для исходящего трафика. На какие IP адреса, на какие порты можно. На какие другие Security Group можно. Отдельно задаётся, можно ли интерфейсам из одной Security Group ходить к другим интерфейсам в этой же группе, то есть разрешён ли self трафик.
Security Groups
Например, возьмём load balancer. Пусть он живёт в своей Security Group, а балансируемые им сервисы — в другой Security Group.
Load balancerу нужно разрешить входящий трафик отовсюду (из сетей 0.0.0.0/0 и ::/0) на те порты, что он слушает (443 в случае HTTPS). И разрешить исходящий трафик в Security Group балансируемых сервисов, явно указав эту самую их группу. Причём разрешить нужно как порты, куда будет идти балансируемый трафик, так и порты, куда будет делаться health check. В частном случае можно все порты на выход открыть.
А в Security Group, где расположены ваши сервисы, нужно, наоборот, разрешить входящий трафик из Security Group load balancerа, на основные порты, и порты health check. А если этим сервисам нужен доступ к какому-нибудь DynamoDB, или это контейнеры ECS, то им ещё понадобится разрешить исходящий трафик куда угодно (опять 0.0.0.0/0 и ::/0).
Конечно, проще поместить весь ваш маленький кластер, вместе с load balancers и всякими ElastiCache, в одну единственную Security Group. Разрешить в ней self, входящий трафик на пару публичных портов балансера, и исходящий трафик. И всё. Но это тоже нужно не забыть сделать.
Вот такой он сложный, этот VPC. А если учесть, что при старте Fargate контейнеров или Lambda, которым нужен доступ к VPC, выделение Elastic Network Interface занимает где-то минуту, становится ещё и грустно. Но, се ля ви.
ECS on EC2
Кстати, о ECS и Fargate.
ECS. Elastic Container Service. Штука для запуска Докеров в Амазоне. Запущенный там сервис можно связать с load balancer. Лучше с Application Load Balancer, который понимает HTTP(S) и может разруливать трафик, исходя из пути запроса. Ну и терминацией TLS занимается. И вот с момента, когда наш сервис связался с балансером, ELB начитает играть существенную роль в работе ECS.
Во-первых, у нас таки будет нормальная балансировка трафика. Можно запустить несколько экземпляров сервиса (в ECS это называется task), балансер будет обо всех них в курсе, и будет делать честный round-robin запросов на них. Можно даже включить какой-то stickyness.
Во-вторых, балансер будет проверять доступность каждого экземпляра сервиса. Application Load Balancer умеет делать это одним единственным способом. Он посылает HTTP запрос на указанный порт и указанный путь, и ожидает ответ «200 OK» (или любой другой, какой настроите). Если какой-то task не ответил, балансер рапортует об этом ECS, а ECS прибивает задачу (и запускает новую).
Проблемой тут может быть время холодного старта. Те же Spring Boot приложения начинают слушать порт и отвечать на запросы через минуту-другую (зависит от доступного CPU) после запуска. Поэтому в настройках ECS сервиса нужно тщательно указывать параметр «health check grace period». Мол, ненене, на мнение load balancer о здоровье задачи мы начинаем обращать внимание только спустя вот столько секунд.
В-третьих, балансер следит за временем обработки запроса. Если ваш сервис не ответил в течение 60 секунд, пользователь, конечно, получит свои «504 Gateway Timeout». Но балансер снова нажалуется ECS, а тот снова прибьёт провинившуюся задачу.
А если эта задача — единственный экземпляр этого сервиса? Правильно, пользователь будет видеть «503 Service Unavailable» ещё пару минут, пока новая задача не прочухается и не станет видна здоровой балансеру.
Что делать? Можно увеличить этот шестидесятисекундный таймаут по умолчанию. Но зачем? Если бэкенд не отвечает минуту, значит, это какой-то неправильный бэкенд. Надо с этим что-то делать. Подымать несколько задач на сервис, чтобы и нагрузка балансировалась, и умирали не все сразу. Искать узкие места. Думать, как делать тяжёлые операции асинхронными...
Fargate
Fargate. Это новый способ запуска контейнеров в ECS. Совсем недавно был доступен только в Северной Вирджинии, теперь появился в Ирландии и Орегоне точно.
Раньше для запуска контейнеров вы заводили виртуальные машинки EC2. Запускали их из специального образа, где уже есть Docker и ECS агент. Скажем, пару машинок t2.medium, с 2 vCPU и 4 гигами памяти на борту. Запускаете их в разных availability zone, конечно же. (vCPU — это условный попугайский CPU, которым меряется производительность в Амазоне). И вот на этих машинках вы запускаете столько контейнеров, сколько влезет.
В случае Fargate вы запускаете ваши контейнеры незнамо где. Вы просто задаёте для таска ECS требования по памяти и CPU (обязательно оба). И Fargate запустит таску на «железе», соответствующему этим требованиям. Выбор доступного «железа» — не сильно большой. Минимум — 0.25 vCPU и 512 мегабайт памяти.
0.25 vCPU — это сильно мало. Тот же контейнер, когда вы запускали его на EC2, если вы его не ограничивали по CPU, мог воспользоваться всеми 2 vCPU, доступными на этой виртуалке. А с Fargate — только 0.25. На времени запуска Spring Boot это сказывается ооочень драматично. (Ирония ещё в том, что на t2 инстансах EC2 эти 2 vCPU достаются очень дёшево, там на полную катушку можно их юзать лишь где-то 20% времени, что более чем достаточно, чтобы делать быстрые холодные старты, а потом не делать ничего, нагружающего CPU)
512 мегабайт ОЗУ — это сильно много. А «много» — это в облаках значит, что ещё и дорого. Вы что, серьёзно считаете, что каждому экземпляру вашего микросервиса нужно 512 мегабайт памяти? Я, может быть, хочу 1 vCPU и 256 памяти. Но такого нет.
Можно воткнуть в одну задачу/сервис несколько контейнеров. В конце-концов, задачи в ECS — это такие podы Kubernetes. Тогда получится как-то более разумно обойтись с памятью. Но на один сервис в ECS можно натравить только один load balancer. В результате, в одну задачу/сервис вы можете воткнуть лишь один «публичный» контейнер, плюс несколько «приватных» контейнеров. «Приватные» смогут общаться только друг с другом, но не смогут принимать запросы из внешнего мира.
Docker hosts
Далее. В Fargate почему-то сломали то, что всегда работало в Docker. Файл /etc/hosts.
В Docker у каждого контейнера появляется уникальное имя. И это имя является и доменным именем этого контейнера. И это имя прописывается в /etc/hosts и указывает, да хоть бы даже на 127.0.0.1. Это — нормально.
В Fargate нужной записи в /etc/hosts почему-то не появляется. В результате, как минимум в Java, попытки получить адрес локального интерфейса завершаются UnknownHostException. Лечится грязно, но лечится:
CMD echo "127.0.0.1 $HOSTNAME" >> /etc/hosts && exec java ...
Далее. Как контейнеру узнать IP адрес, на котором он запущен? При запуске в EC2 можно было спросить http://169.254.169.254/latest/meta-data/local-ipv4 и получить ответ. В Fargate этот фокус не работает.
Зато работает ECS Task Metadata. Запросив http://169.254.170.2/v2/metadata можно узнать почти всё об этой задаче. Включая набор контейнеров, и IP адрес, на котором они все запущены.
    private fun queryMetadata(): String {
        val query = URL("http://169.254.170.2/v2/metadata")
        log.debug("Querying $query")
        val metadata = query.openConnection().apply { connectTimeout = metadataConnectTimeout }
            .getInputStream().reader()
        val host = parseMetadata(metadata)
        return host
    }

    private fun parseMetadata(input: Reader): String {
        val json: JsonNode? = ObjectMapper().readTree(input)
        return json?.get("Containers")?.get(0)?.get("Networks")?.get(0)?.get("IPv4Addresses")?.get(0)?.asText()
            ?: "unknown"
    }
Fargate
Fargate не выглядит серебряной пулей. Если у вас много мелких контейнеров, да ещё и каждый обслуживает внешние запросы, то кластер на EC2 окажется существенно дешевле. А развернуть несколько EC2 инстансов с Terraform проблемы не составляет. Или вообще на Lambda/Serverless перейти?..