# Exit Codes

**Exit Codes** konusunu anlamak, GitHub Actions içinde aksiyonlarının (veya script’lerinin) **başarılı mı yoksa hatalı mı**bittiğini belirlemeni sağlar. Bash veya benzeri bir script, “exit 0” ile başarıyı (status = success), “exit 1” (veya başka 0 olmayan kod) ile hatayı (status = failure) bildirir. Bu da iş akışının (workflow) sonucunu etkiler.

### 1) Bash Script İçinde `exit_status=$?`

#### Ne Anlama Gelir?

* “`make build`” gibi bir komut çalıştırdıktan hemen sonra `exit_status=$?` yazarak **son komutun çıkış kodunu**(exit code) alırsın.
* Eğer `exit_status` “0” ise komut başarıyla bitmiştir. “0 olmayan” herhangi bir kod bir hata veya özel durum ifade eder.

#### Örnek:

```bash
make build
exit_status=$?

if [ $exit_status -ne 0 ]; then
  echo "::error ::Build failed with exit code $exit_status"
  exit $exit_status
fi

echo "::set-output name=status::success"
exit 0
```

1. **Komut Başarısızsa** (`-ne 0`):
   * `echo "::error ::Build failed..."` yazarak log’da “error” satırı oluşturur.
   * `exit $exit_status` ile script’i hatayla sonlandırır → GitHub Actions job da **fail** olur.
2. **Başarılıysa**:
   * Son satırda `echo "::set-output name=status::success"` → “status” adında bir output parametresi “success” olarak ayarlanır.
   * `exit 0` → Script normal şekilde biter, job da **success** olur.

***

### 2) Docker Entrypoint Örneği

```bash
#!/bin/sh -l

echo "API_KEY=abc123" >> $GITHUB_ENV  # Örnek environment değişken ekleme

./run-tests.sh
if [ $? -ne 0 ]; then
  echo "::error ::Tests failed"
  exit 1
fi

echo "test-result=passed" >> $GITHUB_OUTPUT
echo "Action completed successfully"
exit 0
```

1. **`./run-tests.sh`** → Testleri çalıştırır. Dönüş kodu 0 değilse “error” mesajı yazar, `exit 1` der (yani job fail).
2. Aksi takdirde, “`test-result=passed`” gibi bir output parametresi kaydedilir (`$GITHUB_OUTPUT`’a yazılıyor), `exit 0` ile başarı belirlenir.

***

### 3) İş Akışında Sonuç

* **Eğer Script “exit 0”** dönerse → Action (ve job) **başarılı** (success) sayılır.
* **Eğer Script “exit 1” (veya başka 0 olmayan kod)** dönerse → Action (ve job) **failed** görünür.
* “**::error**” satırları logda özel şekilde vurgulanır, ama esas önemli olan “exit code”’dur.

***

#### Neden Önemli?

1. **CI/CD Aşamalarını Durdurma**
   * Örneğin bir test script’i başarısızsa `exit 1` diyerek job’ı fail durumuna getirirsin; sonraki adımlar (deploy) atlanır.
2. **Debug**
   * Log’da “::error” mesajı yazarak, neyin yanlış gittiğini daha görünür hale getirirsin.
3. **Output Ayarlama**
   * Başarılıysa `echo "::set-output name=<key>::<value>"` (ya da `$GITHUB_OUTPUT`’a yazmak), workflow’un sonraki adımlarına veri aktarmak için kullanılır.

**Özetle**, GitHub Actions, “exit code 0 → success” ve “exit code != 0 → failure” mantığıyla script sonucunu okur. Bu nedenle, bash script’ler veya Docker entrypoint’lerde, yaptığın işlemlerin sonucuna göre `exit <code>` komutunu doğru kullanmak, workflow’un genel sonucunu kontrol etmeni sağlar.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://note.onurbolatoglu.com/github-actions/exit-codes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.