Provision
—— XP

Практика: сервисный аккаунт и бакет

практика~30 минут+575 XP

В этой практике ты сделаешь робота с узкими правами и дашь ему место для файлов. Этот же сервисный аккаунт понадобится в разделе про Terraform, а в такой же бакет там ляжет файл состояния.

Машина из прошлой практики здесь не нужна. Если она ещё работает, пусть дождётся урока про уборку: удалять всё будем одним заходом. Если облако её уже остановило, ничего страшного, в уборке её всё равно удалим.

Шаг 1. Сервисный аккаунт

Сервисный аккаунт — учётная запись для программы. Сразу при создании дадим ему одну роль.

  1. В консоли открой сервис Identity and Access Management: набери «IAM» в поиске.
  2. Нажми «Создать сервисный аккаунт».
  3. Имя — provision-sa.
  4. Нажми «Добавить роль» и выбери storage.editor.
  5. Нажми «Создать».

Роль выдаётся на текущий каталог provision, и больше ни к чему у робота доступа нет.

Шаг 2. Проверить из терминала

Убедимся, что аккаунт и роль видны через yc.

ubuntu@stand:~$
yc iam service-account list
ubuntu@stand:~$
+----------------------+--------------+--------+
|          ID          |     NAME     | LABELS |
+----------------------+--------------+--------+
| ajeq3n…              | provision-sa |        |
+----------------------+--------------+--------+

Теперь роли, выданные на каталог.

ubuntu@stand:~$
yc resource-manager folder list-access-bindings provision
ubuntu@stand:~$
+----------------+----------------+----------------------+
|    ROLE ID     |  SUBJECT TYPE  |      SUBJECT ID      |
+----------------+----------------+----------------------+
| storage.editor | serviceAccount | ajeq3n…              |
+----------------+----------------+----------------------+

ROLE ID — какая роль, SUBJECT TYPE — кому: сервисному аккаунту, а не пользователю. SUBJECT ID совпадает с идентификатором из прошлой таблицы. Если тут editor, а не storage.editor, роль выбрана слишком широкая: удали её и добавь нужную.

Шаг 3. Место для секретов

Статический ключ — это пароль. Заведём для него каталог, который не попадёт ни в какой репозиторий.

ubuntu@stand:~$
mkdir -p ~/devops-lab/secrets

Флаг -p создаёт и промежуточные каталоги и молчит, если каталог уже есть.

Шаг 4. Статический ключ

  1. В IAM открой provision-sa.
  2. Нажми «Создать новый ключ», затем «Создать статический ключ доступа».
  3. Описание — s3 для курса. Нажми «Создать».
  4. Облако покажет идентификатор ключа и секретный ключ. Секрет показывается один раз.

Сразу скопируй обе строки в файл.

nano ~/devops-lab/secrets/provision-sa-s3.txt
key_id: YCAJE…
secret: YCN2…

Шаг 5. Закрыть файл

Файл с ключом должен читать только ты, как закрытый SSH-ключ.

ubuntu@stand:~$
chmod 600 ~/devops-lab/secrets/provision-sa-s3.txt
ubuntu@stand:~$
ls -l ~/devops-lab/secrets
ubuntu@stand:~$
-rw------- 1 anton anton 72 Oct  1 12:30 provision-sa-s3.txt

-rw------- — читать и писать может только владелец, остальным нельзя ничего. Это права из раздела про Linux: 600 в восьмеричной записи.

Шаг 6. Бакет

Бакет — корзина для файлов. Имя уникально на всё облако, поэтому добавь к нему свой ник.

  1. Открой сервис Object Storage и нажми «Создать бакет».
  2. Имя — provision- и твой ник, например provision-anton.
  3. Доступ на чтение объектов — «Ограниченный».
  4. Максимальный размер — 1 ГБ: случайно забить его не выйдет.
  5. Нажми «Создать бакет».

Запиши имя бакета в файл — его прочитает команда сдачи.

ubuntu@stand:~$
echo provision-anton > ~/devops-lab/cloud-bucket

Шаг 7. Бакет из терминала

Проверим, что бакет виден и через утилиту, и посмотрим на его настройки.

ubuntu@stand:~$
yc storage bucket list
ubuntu@stand:~$
+-----------------+----------------------+------------+-----------------------+
|      NAME       |      FOLDER ID       |  MAX SIZE  | DEFAULT STORAGE CLASS |
+-----------------+----------------------+------------+-----------------------+
| provision-anton | b1g4p7…              | 1073741824 | STANDARD              |
+-----------------+----------------------+------------+-----------------------+

