# Add Script to workflow

**GitHub Actions** içerisinde **kendi bash script’lerini** (veya benzer komut dosyalarını) **nasıl çalıştırabileceğin** üzerine odaklanıyor. Normalde “run:” satırlarıyla tek satırlık veya birkaç satırlık komutları çalıştırabiliyorsun; fakat uzun veya karmaşık işlemler için bunları `.sh` gibi script dosyalarında tutmak daha düzenli olur. GitHub Actions, bu script’leri **repo içinde** saklamana ve iş akışı sırasında çağırmana imkan tanır.

```yaml
jobs:
  example-job:
    runs-on: ubuntu-latest
    defaults:
      run:
        working-directory: ./scripts
    steps:
      - name: Check out the repository to the runner
        uses: actions/checkout@v4
      
      - name: Run a script (in ./scripts)
        run: ./my-script.sh

      - name: Run another script (in ./scripts)
        run: ./my-other-script.sh

      - name: Different Working Dir
        run: ls -la
        working-directory: ../

      - name: Run script with direct path
        run: ../other-scripts/some-other.sh
        # Burada "scripts" klasöründen bir üst dizine (../) çıkıp
        # "other-scripts" klasörüne girerek "some-other.sh" dosyasını çalıştırıyoruz.
```

### 1) `runs-on: ubuntu-latest`

* Bu, job’un Ubuntu işletim sisteminde çalışan bir runner üzerinde çalışacağını belirtir.
* Dolayısıyla `.sh` (bash) komut dosyaları varsayılan olarak desteklenir.

### 2) `defaults.run.working-directory: ./scripts`

* `defaults.run` bloğu ile, job içerisindeki tüm `run:` satırlarının **varsayılan çalışma dizinini** (`working-directory`) ayarlıyorsun.
* Burada `./scripts` dendiği için, **repo’nun checkout** edildikten sonraki kök dizininde bulunan “scripts” klasörüne gidiliyor.
* Yani “run: ./my-script.sh” gibi komutlar, `scripts` klasöründen çağrılmış oluyor.

### Sık Karşılaşılan Sorunlar

* **İzinler**: Script’e çalıştırma izni (executable permission) verilmemişse (`chmod +x my-script.sh`), script çalışmaz. Genellikle repo’da commit’lerken yürütme iznini korumak gerekir.
* **Yanlış Path**: “`defaults.run.working-directory`” yoksa, script için tam yolu yazman (`./scripts/my-script.sh`) veya `cd scripts` komutu kullanman gerekir.
* **Shebang**: Script dosyası başında `#!/usr/bin/env bash` gibi bir shebang satırı kullanman önerilir (özellikle farklı shell’lerde tutarlılık için).

### Özet

1. **Checkout** step’iyle repo kodunu indir.
2. `defaults.run.working-directory: ./scripts` diyerek job içindeki tüm komutların “scripts” klasöründe çalışmasını sağla (isteğe bağlı).
3. `run: ./my-script.sh` diyerek script’ini çağır.
4. Script dosyası içinde istediğin karmaşık komutları saklayabilir, bakımını kolaylaştırırsın.

Böylece “**Add Script to Workflow**”, yani GitHub Actions’da `.sh` (veya diğer dillerde) script dosyalarını iş akışında kullanma konusu netleşmiş oluyor.

{% embed url="<https://docs.github.com/en/actions/writing-workflows/choosing-what-your-workflow-does/adding-scripts-to-your-workflow>" %}


---

# 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/add-script-to-workflow.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.