Bu makale, Nodejs ve Heroku kullanarak API deployment sürecini anlatır Bu adımlar arasında Heroku hesap oluşturma, Heroku CLI kurma, proje dosyası oluşturma, API yaratma, API test etme ve son olarak API deployment işlemi yer alır Nodejs, server-side JavaScript çalıştırmak için kullanılan bir platformdur ve olay tabanlı programlama desteği sayesinde sunucu işlemleri için ideal bir araçtır Heroku ise uygulamaların kolaylıkla bulut tabanlı bir platformda oluşturulmasını ve dağıtılmasını sağlar Heroku CLI, Heroku'ya bağlanmak ve uygulama oluşturmak / yönetmek için kullanılabilecek bir araçtır Proje dosyasının oluşturulması için, terminalde npx express-generator komutu kullanılır ve bağımlılıklar npm install komutu ile yüklenir
Bu makalede Node.js ve Heroku kullanarak API deployment işlemi adım adım anlatılacak. Bu süreç, mevcut bir Node.js projesini Heroku'ya deploy etmek için birkaç adımdan oluşmaktadır. Bu adımlar arasında Heroku hesabı oluşturma, Heroku CLI kurma, proje dosyası oluşturma, API yaratma, API test etme ve son olarak API deployment işlemi yer almaktadır. Her adım, detaylı bir şekilde açıklanacak ve uygulama için gerekli HTML tag'leri kullanılacak.
Node.js Nedir?
Node.js Nedir?
Node.js, günümüz web uygulamaları için önemli bir araç haline gelmiştir. JavaScript temelli olarak geliştirilen Node.js, server-side JavaScript çalıştırmak için kullanılmaktadır. Bu sayede sunucu tarafında JavaScript kullanımı mümkün hale gelmiştir. Node.js, Google Chrome’un kullanmakta olduğu V8 JavaScript motoru üzerine geliştirilmiş bir çalışma zamanı ortamıdır. Sunucu tarafında çalıştığı için, çeşitli sunucu işlemleri için ideal bir araçtır.
Bunun yanı sıra, Node.js'in avantajlarından biri de olay tabanlı programlama desteğidir. Bu sayede, çok sayıda bağlantı yönetimi gerektiren uygulamalar için ideal bir çözüm sunmaktadır.
Heroku Nedir?
Heroku Nedir?
Heroku, uygulamaların kolaylıkla bulut tabanlı bir platformda oluşturulmasını ve dağıtılmasını mümkün kılan bir Platform as a Service (PaaS) sağlayıcısıdır. Bu sayede, geliştiriciler uygulamalarını sunucuları yönetmek veya kurulum yapmak gibi birçok ayrıntıyla uğraşmadan hızlıca yayınlayabilirler.
Heroku, yoğun trafiklerde bile performanslı bir hizmet sunar ve sunucuların aynı anda hizmet kalitesinde düşüş yaşamamasını garanti eder. Aynı zamanda, kullanım dışı olduğunda bile uygulamaların maliyetlerini düşürmeye olanak tanır.
Heroku, Java, Ruby, Node.js ve Python gibi birçok dil ve framework'ü destekler. Bu nedenle, geliştiriciler kendilerine en uygun olanı seçerek uygulama geliştirmeye başlayabilirler.
Heroku, kolay kullanımı ve güçlü özellikleri sayesinde birçok geliştiricinin tercih ettiği bir platformdur. Ayrıca, öğrenmesi kolaydır ve yeni başlayanlar için iyi bir seçenektir.
Heroku Üzerinde Hesap Oluşturma
Heroku'u kullanarak uygulamalarınızı yayınlamadan önce, platformda bir hesap oluşturmanız gerekiyor. Bu işlem oldukça basittir ve sadece birkaç dakikanızı alacaktır.
Heroku web sitesine gidin ve "Sign up for free" (ücretsiz kaydolun) seçeneğine tıklayın. Burada, adınızı, e-postanızı ve şifrenizi girerek kaydolabilirsiniz.
Kayıt işleminden sonra, Heroku, e-posta adresinize doğrulama bağlantısı gönderecektir. Doğrulama işlemini tamamladıktan sonra, platformu kullanmaya başlayabilirsiniz.
Bir sonraki adım, Heroku üzerinde bir uygulama oluşturmak ve API'nizi bu uygulamaya dahil etmektir. Bu adımı tamamlamak için, Heroku arayüzünde "Create new app" (yeni uygulama oluştur) seçeneğine tıklayın. Uygulama adınızı girin ve dünya çapındaki sunucuları kullanarak değiştirebilirsiniz.
Bir uygulama oluşturduktan sonra, API'nizi yayınlamak için hazırsınız demektir. Ancak, önce API dosyalarınızı Heroku'ya yüklemeniz gerekecektir. Bu işlemi gerçekleştirmek için, Heroku CLI'yı yükleyin ve API dosyalarınızı projenize yerleştirin.
Heroku üzerinde hesap oluşturma işlemi oldukça basittir ve başarılı bir şekilde tamamlandıktan sonra, API'nizi platformda yayınlamaya hazır hale getirmiş olursunuz.
Heroku CLI Kurulumu
Heroku CLI (Command Line Interface), Heroku’ya bağlanmak ve komut satırı aracılığıyla uygulama oluşturmak / yönetmek için kullanılabilir. Yükleme işlemi bölgesel olarak farklılık gösterebilir, ancak genel olarak şu adımlar takip edilir:
- Heroku CLI sayfasından uyumlu sürüm indirilir.
- Yükleme işlemini başlatmak için dosyaya çift tıklanır.
- Kurulum sırasında bilgisayarın yöneticisi olarak doğrulama yapılması istenebilir.
- Yükleme tamamlandıktan sonra terminal açılarak, 'heroku' komutu çalıştırılır ve kurulumun başarılı olup olmadığı kontrol edilir.
Heroku CLI kurulumunu başarıyla tamamladıktan sonra, 'heroku login' komutunu kullanarak Heroku hesabınıza giriş yapabilirsiniz. Bu komut, tarayıcınızda giriş yapmanızı sağlayacak bir bağlantı oluşturur. Hesabınıza giriş yaptıktan sonra, uygulamalarınızı Heroku üzerinde oluşturabilir, yönetebilir ve deploy edebilirsiniz.
Proje Dosyasının Oluşturulması
API deployment işlemi yapmak için ilk olarak Node.js kullanılarak bir proje oluşturmak gerekiyor. Proje oluşturma işlemi, bir terminalde yapılır. İşletim sistemine göre terminal açmak için farklı yöntemler kullanılabilir.
Terminal açıldıktan sonra, proje dosyasının oluşturulacağı dizine gidilir. Dizin değiştirmek için "cd" komutu kullanılır. Örneğin, proje dosyasının oluşturulacağı dizin "Desktop" klasörü ise, aşağıdaki komut kullanılarak o dizine gidilir:
- cd Desktop
Dizin değiştirildikten sonra, "npx express-generator" komutu kullanılarak Node.js projesi oluşturulur. Bu komut, Express framework'ü ile birlikte bir template proje oluşturur:
- npx express-generator my-project
Bu komut, "my-project" isimli bir proje dosyası oluşturur. "my-project" yerine, başka bir isim de kullanılabilir.
Proje dosyası oluşturulduktan sonra, projenin içine girilerek "npm install" komutu kullanılarak projenin bağımlılıkları yüklenir:
- cd my-project
- npm install
Bu işlem tamamlandıktan sonra, proje hazır hale gelmiş olacaktır. Proje dosyası içinde "app.js" adlı bir dosya bulunacaktır ve bu dosya üzerinde gereken düzenlemeler yapılarak API oluşturma işlemine geçilebilir.
API Oluşturma
API oluşturma işlemi için Node.js kullanarak Express framework kullanabilirsiniz. Bu işlem için ilk önce Node.js ortamınızda Express framework'ün yüklü olduğundan emin olmanız gerekiyor. Bu framework, web uygulamaları ve API'ları geliştirirken hız ve basitlik sağlar.
API'yi oluşturmak için öncelikle Express uygulamanızda bir tane app.js dosyası oluşturmanız gerekiyor. Ardından, web sunucusu ayarlarını yapılandırabilir ve API endpoint'leri oluşturabilirsiniz. Endpoint'ler, istekleri nasıl karşılayacağınızı belirler. Örneğin, bir GET isteğine yanıt olarak bir JSON dosyası döndürebilirsiniz.
API endpoint'leri oluştururken, Express framework'ün get() ve post() yöntemlerini kullanabilirsiniz. Bu yöntemler, GET ve POST isteklerine yanıt veren işlevleri tanımlamanıza olanak tanır. Ayrıca, API endpoint'leri için middleware kullanabilirsiniz. Middleware'ler, herhangi bir HTTP isteği geldiğinde çalışacak bir kod parçasıdır. Bu, API isteğinin işlenmesinde yardımcı olur ve birçok yöntemi destekler.
API'yi oluşturduktan sonra, Postman gibi bir API test aracı kullanarak test edebilirsiniz. Böylece, API'nizin doğru çalışıp çalışmadığını ve anlamsız hatalarının olup olmadığını görebilirsiniz. Test aşamasından sonra API'nizi deploy edebilirsiniz.
API Dosyası Oluşturma
API dosyası oluşturma aşamasına geçmeden önce Express framework'ün ne olduğunu hatırlayalım. Express framework, Node.js web uygulamaları oluşturmak için en yaygın kullanılan bir web framework'üdür. API dosyası oluşturmak için Express framework'ün farklı yöntemleri kullanılabilir. Bunlardan başlıcaları şu şekildedir:
- HTTP Yöntemleri: Express, HTTP GET (getirme), POST (yükleme), PUT (güncelleme) ve DELETE (silme) gibi HTTP metodlarını kullanarak API oluşturma imkanı sağlar.
- Middlewares: Express, middleware kavramına dayalı çalışan bir framework'tür. Middleware'lar, request-response döngüsü boyunca uygulanan işlemlerdir. Bu nedenle, middleware'lar kullanarak API dosyasında işlemler de yapılabilir.
- Router: Express, Router nesnesi kullanarak API dosyasına farklı yönlendirmeler eklemeyi sağlar. API kodlama daha modüler hale getirilir ve birden çok dosyayı tek bir dosyada kullanabiliriz.
API dosyası oluşturma aşamasında, hangi yöntemin kullanılacağına karar verilir ve nodemon gibi bir yükleme aracı yardımıyla API kodlamasının doğru çalışmasını sağlamak amacıyla test edilir. Bu aşama, API'nin doğru bir şekilde çalışması için oldukça önemlidir. Test işlemi için Postman gibi API geliştiricileri tarafından yaygın olarak kullanılan bir araç kullanılabilir.
API'nin Test Edilmesi
API'nin doğru çalışmasını test etmek için API test öncesi hazırlıkları yapılmalıdır. Birçok test aracı mevcut olsa da, burada Postman kullanarak test işlemini gerçekleştireceğiz. İlk olarak, Postman'ı indirerek ve yükleyerek başlayabilirsiniz. Postman'a girdikten sonra, ilk olarak bir collection oluşturmanız gerekiyor. Buradaki Collection, API'nin tüm endpoint'lerinin ve bağlantılarının listesi gibidir. Sonrasında, tüm endpoint'leri oluşturmanız ve bunları test etmeniz gerekiyor. Bunun için Postman'ın kendi test araçlarından yararlanabilirsiniz. Yapacağınız testler sonrasında başarılı veya başarısız sonuçlar almanız mümkün. Bu sonuçları Postman üzerinden raporlayabilir, kaydedebilir ve paylaşabilirsiniz. Bu sayede hem API'nizi test ederken hem de test sonuçlarını takip ederken kolaylık sağlamış olursunuz.
API Deployment İşlemi
API deployment işlemi, proje dosyasını Heroku'nun sunucularına yüklediğimiz bir işlemdir. Bu işlem için Heroku web arayüzü veya CLI (Command Line Interface) kullanılabilir.
Heroku web arayüzü kullanarak API deployment işlemi oldukça basittir. Öncelikle, Heroku web arayüzünden yeni bir uygulama oluşturun. Daha sonra, deployment işlemi için GitHub hesabınızla oturum açın ve projenizi seçin. Son olarak, Heroku web arayüzündeki "Deploy" butonuna tıklayın ve işlemi başlatın. Bu adımlar sayesinde projeniz Heroku sunucularına yüklenecektir.
CLI kullanarak API deployment işlemi de oldukça kolaydır. Öncelikle, Heroku CLI'yı kurun ve projeyi oluşturun. Daha sonra, Heroku üzerinde uygulama oluşturun ve CLI üzerinden bu uygulamayı takip edin. Son olarak, CLI üzerinden "git push heroku master" komutunu kullanarak projenizi Heroku sunucularına yükleyin. Bu adımlar sayesinde projeniz Heroku'da başarıyla çalışacaktır.
API deployment işlemi, Heroku üzerinde web arayüzü veya CLI kullanılarak gerçekleştirilebilir. Hangi yöntemi seçerseniz seçin, adımları doğru bir şekilde takip ettiğinizden emin olun. Bu adımlar sayesinde Node.js ve Heroku kullanarak API deployment işlemini kolayca gerçekleştirebilirsiniz.
Heroku Deployment
Heroku web arayüzü üzerinden projenizi deploy etmek oldukça kolaydır. Bunun için Heroku oturum açma sayfasına giriş yapmanız gerekiyor. Oturum açtıktan sonra, Heroku Dashboard'unuzda yeni bir uygulama oluşturabilirsiniz. Bu işlem esnasında, uygulamanızı hangi programlama dilinde yazacağınızı da seçebilirsiniz.
Daha sonra, oluşturduğunuz uygulamanın Heroku üzerinde de deploy edilmesi gerekiyor. Bu işlem için "Deploy" seçeneğini kullanabilirsiniz. Bu sayede, yerel bilgisayarınızda bulunan uygulamanız Heroku üzerinde de çalışabilir hale gelir.
Ayrıca, Heroku web arayüzü üzerinden deploy etmek yerine, CLI kullanarak da işlemlerinizi gerçekleştirebilirsiniz. Bunun için öncelikle Heroku CLI'nın kurulumunu gerçekleştirmeniz gerekiyor. Kurulum işlemi bittikten sonra, Heroku API'sine erişebilir ve uygulamanızı kullanarak önceden girilen komutlarla deploy edebilirsiniz.
Sonuç olarak, Heroku web arayüzü üzerinden veya CLI kullanarak API deployment işlemini çok kolay bir şekilde gerçekleştirebilirsiniz.
CLI Deployment
Heroku CLI yüklendiğinde, Heroku deploy işlemini gerçekleştirmek için birden fazla yönteme sahip olursunuz. Öncelikle, Heroku Dashboard web arayüzüne giriş yaparak, seçtiğiniz uygulamanın deploy kısmına ulaşabilirsiniz. Deploy seçeneğine tıkladıktan sonra, "Heroku Git" üzerinden veya farklı bir Git platformu kullanarak uygulamanızı deploy edebilirsiniz.
Bunun yanı sıra, CLI kullanarak da uygulama deploy işlemini gerçekleştirmeniz mümkündür. CLI yardımıyla, hedef uygulama belirlenip, Heroku üzerinde yeni bir Git remote oluşturulabilir. "git push" komutu kullanılarak, Heroku üzerindeki remote git'e şirketin depo içeriği yüklenir. Komut terminalinde şu işlemler gerçekleştirilir:
- Heroku CLI'yı indirin ve yükleyin
- Terminal penceresinde "heroku login" kullanarak Heroku hesabınıza giriş yapın
- Uygulamayı Heroku üzerinde oluşturun ve yöneticisi siz olduğunuz bir isim verin
- "heroku git:remote -a uygulamanın ismi" komutuyla, yeni bir Heroku Git remote oluşturun
- "git add ." ile dosyalarınızı ekleyin
- "git commit -am "mesaj"" ile değişiklikleri commit edin
- "git push heroku master" ile depo içeriğinizi Heroku'ya yükleyin
Bu işlemleri gerçekleştirdiğiniz taktirde, Heroku CLI ile uygulamanızı Heroku'ya deploy edebilirsiniz. Böylece, Node.js ve Heroku kullanarak kolaylıkla API deployment işlemini gerçekleştirebilirsiniz.
Sonuç
Node.js ve Heroku, API deployment işlemini kolaylaştıran güçlü araçlardır. Bu makalede, adım adım Node.js ve Heroku ile API deployment işleminin nasıl gerçekleştirileceği anlatıldı. Öncelikle Heroku hesabı oluşturulmalı ve CLI yüklendikten sonra, bir Node.js projesi oluşturulmalıdır. Proje oluşturulduktan sonra, Node.js Express framework kullanılarak API oluşturulabilir ve farklı yöntemlerle API dosyası yaratılabilir. API test işlemi için ise Postman kullabilirsiniz. Tüm bu adımlar tamamlandıktan sonra, API deployment işlemi için Heroku web arayüzü veya CLI kullanılabilir.
Heroku platformu, uygulamaların bulut tabanlı bir platformda kolayca oluşturulmasına ve dağıtılmasına izin verir. Bu nedenle, Node.js ve Heroku kullanarak, özellikle küçük ölçekli uygulamaların API deployment işlemini kolayca gerçekleştirebilirsiniz. API deployment işlemi önemli bir süreç olmakla birlikte, Node.js ve Heroku'nun güçlü özellikleri sayesinde bu süreci kolaylaştırabilirsiniz.