> For the complete documentation index, see [llms.txt](https://note.onurbolatoglu.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://note.onurbolatoglu.com/github-actions/caching-package-and-dependency-files.md).

# Caching Package and Dependency Files

**GitHub Actions Cache**, CI/CD süreçlerinde sıkça indirilen bağımlılıkları veya oluşturulan (build) dosyaları **tekrar kullanarak** iş akışlarını **hızlandırmak** için kullanılır.

### 1) Caching Package & Dependency Files

* **Amacı**: Her yeni workflow çalışmasında (run) tekrar bağımlılık indirmek (npm install, pip install, bundle install vb.) yerine, daha önce indirilmiş paketleri bir **cache**’ten almak ve işleri hızlandırmak.
* **Nasıl Yapılır?**
  * Pek çok resmi “setup” action (örn. `setup-node`, `setup-python`, `setup-ruby`, `setup-java`) **“cache”** özelliği sunar. Örneğin:

    ```yaml
    - uses: ruby/setup-ruby@v1
      with:
        bundler-cache: true
    ```
  * Bu sayede gem’ler (Ruby paketleri) otomatik cache’lenir. Benzer şekilde `setup-node` action’ında `cache: npm` yazabilirsin.
  * Ya da **el ile** `actions/cache@v3` action’ı kullanıp `path` ve `key` belirleyerek kendi paket klasörünü cache’lersin.

#### Kullanım Örneği,

```yaml
name: Simple 2-Job Cache Example
on: [push]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Check out
        uses: actions/checkout@v3

      - name: Cache Build Output
        id: build-cache
        uses: actions/cache@v4
        with:
          path: dist
          key: ${{ runner.os }}-dist
        # 1) "dist" klasörünü "runner.os-dist" anahtarıyla sakla veya geri yükle.
        #    Cache varsa "cache-hit" => "true", yoksa "false" döner.

      - name: Dist is already cached (skip build)
        if: steps.build-cache.outputs.cache-hit == 'true'
        run: echo "dist folder is found in cache, skipping build."
        # 2a) Cache bulunmuşsa, bu adımda sadece bilgi veriyoruz
        #     (burada build komutlarını atlıyoruz).
      
      - name: Build (only if cache not found)
        if: steps.build-cache.outputs.cache-hit != 'true'
        run: |
          echo "No dist cache found. Installing and building..."
          npm install
          npm run build
        # 2b) Cache yoksa (cache-hit != true), dist'i sıfırdan oluşturuyoruz.

  deploy:
    runs-on: ubuntu-latest
    needs: build   # build job’u bitmeden deploy başlamaz
    steps:
      - name: Check out
        uses: actions/checkout@v3

      - name: Restore Build Output
        uses: actions/cache@v4
        with:
          path: dist
          key: ${{ runner.os }}-dist
        # 3) Aynı anahtarla dist klasörü bulunursa, bu job da indirebilir.

      - name: Deploy
        run: echo "Deploying dist folder..."
        # 4) dist klasöründeki dosyaları kullan. 
        #    Build job’da güncel oluşturulduysa cache'e yüklendi, 
        #    şimdi buradan geri yüklenir.
```

#### Nasıl Çalışıyor?

1. **Cache Build Output (Build Job)**
   * “actions/cache\@v4”, `dist` klasörünü `runner.os-dist` adlı bir cache anahtarıyla arar/oluşturur.
   * **Varsa** → “`cache-hit: true`”.
   * **Yoksa** → “`cache-hit: false`”.
2. **Dist is already cached (skip build)**
   * “if: steps.build-cache.outputs.cache-hit == 'true'” → Cache bulunduysa bu step çalışır.
   * Sadece “dist folder is found in cache…” mesajını basar, `npm install` vs. yapmaz.
3. **Build (only if cache not found)**
   * “if: steps.build-cache.outputs.cache-hit != 'true'” → Cache yoksa bu step devreye girer.
   * `npm install` + `npm run build` ile “dist” klasörünü oluşturur.
   * Job sonunda, yeni “dist” klasörü cache sunucusuna kaydedilir.
4. **Restore Build Output (Deploy Job)**
   * “deploy” job, aynı `path: dist` ve `key: runner.os-dist` kullanarak **dist** klasörünü **tekrar** cache sunucusundan yükler.
   * Dolayısıyla “dist” klasörü orada hazır olduğu için “Deploy” adımında kullanabilir.

**Özet**:\
Bu ek step’le beraber, **Build job** içinde de açıkça “cache varsa atla, yoksa build” mantığını görebiliyorsun.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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/caching-package-and-dependency-files.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.