Ansibleを使用してUbuntu20.04にDockerをインストールおよびセットアップする方法

投稿日: 2022-07-24 2022-10-18
タグ: Ansible, Automated Setups, Configuration Management, Docker, Ubuntu 20.04

序章

最新のアプリケーション環境は使い捨てであるため、サーバーの自動化はシステム管理において重要な役割を果たしています。構成管理ツール（ Ansible など）は通常、新しいサーバーの標準手順を確立することでサーバーセットアップを自動化するプロセスを合理化すると同時に、手動セットアップに関連する人的エラーを削減するために使用されます。

Ansibleは、ノードに特別なソフトウェアをインストールする必要のないシンプルなアーキテクチャを提供します。また、自動化スクリプトの作成を容易にする堅牢な機能セットと組み込みモジュールも提供します。

このガイドでは、Ansibleを使用して、 Ubuntu20.04にDockerをインストールして使用する方法に関するガイドに含まれている手順を自動化する方法について説明します。 Docker は、 container の管理プロセスを簡素化するアプリケーションです。これは、仮想マシンと同じように動作するが、よりポータブルで、よりリソースに優しく、依存するリソース分離プロセスです。ホストオペレーティングシステムにより多くの負荷がかかります。

前提条件

このガイドのプレイブックで提供されている自動セットアップを実行するには、次のものが必要です。

1つのAnsibleコントロールノード：SSHキーを使用してAnsibleホストに接続するようにAnsibleがインストールおよび構成されたUbuntu20.04マシン。サーバーの初期設定ガイドで説明されているように、コントロールノードにsudo権限とファイアウォールが有効になっている通常のユーザーがいることを確認してください。 Ansibleをセットアップするには、 Ubuntu20.04にAnsibleをインストールして構成する方法に関するガイドに従ってください。
1つ以上のAnsibleホスト：Ubuntu20.04でAnsibleを使用して初期サーバーセットアップを自動化する方法のガイドに従って以前にセットアップされた1つ以上のリモートUbuntu20.04サーバー。

先に進む前に、まず、AnsibleコントロールノードがAnsibleホストに接続してコマンドを実行できることを確認する必要があります。接続テストについては、 Ubuntu20.04にAnsibleをインストールして構成する方法のステップ3を確認してください。

このハンドブックは何をしますか？

このAnsibleプレイブックは、 Ubuntu20.04にDockerをインストールして使用する方法に関するガイドで概説されている手順を手動で実行する代わりの方法を提供します。プレイブックを一度設定し、その後のすべてのインストールに使用します。

このプレイブックを実行すると、Ansibleホストで次のアクションが実行されます。

インストール aptitude、Ansibleが代替として好む apt パッケージマネージャー。
必要なシステムパッケージをインストールします。
DockerGPGAPTキーをインストールします。
公式のDockerリポジトリをに追加します apt ソース。
Dockerをインストールします。
を介してPythonDockerモジュールをインストールします pip.
で指定されたデフォルトの画像をプルします default_container_image DockerHubから。
によって定義されたコンテナの数を作成します container_count 変数、それぞれがによって定義された画像を使用します default_container_image、で定義されたコマンドを実行します default_container_command それぞれの新しいコンテナで。

プレイブックの実行が完了すると、構成変数内で定義したオプションに基づいて多数のコンテナーが作成されます。

開始するには、ログインします sudo Ansibleコントロールノードサーバーで有効になっているユーザー。

ステップ1—プレイブックの準備

The playbook.yml ファイルは、すべてのタスクが定義されている場所です。タスクは、Ansibleプレイブックを使用して自動化できるアクションの最小単位です。ただし、最初に、好みのテキストエディタを使用してプレイブックファイルを作成します。

nano playbook.yml

これにより、空のYAMLファイルが開きます。プレイブックにタスクを追加する前に、以下を追加することから始めます。

playbook.yml

---
- hosts: all
  become: true
  vars:
    container_count: 4
    default_container_name: docker
    default_container_image: ubuntu
    default_container_command: sleep 1

あなたが出くわすほとんどすべてのプレイブックは、これに似た宣言で始まります。 hosts Ansibleコントロールノードがこのプレイブックでターゲットとするサーバーを宣言します。 become すべてのコマンドがエスカレートされたroot特権で実行されるかどうかを示します。

vars データを変数に格納できます。将来これらを変更する場合は、ファイル内のこれらの1行を編集するだけで済みます。各変数の簡単な説明は次のとおりです。

container_count：作成するコンテナの数。
default_container_name：デフォルトのコンテナ名。
default_container_image：コンテナの作成時に使用されるデフォルトのDockerイメージ。
default_container_command：新しいコンテナで実行するデフォルトのコマンド。

