ARAKAT Java Servisi

İçerik

Java web uygulamasını geliştirmek için Spring Boot kullanılmıştır.
Bağımlılık yöneticisi olarak Maven kullanılmıştır.
Uygulama Programlama Arayüzü(API) tanımlamak amacıyla Swagger2.0 kullanılmıştır.
arakat-core tarafındaki node_spec‘leri, family‘leri ve category‘leri tutmak için MongoDB kullanılmıştır.
arakat-frontend tarafındaki grafik ve tablolara veri sağlamak amacı ile HDFS kullanılmıştır.

Geliştirme Ortamında Çalıştırmak

Docker Kullanmadan Çalıştırmak

Ön Gereksinimler

JDK 1.8 veya daha güncel bir versiyonu
Maven 3 veya daha güncel bir versiyonu
MongoDB 3.2.21 veya daha güncel bir versiyonu

Çalıştırma

Uygulamayı geliştirme ortamında çalıştırmak için terminalinizde projenin en üst dizininde aşağıdaki komutu çalıştırmanız gerekmektedir:

$ SPRING_PROFILES_ACTIVE=development mvn spring-boot:run

mvn spring-boot:run GIF

Docker Kullanarak Çalıştırmak

Ön Gereksinimler

Docker 18.06.1-ce veya daha güncel bir versiyonu

Kaynak Koddan Docker İmajı Oluşturmak

arakat-backend’in Docker imajını lokal geliştirme ortamınızda oluşturmak için terminalinizde projenin en üst dizininde aşağıdaki komutu çalıştırmanız gerekmektedir: (Docker imajının etiketini latest yapmak için etiket kısmını boş bırakabilirsiniz.)

$ docker build -t arakat-backend:<SİZİN ETİKETİNİZ> .

Lokalinizde Oluşturduğunuz Docker İmajını Çalıştırmak

arakat-backend’in Docker imajını lokal geliştirme ortamınızda çalıştırmak için terminalinizde aşağıdaki komutu çalıştırmanız gerekmektedir:

$ docker run -d -p 8080:8080 arakat-backend:<SİZİN ETİKETİNİZ>

docker build from source GIF

Docker İmajını Docker Hub’dan Çekerek Çalıştırmak

arakat-backend’in Docker imajını Docker Hub’dan çekmek için terminalinizde aşağıdaki komutu çalıştırmanız gerekmektedir: (Docker imajının etiketini latest olarak kullanmak için etiket kısmını boş bırakabilirsiniz.)

$ docker pull arakat/arakat-backend:<ETİKET>

$ docker run -d -p 8080:8080 arakat-backend:<ETİKET>

docker pull from Docker Hub GIF

Swagger Arayüzü

Uygulamayı çalıştırdıktan sonra Swagger arayüzüne erişmek için

http://localhost:8080/arakat-java-service/swagger-ui.html adresini ziyaret edebilirsiniz.

Sorun Giderme / Yeni Özellik İsteği

Arakat ile ilgili bir sorunuz olduğunda, bir bug bulduğunuzda ya da yeni bir özellik isteğinde bulunmak istediğinizde GitHub/Issues sekmesini kullanabilirsiniz.