Использование OpenTofu в качестве образа Docker

OpenTofu доступен в виде образов контейнеров OCI и распространяется через общедоступный реестр GitHub Packages.

Версии​

Образы размещены в виде пакетов в организации OpenTofu на GitHub. Список доступных версий см. здесь.

Мультиплатформенные образы доступны с помощью следующих тегов:

• latest: последняя доступная версия OpenTofu,
• Major: конкретная основная версия OpenTofu,
• Major.Minor: конкретная младшая версия OpenTofu,
• Major.Minor.Patch: конкретная версия исправления OpenTofu,

Кроме того, начиная с OpenTofu версии 1.9.1 мы предоставляем следующие минимальные теги для создания пользовательского образа:

• minimal: минимальный образ, содержащий только исполняемый файл OpenTofu в /usr/local/bin/tofu
• Major-minimal: минимальный образ конкретной основной версии OpenTofu,
• Major.Minor-minimal: минимальный образ конкретной младшей версии OpenTofu,
• Major.Minor.Patch-minimal: минимальный образ конкретной версии исправления OpenTofu.

Чтобы загрузить образы для конкретной платформы (amd64, arm, arm64, 386), используйте:

• <Version>-<Platform>: версия OpenTofu для конкретной платформы.
• <Version>-minimal-<Platform>: минимальная версия OpenTofu для конкретной платформы.

Использование​

Чтобы загрузить образ из реестра GitHub Packages:

docker pull ghcr.io/opentofu/opentofu:latest

Чтобы запустить OpenTofu в контейнере Docker:

# Init providers plugins
docker run \
    --workdir=/srv/workspace \
    --mount type=bind,source=.,target=/srv/workspace \
    ghcr.io/opentofu/opentofu:latest \
    init

# Creating plan file
docker run \
    --workdir=/srv/workspace \
    --mount type=bind,source=.,target=/srv/workspace \
    ghcr.io/opentofu/opentofu:latest \
    plan -out=main.plan

# Applying plan file
docker run \
    --workdir=/srv/workspace \
    --mount type=bind,source=.,target=/srv/workspace \
    ghcr.io/opentofu/opentofu:latest \
    apply "/srv/workspace/main.plan"

Создание собственного образа​

Образ OCI, опубликованный OpenTofu, предназначен для использования в качестве базового инструмента командной строки. Если вам нужны дополнительные инструменты в образе или вы хотите создавать службы на основе OpenTofu, необходимо создать собственный образ. Это можно сделать двумя способами:

1. Создать образ на основе минимального образа (ghcr.io/opentofu/opentofu:minimal или аналогичного) и использовать многоэтапную сборку, чтобы скопировать исполняемый файл tofu в свой образ.
2. Использовать автономный сценарий установки, чтобы установить tofu в образ контейнера.

Способ 1: использование многоэтапной сборки​

Если вы хотите использовать Alpine Linux, ваш Dockerfile/Containerfile может выглядеть так:

FROM ghcr.io/opentofu/opentofu:minimal AS tofu

FROM alpine

COPY --from=tofu /usr/local/bin/tofu /usr/local/bin/tofu

# Your other build instructions

Способ 2: использование сценария установки​

Шаг 1: получение сценария установки​

OpenTofu публикует сценарии установки для POSIX/Powershell. С их помощью можно безопасно установить OpenTofu в образ контейнера. Следуйте инструкциям по автономной установке, чтобы получить сценарий установки и поместить его рядом с вашим Dockerfile/Containerfile.

Шаг 2: создание этапа установки​

Затем можно создать этап загрузки в файле Dockerfile/Containerfile. Подробнее о многоэтапных сборках читайте в документации Docker.

FROM alpine:3.20 AS tofu

ADD install-opentofu.sh /install-opentofu.sh
RUN chmod +x /install-opentofu.sh
RUN apk add gpg gpg-agent
RUN ./install-opentofu.sh --install-method standalone --install-path / --symlink-path -

Шаг 3: создание собственного образа​

Теперь можно добавить образ ниже этапа установки и скопировать в него исполняемый файл tofu:

FROM alpine:3.20 AS tofu

ADD install-opentofu.sh /install-opentofu.sh
RUN chmod +x /install-opentofu.sh
RUN apk add gpg gpg-agent
RUN ./install-opentofu.sh --install-method standalone --install-path / --symlink-path -

## This is your stage:
FROM ubuntu
COPY --from=tofu /tofu /usr/local/bin/tofu

# Add your commands here