注：プレイブックファイルを最終的な完成状態で表示する場合は、ステップ5にジャンプします。 YAMLファイルはインデント構造に特化している可能性があるため、すべてのタスクを追加したら、プレイブックを再確認することをお勧めします。

ステップ2—Playbookへのパッケージインストールタスクの追加

デフォルトでは、タスクはプレイブックの上から下に順番にAnsibleによって同期的に実行されます。これは、タスクの順序が重要であることを意味し、次のタスクが開始する前に1つのタスクの実行が終了すると安全に想定できます。

このプレイブックのすべてのタスクはスタンドアロンで、他のプレイブックで再利用できます。

インストールの最初のタスクを追加します aptitude、Linuxパッケージマネージャーとのインターフェースを取り、必要なシステムパッケージをインストールするためのツール。 Ansibleは、これらのパッケージが常にサーバーにインストールされるようにします。

playbook.yml

  tasks:
    - name: Install aptitude
      apt:
        name: aptitude
        state: latest
        update_cache: true

    - name: Install required system packages
      apt:
        pkg:
          - apt-transport-https
          - ca-certificates
          - curl
          - software-properties-common
          - python3-pip
          - virtualenv
          - python3-setuptools
        state: latest
        update_cache: true

ここでは、 apt Ansibleにパッケージをインストールするように指示する組み込みのモジュール。 Ansibleのモジュールは、生のbashコマンドとして実行する必要がある操作を実行するためのショートカットです。 Ansibleは安全にフォールバックします apt パッケージをインストールする場合 aptitude 利用できませんが、Ansibleは歴史的に好まれてきました aptitude.

好みに応じてパッケージを追加または削除できます。これにより、すべてのパッケージが存在するだけでなく、最新バージョンであり、更新後に実行されます。 apt と呼ばれます。

ステップ3—DockerインストールタスクをPlaybookに追加する

タスクは、公式リポジトリから最新バージョンのDockerをインストールします。ダウンロードを確認するためにDockerGPGキーが追加され、公式リポジトリが新しいパッケージソースとして追加され、Dockerがインストールされます。さらに、Python用のDockerモジュールもインストールされます。

playbook.yml

    - name: Add Docker GPG apt Key
      apt_key:
        url: https://download.docker.com/linux/ubuntu/gpg
        state: present

    - name: Add Docker Repository
      apt_repository:
        repo: deb https://download.docker.com/linux/ubuntu focal stable
        state: present

    - name: Update apt and install docker-ce
      apt:
        name: docker-ce
        state: latest
        update_cache: true

    - name: Install Docker Module for Python
      pip:
        name: docker

あなたはそれを見るでしょう apt_key と apt_repository 組み込みのAnsibleモジュールは、最初に正しいURLをポイントし、次にそれらが存在することを確認するタスクを実行します。これにより、Dockerの最新バージョンをインストールできます。 pip Python用のモジュールをインストールします。

ステップ4—Dockerイメージとコンテナータスクをプレイブックに追加する

Dockerコンテナーの実際の作成は、ここから目的のDockerイメージをプルすることから始まります。デフォルトでは、これらの画像は公式の DockerHubから取得されます。この画像を使用して、プレイブックの上部で宣言された変数によってレイアウトされた仕様に従ってコンテナが作成されます。

playbook.yml

    - name: Pull default Docker image
      community.docker.docker_image:
        name: "{{ default_container_image }}"
        source: pull

    - name: Create default containers
      community.docker.docker_container:
        name: "{{ default_container_name }}{{ item }}"
        image: "{{ default_container_image }}"
        command: "{{ default_container_command }}"
        state: present
      with_sequence: count={{ container_count }}

docker_image コンテナのベースとして使用するDockerイメージをプルするために使用されます。 docker_container 作成するコンテナの詳細と、それらに渡すコマンドを指定できます。

with_sequence はループを作成するAnsibleの方法であり、この場合、指定したカウントに従ってコンテナーの作成をループします。これは基本的なカウントループなので、 item ここでの変数は、現在のループ反復を表す数値を提供します。この番号は、ここでコンテナに名前を付けるために使用されます。

ステップ5—完全なプレイブックを確認する

プレイブックはおおよそ次のようになりますが、カスタマイズによって若干の違いがあります。

playbook.yml

