Hai semuanya, di materi kali ini kita akan membahas tentang Environment Variables pada Docker diantaranya:

  1. What is Environtment Variable
  2. Create Docker Container using Env Variables
  3. Using Env Files for Create Docker Containers

What is Environtment Variable

An environment variable is a dynamic-named value that can affect the way running processes will behave on a computer. They are part of the environment in which a process runs. For example, a running process can query the value of the TEMP environment variable to discover a suitable location to store temporary files, or the HOME or USERPROFILE variable to find the directory structure owned by the user running the process.

Create Docker Container using Env Variables

Untuk menggunakan Environtment Variable. Kita harus check di dokumentasi docker image yang akan kita gunakan apakah menyediakan Environtment Variable atau tidak. Misalnya sebagai contoh kita lihat ke dokumentasi docker image postgres. Di dokumentasi tersebut kita di sediakan beberapa variable contohnya POSTGRES_PASSWORD, POSTGRES_USER, POSTGRES_DB dan lain-lain.

Nah untuk cara menggunakannya. Kita bisa menggunakan perintah berikut untuk membuat containernya:

For Bash Script:

For Powershell Script:

Jika di jalankan maka hasilnya seperti berikut:

  docker container run `
--name postgres_env `
-e POSTGRES_USER=root `
-e POSTGRES_DB=example_db `
-e POSTGRES_PASSWORD=password `
-d `
postgres:12.6
a2a1dad25d91c8ed594b47a532c21aeecbe4bca00e3f4a4cc9aea29eee6a04fb

  docker container ls
CONTAINER ID   IMAGE           COMMAND                  CREATED          STATUS          PORTS      NAMES
a2a1dad25d91   postgres:12.6   "docker-entrypoint.s…"   14 seconds ago   Up 13 seconds   5432/tcp   postgres_env

  docker container inspect postgres_env
[ "POSTGRES_USER=root",
  "POSTGRES_DB=example_db",
  "POSTGRES_PASSWORD=password",
  "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/lib/postgresql/12/bin",
  "GOSU_VERSION=1.12",
  "LANG=en_US.utf8",
  "PG_MAJOR=12",
  "PG_VERSION=12.6-1.pgdg100+1",
  "PGDATA=/var/lib/postgresql/data"
]

 04g-env   docker exec -it postgres_env psql -U root example_db -W
Password: #input password then enter, that will login to postgres db

psql (12.6 (Debian 12.6-1.pgdg100+1))
Type "help" for help.

example_db=# \l
                              List of databases
    Name    | Owner | Encoding |  Collate   |   Ctype    | Access privileges
------------+-------+----------+------------+------------+-------------------
 example_db | root  | UTF8     | en_US.utf8 | en_US.utf8 |
 postgres   | root  | UTF8     | en_US.utf8 | en_US.utf8 |
 template0  | root  | UTF8     | en_US.utf8 | en_US.utf8 | =c/root          +
            |       |          |            |            | root=CTc/root
 template1  | root  | UTF8     | en_US.utf8 | en_US.utf8 | =c/root          +
            |       |          |            |            | root=CTc/root
(4 rows)

example_db=#

Jadi dengan Env Variable, tersebut kita meng-override variable default yang ada pada docker image tersebut

Using Env Files for Create Docker Containers

Selain menggunakan parameter arguments -e atau --env kita juga menyimpanya dengan menggunakan file, Orang-orang sering mengebutunya Env-File dengan menggunakan format VAR=VALUE. Berikut adalah basic rules untuk menulis file env:

  1. Nama file, biasanya menggunakan .env, .env.prod, .env.dev dan lain-lain.
  2. Lines beginning with # are processed as comments and ignored.
  3. Blank lines are ignored.
  4. There is no special handling of quotation marks. This means that they are part of the VAL.

Berikut adalah contohnya, berdasarkan container yang telah kita buat sebelumnya:

Kemudian untuk menjalankan containernya, kita bisa menggunakan perintah berikut:

Jika di jalankan maka hasilnya seperti berikut:

 04g-env  ls
    Directory: C:\Users\dimasm93\Workspaces\Example\docker\04-docker-cli\04g-env
Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a----         5/18/2021   8:17 PM             75 .env

 04g-env  cat .env
POSTGRES_PASSWORD=password
POSTGRES_USER=root
POSTGRES_DB=example_db

 04g-env  docker run --name postgres_envfile --env-file .env -d postgres:12.6
c3a464b6722a9cab79abf1ceff5fe2ed7d35c9b527fc8319f50202899aa7cdd0

 04g-env  docker container inspect postgres_envfile
[
    "POSTGRES_PASSWORD=password",
    "POSTGRES_USER=root",
    "POSTGRES_DB=example_db",
    "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/lib/postgresql/12/bin",
    "GOSU_VERSION=1.12",
    "LANG=en_US.utf8",
    "PG_MAJOR=12",
    "PG_VERSION=12.6-1.pgdg100+1",
    "PGDATA=/var/lib/postgresql/data"
]

Jadi kesimpulanya, Dengan menggunakan Environtment Variable. Kita bisa meng-override nilai default-nya kemudian di digunakan untuk tujuan tertentu.