MAX SIZE в байтах — это тот самый 1 ГБ. STANDARD — класс хранения для файлов, которые читают часто; бывает ещё холодный, дешевле для архивов.

Шаг 8. Загрузить файл кнопкой

  1. Открой бакет и нажми «Загрузить объекты».
  2. Выбери любой небольшой файл, например текстовый.
  3. Нажми «Загрузить».

Файл появится в списке объектов бакета с размером и датой.

Шаг 9. Загрузить файл командой

То же самое из терминала. Сначала сделаем файл.

ubuntu@stand:~$
echo "первый отчёт из терминала" > report.txt
ubuntu@stand:~$
yc storage s3 cp report.txt s3://provision-anton/report.txt
ubuntu@stand:~$
upload: report.txt to s3://provision-anton/report.txt

Адрес s3://бакет/путь — так обращаются к объекту все S3-программы. Вместо provision-anton — твоё имя бакета.

Шаг 10. Список объектов

Теперь посмотрим, что лежит в бакете, не открывая консоль.

ubuntu@stand:~$
yc storage s3api list-objects --bucket provision-anton
ubuntu@stand:~$
contents:
  - key: report.txt
    size: "47"
    storage_class: STANDARD
name: provision-anton

Флаг --bucket называет бакет. key — путь объекта внутри бакета, size — размер в байтах. Файл из шага 8 будет здесь же отдельной записью.

Шаг 11. Снаружи закрыто

Проверим, что без ключа файл не скачать. Начало адреса снова положим в переменную.

ubuntu@stand:~$
B=https://storage.yandexcloud.net/provision-anton
ubuntu@stand:~$
curl -I $B/report.txt
ubuntu@stand:~$
HTTP/1.1 403 Forbidden

403 Forbidden — хранилище отказало: доступ ограниченный, а ключа в запросе нет. Ровно так и должно быть. Если пришёл 200 OK, бакет открыт всему интернету — верни ограниченный доступ в настройках.

Шаг 12. Тот же файл ключом робота

Пока что файл загружал ты сам: yc ходит в облако под твоей учётной записью. Теперь проверим, что статический ключ робота работает. Положим его в переменные окружения с теми именами, которые понимают все S3-программы. Значения скопируй из файла с ключом. Пробел в начале строки — не опечатка: в Ubuntu команда, начатая с пробела, не попадает в историю шелла.

ubuntu@stand:~$
 export AWS_ACCESS_KEY_ID=YCAJE…
 export AWS_SECRET_ACCESS_KEY=YCN2…

export делает переменную видимой для программ, запущенных из этого терминала. Подпись запроса умеет ставить сам curl флагом --aws-sigv4; строку с регионом положим в переменную.

ubuntu@stand:~$
A=aws:amz:ru-central1:s3
ubuntu@stand:~$
U=$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY
ubuntu@stand:~$
curl --aws-sigv4 $A -u $U $B/report.txt
ubuntu@stand:~$
первый отчёт из терминала

--aws-sigv4 подписывает запрос ключом по правилам S3, -u передаёт идентификатор и секрет через двоеточие. Тот же адрес, что час назад дал 403, теперь отдал файл: пускает именно ключ робота с ролью storage.editor. Ошибка в одной букве секрета снова даст 403 Forbidden. В разделе про Terraform этим же ключом из переменных окружения Terraform будет писать в бакет файл состояния.

Сдай задание командой из блока проверки в этом же терминале: ей нужны переменные с ключом.

Что дальше

Сервисный аккаунт, ключ и бакет готовы. Дальше — самый важный навык облака: удалить всё, что создал, и убедиться, что деньги больше не идут.

Практика 03+575 XP

Выдавать программам права по правилу минимума, хранить их ключи как пароли и работать с хранилищем файлов из консоли и из терминала.

  • Сервисный аккаунт создан
  • У аккаунта роль хранилища
  • Лишних прав нет
  • Файл загружен командой
  • Ключ хранится как пароль
  • Ключ робота работает
Команда сдачи — выполни на своей машине
команда
yc iam service-account list; yc resource-manager folder list-access-bindings provision; echo ---; yc storage s3api list-objects --bucket $(cat ~/devops-lab/cloud-bucket); echo ---; ls -l ~/devops-lab/secrets; curl -s -o /dev/null -w 'ROBOT=%{http_code}\n' --aws-sigv4 aws:amz:ru-central1:s3 -u "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" https://storage.yandexcloud.net/$(cat ~/devops-lab/cloud-bucket)/report.txt

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.