---
- hosts: all
  become: true
  vars:
    container_count: 4
    default_container_name: docker
    default_container_image: ubuntu
    default_container_command: sleep 1d

  tasks:
    - name: Install aptitude
      apt:
        name: aptitude
        state: latest
        update_cache: true

    - name: Install required system packages
      apt:
        pkg:
          - apt-transport-https
          - ca-certificates
          - curl
          - software-properties-common
          - python3-pip
          - virtualenv
          - python3-setuptools
        state: latest
        update_cache: true

    - name: Add Docker GPG apt Key
      apt_key:
        url: https://download.docker.com/linux/ubuntu/gpg
        state: present

    - name: Add Docker Repository
      apt_repository:
        repo: deb https://download.docker.com/linux/ubuntu focal stable
        state: present

    - name: Update apt and install docker-ce
      apt:
        name: docker-ce
        state: latest
        update_cache: true

    - name: Install Docker Module for Python
      pip:
        name: docker

    - name: Pull default Docker image
      community.docker.docker_image:
        name: "{{ default_container_image }}"
        source: pull

    - name: Create default containers
      community.docker.docker_container:
        name: "{{ default_container_name }}{{ item }}"
        image: "{{ default_container_image }}"
        command: "{{ default_container_command }}"
        state: present
      with_sequence: count={{ container_count }}

独自のワークフロー内で個々のニーズに最も合うように、このプレイブックを自由に変更してください。たとえば、 docker_imageモジュールを使用してイメージをDockerHubにプッシュしたり、docker_containerモジュールを使用してコンテナーネットワークをセットアップしたりできます。

注：これは、くぼみに注意するための穏やかなリマインダーです。エラーが発生した場合は、これが原因である可能性が非常に高くなります。 YAMLは、この例で行われたように、インデントとして2つのスペースを使用することを提案します。

プレイブックに満足したら、テキストエディタを終了して保存できます。

ステップ6—Playbookを実行する

これで、このプレイブックを1つ以上のサーバーで実行する準備が整いました。ほとんどのプレイブックは、デフォルトでインベントリ内のすべてのサーバーで実行されるように構成されていますが、今回はサーバーを指定します。

プレイブックを実行するには server1、として接続 sammy、次のコマンドを使用できます。

ansible-playbook playbook.yml -l server1 -u sammy

The -l フラグはサーバーと -u flagは、リモートサーバーにログインするユーザーを指定します。次のような出力が得られます。

Output. . .
changed: [server1]

TASK [Create default containers] *****************************************************************************************************************
changed: [server1] => (item=1)
changed: [server1] => (item=2)
changed: [server1] => (item=3)
changed: [server1] => (item=4)

PLAY RECAP ***************************************************************************************************************************************
server1                  : ok=9    changed=8    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

注：Ansibleプレイブックの実行方法の詳細については、Ansibleチートシートガイドを確認してください。

これは、サーバーのセットアップが完了したことを示しています。出力は完全に同じである必要はありませんが、障害がゼロであることが重要です。

プレイブックの実行が終了したら、SSH経由でAnsibleによってプロビジョニングされたサーバーにログインして、コンテナーが正常に作成されたかどうかを確認します。

次のコマンドでリモートサーバーにログインします。

ssh sammy@your_remote_server_ip

そして、リモートサーバー上のDockerコンテナを一覧表示します。

sudo docker ps -a

次のような出力が表示されます。

OutputCONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
a3fe9bfb89cf        ubuntu              "sleep 1d"          5 minutes ago       Created                                 docker4
8799c16cde1e        ubuntu              "sleep 1d"          5 minutes ago       Created                                 docker3
ad0c2123b183        ubuntu              "sleep 1d"          5 minutes ago       Created                                 docker2
b9350916ffd8        ubuntu              "sleep 1d"          5 minutes ago       Created                                 docker1

これは、プレイブックで定義されたコンテナが正常に作成されたことを意味します。これはプレイブックの最後のタスクであったため、このサーバーでプレイブックが完全に実行されたことも確認します。

結論

インフラストラクチャのセットアップを自動化すると、時間を節約できるだけでなく、サーバーがニーズに合わせてカスタマイズできる標準構成に従うようにするのにも役立ちます。最新のアプリケーションの分散性と異なるステージング環境間の一貫性の必要性により、このような自動化は多くのチームの開発プロセスの中心的なコンポーネントになっています。

このガイドでは、Ansibleを使用して、リモートサーバーにDockerをインストールしてセットアップするプロセスを自動化する方法を示しました。通常、コンテナを操作する際のニーズは個人ごとに異なるため、公式のAnsibleドキュメントで詳細とユースケースを確認することをお勧めします。 docker_container Ansibleモジュール。

サーバーの初期設定をさらにカスタマイズするためにこのプレイブックに他のタスクを含めたい場合は、Ansibleの紹介ガイド構成管理101：Ansibleプレイブックの作成を参照してください。

getdocs

13036