Projenizi Yönetme

Volta, ekiplerin ve işbirlikçilerin projeleri için kullandıkları geliştirme araçlarını standartlaştırmalarına olanak tanır. Bu kılavuz, projelerinizi Volta ile nasıl etkili bir şekilde yöneteceğinizi gösterecektir.

Araç Sürümlerini Sabitleme

Volta'daki en önemli proje yönetimi özelliği, belirli araç sürümlerini projenize sabitleme yeteneğidir:

Node.js Sabitleme

Projenizin hangi Node.js sürümünü kullanacağını belirtmek için:

volta pin node@16.14.2

Bir ana veya alt sürüme de sabitleyebilirsiniz ve Volta en son eşleşen sürümü kullanacaktır:

volta pin node@16

Paket Yöneticilerini Sabitleme

Benzer şekilde, npm ve Yarn sürümlerini de sabitleyebilirsiniz:

volta pin npm@8.5.0
volta pin yarn@1.22.18

Sabitleme Nasıl Çalışır

Bir araç sürümünü sabitlediğinizde, Volta:

1. Projenizin package.json dosyasını bir volta bölümü ile günceller
2. Bu bilgileri sürüm kontrolüne işler
3. Ekibinizdeki herkesin aynı sürümleri kullanmasını sağlar

package.json dosyanızdaki volta bölümü şöyle görünür:

{
  "name": "your-project",
  "version": "1.0.0",
  "volta": {
    "node": "16.14.2",
    "npm": "8.5.0",
    "yarn": "1.22.18"
  }
}

Projeye Özel Araçlar

Volta, projeye özel araç kurulumlarına da saygı duyar:

Yerel Paket İkili Dosyalarını Kullanma

Paketleri projenize yerel olarak kurduğunuzda:

npm install typescript
# veya
yarn add typescript

İkili dosyalarını Volta üzerinden çalıştırabilirsiniz:

volta run tsc
# veya sadece
tsc

Volta, bu araçları çalıştırmak için projenin sabitlenmiş Node.js sürümünü kullanacaktır.

Çalışma Alanları Desteği

Birden fazla projeli monorepo kurulumları için Volta, yapılandırma devralmayı destekler:

Yapılandırmaları Genişletme

Birden fazla projeli bir çalışma alanında, kök package.json dosyasında bir temel yapılandırma ayarlayabilirsiniz:

{
  "volta": {
    "node": "16.14.2",
    "yarn": "1.22.18"
  }
}

Ardından, bireysel proje package.json dosyalarında kök yapılandırmayı genişletin:

{
  "volta": {
    "extends": "../../package.json"
  }
}

Bu, çalışma alanınızdaki tüm projeler arasında tutarlı araç sürümleri sürdürmenize olanak tanır.

Proje Yönetimi için En İyi Uygulamalar

Volta ile projeleri yönetmek için bazı önerilen uygulamalar:

1. Araçlarınızı Her Zaman Sabitleyin

Her proje için Node.js ve paket yöneticisi sürümlerini sabitleyin:

volta pin node
volta pin npm
# veya
volta pin yarn

Bu, tüm ekip üyeleri için tutarlı geliştirme ortamları sağlar.

2. Volta Yapılandırmasını İşleyin

package.json dosyanızdaki volta bölümünü her zaman sürüm kontrolüne işleyin. Volta, yapılandırmayı ekibinizle bu şekilde paylaşır.

3. Araç Gereksinimlerini Belgelendirin

Projenizin README'sinde, araç yönetimi için Volta kullandığınızı belirtin:

## Geliştirme

Bu proje, tutarlı araçlar sağlamak için [Volta](https://volta.sh) kullanır.
Volta'yı kurun ve Node.js ve npm'in doğru sürümleri otomatik olarak kullanılacaktır.

4. CI/CD Entegrasyonu Kullanma

Sürekli entegrasyon ortamlarında, Volta'yı derleme sürecinizin bir parçası olarak kurun:

# GitHub Actions için örnek
- name: Install Volta
  uses: volta-cli/action@v1

# Volta otomatik olarak doğru Node.js ve npm/yarn sürümlerini kullanacaktır
- name: Install dependencies
  run: npm install

5. Projeler Arasında Standartlaştırma

Birden fazla projeye sahip kuruluşlar için, geliştiricilerin kurması gereken sürüm sayısını en aza indirmek için mümkün olduğunda araç sürümlerini standartlaştırın.

Projelerinizi Volta ile etkili bir şekilde yöneterek, tüm ekip üyelerinin tutarlı geliştirme ortamlarına sahip olmasını sağlar, "benim makinemde çalışıyor" sorunlarını azaltır ve işbirliğini daha sorunsuz hale getirirsiniz.