Kuna tofauti gani kati ya ENTRYPOINT na CMD?

Question

Accepted Answer

**ENTRYPOINT** na **CMD** zote mbili zinabainisha nini kinachoendelea wakati kontena inaranza, lakini zina majukumu tofauti na huingiliana kwa njia maalum. Kuelewa tofauti (na maumbo mawili — exec versus shell) ni muhimu kwa kuandika Dockerfiles ambazo zinafanya kazi kwa usahihi.

## CMD — amri chaguo-msingi (inaweza kubadilishwa)

```dockerfile
CMD ["node", "server.js"]
# → the DEFAULT command when the container starts
# → but it's REPLACED if you pass a command at run time:
#   docker run myapp echo hello   → runs "echo hello" INSTEAD of node server.js
```

`CMD` inatoa **amri chaguo-msingi**, ambayo **inabadilishwa kabisa** na amri yoyote iliyotolewa kwenye `docker run`.

## ENTRYPOINT — utendaji uliobadilishwa

```dockerfile
ENTRYPOINT ["node", "server.js"]
# → ALWAYS runs; run-time arguments are APPENDED (not replacing it):
#   docker run myapp --port 8080   → runs "node server.js --port 8080"
# → makes the container behave like a specific executable
```

`ENTRYPOINT` inaiweka **utendaji uliobadilishwa** ambao unafanya kazi kila wakati; hoja za wakati wa uendeshaji **zinaongezwa** kama hoja zake badala ya kuibadilisha.

## Kuziandika pamoja (muundo wa kawaida)

```dockerfile
ENTRYPOINT ["node", "server.js"]   # the fixed command
CMD ["--port", "3000"]              # DEFAULT arguments (overridable)
# docker run myapp                  → node server.js --port 3000 (defaults)
# docker run myapp --port 8080      → node server.js --port 8080 (CMD overridden)
→ ENTRYPOINT = the command; CMD = default arguments you can override. A clean pattern.
```

## Fomu ya exec dhidi ya fomu ya shell

```text
EXEC form  → CMD ["node", "server.js"]  (JSON array) — PREFERRED:
  runs the executable DIRECTLY (PID 1) → receives signals (SIGTERM) → graceful shutdown
SHELL form → CMD node server.js  → runs via /bin/sh -c → the shell is PID 1,
  the app may NOT receive signals properly (shutdown issues) → avoid for the main process
```

## Kwa nini inakusudiwa

Kuelewa tofauti kati ya ENTRYPOINT na CMD ni muhimu kwa **kuandika Dockerfiles ambazo zinafanya kazi kwa usahihi**, kwa hivyo ni ujuzi muhimu wa vitendo na mada inayosababisha utata mara nyingi.

Tofauti katika tabia inakusudiwa: **CMD** inatoa amri chaguo-msingi ambayo **inabadilishwa kabisa** na amri yoyote iliyopitishwa kwenye `docker run`, ilhali **ENTRYPOINT** inaiweka utendaji uliobadilishwa ambao unafanya kazi kila wakati na hoja za wakati wa uendeshaji **zinaongezwa** kwake — tabia tofauti ambayo huathiri jinsi kontena inavyojibu hoja za wakati wa uendeshaji.

Kuelewa **muundo wa kawaida wa kuziandika pamoja** (`ENTRYPOINT` kama amri na `CMD` kama hoja chaguo-msingi inayobadilishwa) ni njia safi, ya kawaida inayofanya kontena zifanye kazi kama utendaji unaoweza kutengeneza — mbinu inayotumika sana ambayo inafaa kujua.

Kwanza kabisa, kuelewa **fomu ya exec dhidi ya fomu ya shell** ni muhimu kwa usahihi: **fomu ya exec** (safu ya JSON, k.m. `CMD ["node", "server.js"]`) inakubaliwa kwa sababu inafanya utendaji **moja kwa moja kama PID 1**, kwa hiyo inakokota maalum kama SIGTERM **kwa usahihi**, kuwezesha **kumaga kwa upole** — ilhali **fomu ya shell** (`CMD node server.js`) inafanya kazi kupitia shell ambayo inakuwa PID 1, mara nyingi mwaliko ambakoanakotokea programu **kutozipokea maalum kumata kwa usahihi** (kusababisha kumata bila upole, kazi inayozaa iliyopotea, au kusimama polepole).

Issue hii ya kumata/kumaga kwa upole ni shida halisi, nyingi ambayo fomu ya exec huepuka.

Kwa kuwa kuelewa nini kinachoendelea wakati kontena inaranza ni kitu kwa msingi kwa kila Dockerfile, na kwa kuwa tofauti ya ENTRYPOINT/CMD (na suala la exec-vs-shell-form kumata) linakathiri tabia na usahihi wa kontena (kumata hoja, kumaga kwa upole), kuelewa ENTRYPOINT dhidi ya CMD — majukumu yao, jinsi yanavyounganisha, na mbinu muhimu ya exec-form-kwa-maalum — ni ujuzi muhimu na wa vitendo wa Docker, mada inayosababisha utata mara nyingi ambapo kuelewa tofauti zinazuia maajabu halisi ya tabia na kumata.