Assalamu’alaikum Wr, Wb. Pada artikel ini kita akan fokus membuat Product Service, Service ini akan Menggunakan NodeJS dan MongoDB sebagai database nya. Alasan admin menggunakan NodeJS dan mongoDB yaitu admin ingin menunjukan keberagaman dalam membangun suatu microservices. Tidak ada aturan yang baku mengenai bahasa pemrograman maupun database yang akan kalian pakai. Pilih lah bahasa pemrograman dan database yang cocok untuk mengandle logic yang ada pada Service yang akan dibuat.

Installasi

Kali ini kita akan menggunakan Framework nodejs yang cukup populer yaitu ExpressJS, Pastikan kalian sudah menginstall NodeJS dan MongoDB ya.

Seperti yang kita bahas pada artikel sebelumnya bahwa struktur folder yang kita buat seperti ini :

~/Documents/code/microservices/
- authentication
- products

untuk memulai installasi kalian tinggal pindah ke folder ~/Documents/code/microservices/ kemudian ketik command dibawah ini :

npx express-generator products

Maka folder products akan terbuat beserta file – file yang dibutuhkan untuk membuat service products, jika kalian menemukan masalah pada saat installasi, silakan buka dokumentasi resmi disini.

Ketik perintah ini untuk memastikan aplikasi Express kalian berjalan

npm run start

Membuat Endpoint

PENTING : Perlu kalian ketahui bahwa beberapa service harus memiliki middleware untuk menghandle JWT Token, simple nya setiap service harus bisa memvalidasi apakah token yang dikirimkan dari User masih berlaku atau tidak, ini berlaku pada setiap service yang akan di diakses oleh user. Dan juga setiap service yang memakai middleware JWT diharuskan memakai JWT_SECRET key yang sama.

Kita akan mengambil contoh kasus dimana pada service ini terdapat dua endpoint yaitu, seperti pada artikel sebelumnya bahwa /products akan diarahkan ke Service Products jadi kita buat nya / dan /seeder saja.

# End Point ini akan dibuat public
/products
# End Point berfungsi sebagai seeder yang nantinya akan mengisi data products di database dan endpoint ini akan dibuat secure
/products/seed

Supaya service kita dapat menghandle token dan juga supaya service kita dapat terkoneksi dengan mongodb, tentunya kita butuh yang namanya packages untuk mempermudah. Sisipkan packages berikut di packages.json

"dependencies": {
    ....
    "jsonwebtoken": "^8.5.1",
    "mongoose": "^5.7.13",
    ....
  }

Setelah itu tentunya kita membutuhkan namanya file konfigurasi untuk menyimpan variable seperti konfigurasi database, dan JWT_SECRET. Buat file di config/keys.js kemudian sisipkan script berikut :

module.exports = {
    mongoURI: process.env.MONGO_URL || "mongodb://root:root@localhost:27017/data?authSource=admin",
    jwtSecret: process.env.JWT_SECRET || "SuperSecretKey**2019"
};

Selanjutnya kita akan membuat model untuk data Product kita, buat file models/Product.js dan sisipkan script berikut :

const mongoose = require("mongoose");
const schema = mongoose.Schema;

const ProductSchema = new schema({
    name:{
        type: String,
        required: true
    },
    price:{
        type: Number,
        required:true
    },
    created_at:{
        type: Date,
        default:Date.now
    }
});

module.exports = Product = mongoose.model("products", ProductSchema);

Kemudian kita akan membuat routes nya, edit / buat file routes/index.js dan sisipkan script berikut :

var express = require('express');
var router = express.Router();
let Product = require("../models/Product"); 
let config = require("../config/keys")






/**
 * The Middleware
 */

// a middleware sub-stack shows request info for any type of HTTP request to the /user/:id path
router.use('/seed', function (req, res, next) {
  console.log(config.jwtSecret)
  let token = req.headers['Authorization']; // Express headers are auto converted to lowercase
  if(token == undefined){
    res.status(403).json({
      message: "Please provide token",
      status_code: 403
    })
  }else{
    if (token.startsWith('Bearer ')) {
      // Remove Bearer from string
      token = token.slice(7, token.length);
    }

    
    if (token) {
      jwt.verify(token, config.jwtSecret, (err, decoded) => {
        if (err) {
          res.status(403).json({
            message: "Invalid token",
            status_code: 403
          })
        } else {
          req.decoded = decoded;
          next();
        }
      });
    } else {
      res.status(403).json({
        message: "Please provide token",
        status_code: 403
      })
    }
  }
  
})
router.get('/seed', function(req, res, next) {
  let data = [];
  let length = 100; // user defined length

  for(let i = 0; i < length; i++) {
     new Product({
       name: "Product name " + i,
       price: 15000
     }).save().then(() => console.log("Success"))
  }
  res.send(`Seeding ${length} complete`)
});
/**
 * Get Products list
 */
router.get('/', function(req, res, next) {
  Product.find({}, function(err, results) {
    res.send(results)
  })
});


module.exports = router;

Kemudian kita edit file app.js dan sisipan script berikut :

var createError = require('http-errors');
var express = require('express');
var path = require('path');
var cookieParser = require('cookie-parser');
var logger = require('morgan');

var indexRouter = require('./routes/index');

var app = express();

// view engine setup
app.set('views', path.join(__dirname, 'views'));
app.set('view engine', 'jade');

app.use(logger('dev'));
app.use(express.json());
app.use(express.urlencoded({ extended: false }));
app.use(cookieParser());
app.use(express.static(path.join(__dirname, 'public')));

app.use('/', indexRouter);

// catch 404 and forward to error handler
app.use(function(req, res, next) {
  next(createError(404));
});

// error handler
app.use(function(err, req, res, next) {
  // set locals, only providing error in development
  res.locals.message = err.message;
  res.locals.error = req.app.get('env') === 'development' ? err : {};

  // render the error page
  res.status(err.status || 500);
  res.render('error');
});

// MongoDB
const db = require("./config/keys").mongoURI;
const mongoose = require("mongoose");
console.log(db)
mongoose
    .connect(db, {useNewUrlParser: true, auth:{authdb:"admin"}})
    .then(() => console.log("mongoDB Connected"))
    .catch((err) => {
      console.log(err)
      process.exit(1)
    });

module.exports = app;

Oke sampai saat ini kita sudah berhasil membuat service products. PS : Admin anggap kalian sudah mengerti ya dalam pembuatan API menggunakan NodeJS karena disini admin hanya memberikan contoh service sederhana, Kalau kalian ingin berkreasi dengan contoh kasus lain silakan.

Okay, saat nya kita mencoba.

Buka aplikasi Postman kemudian coba hit di endpoint http://localhost:3000/. Kalian pasti akan mendapatkan response array kosong karena kita belum melakukan seeder database. untuk melakukan seeder database kalian kunjungi http://localhost:3000/seed.

Dan pastinya kalian akan mendapatkan response seperti ini :

{
"message": "Please provide token",
"status_code": 403
}

Jadi mekanisme nya adalah, kalian harus mengambil JWT TOKEN ke service Authentication yang telah kita buat sebelumnya, kemudian Ambil token tersebut dan kirimkan bersamaan dengan request untuk melakukan seeder. (Pastikan JWT_SECRET nya sama ya).

Jika ada kendala jangan sungkan untuk tanya ke admin lewat sosial media yang ada diatas. Tutorial ini disimpan di Repository github saya, kalian bisa buka disini : https://github.com/tarikhagustia/microservice_example

Sekian dan terimakasih, Wassalamu’alaikum Wr. Wb.

Assalamu’alaikum Wr. Wb Pada artikel kali ini saya akan melanjutkan materi tentang Membangun Microservices sederhana dengan PHP, NodeJS dan Docker. Pada bagian ini saya akan menjelaskan tentang pembuatan Authentication Service, oh iya sebelum ke materi FYI ya buat temen – temen bahwa domain blog saya telah di ubah dari blog.tarikhagustia.id ke tarikhagustia.id karena sesuatu dan lain hal.

Pada artikel bagian pertama, kita sudah membahas tentang arsitektur yang akan kita buat. Nah pada bagian ini admin akan membuat Authentication Service menggunakan PHP dengan Framework lumen. Mungkin ada temen – temen yang bertanya, “Bang kok pake PHP? kenapa ga pake golang atau semacamnya? kan lebih cocok.” ya karena saya sendiri belum bisa golang hehe . Disini saya mencoba untuk memperlihatkan keberagaman dalam pembuatan microservice. Untuk Framework, temen – temen bebas memilih apa saja kebetulan saya pake Lumen karena saya sendiri sudah terbiasa dengan Laravel.

Tapi ni tapi… memakai PHP sebagai microservices bukanlah hal yang jelek, karena performance dari PHP sendiri mangkin kesini mangkin “Ngacir”.

Installasi Lumen

Disini saya ga bakal ngajarain hal – hal basic, jadi saya anggap temen – temen sudah bisa dalam melakukan installasi untuk Lumen Framework, kalo temen – temen ga tau cara install nya, cek official dokumentasi nya.

jadi pada pembuatan microservices ini saya akan membuat struktur folder seperti ini :

~/Documents/code/microservices/
- authentication
- products

untuk lokasi nya disesuaikan ya di lokasi komputer temen – temen, kebetulan saat membuat artikel ini saya pake Mac (Sombong amat …).

Oke, kemudian untuk menginstall lumen di dalam folder microservices, run command berikut :

composer create-project --prefer-dist laravel/lumen authentication

Seteleh terinstall pastikan temen – temen melakukan konfigurasi dasar, untuk konfigurasi dasar temen – temen bisa lihat di offical dokumentasi nya. Setelah terkonfigurasi dengan baik silahkan temen – temen buka project nya dengan Text Editor / IDE yang disukai, saat ini saya pakai PHPStrom sebagai IDE nya.

Selanjutnya dalam pembuatan service ini kita akan memakai packages https://github.com/tymondesigns/jwt-auth untuk melakukan generator token JWT, tambahkan package tersebut pada composer.json

...
"tymon/jwt-auth": "^1.0",
...

Pakai yang versi 1 keatas ya biar upto date gituloh, Kemudian jalankan composer update, untuk installasi lengkapnya silahkan baca dokumentasi lengkapnya di https://jwt-auth.readthedocs.io/en/develop/lumen-installation/

Jangan lupa dibaca juga ya quick start nya https://jwt-auth.readthedocs.io/en/develop/quick-start/

Kemudian pastikan lumen framework nya berjalan dengan sempurna dengan menjalankan perintah

php -S localhost:8000 -t public

Jika tidak ada error, maka lumen framework akan berjalan pada port 8000 dan akan memberikan response : Lumen (6.2.0) (Laravel Components ^6.0), jika tidak temen – temen bisa debugging sendiri, itung – itung latihan hehe ;).

Membuat End Point

Dalam pembuatan API pasti kita tidak asing lagi dengan kata End Point, kali ini kita akan membuat 2 endpoin yaitu :

1. /auth/token (Memberikan response token)
2. /auth/me (Memberikan informasi user yang telah login)

Pertama kita harus membuat controller, jika temen – temen mengikuti tutorial dari https://jwt-auth.readthedocs.io/en/develop/quick-start/ maka temen – temen tinggal ikuti saja. Mari kita buat AuthController.php (Karena dilumen ga bisa generate controller) jadi kita mesti buat secara manual.

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;
use App\Http\Controllers\Controller;

class AuthController extends Controller
{
    /**
     * Create a new AuthController instance.
     *
     * @return void
     */
    public function __construct()
    {
        $this->middleware('auth:api', ['except' => ['login']]);
    }

    /**
     * Get a JWT via given credentials.
     *
     * @param Request $request
     * @return \Illuminate\Http\JsonResponse
     */
    public function login(Request $request)
    {
        $credentials = $request->only(['email', 'password']);

        if (! $token = Auth::attempt($credentials)) {
            return response()->json(['error' => 'Unauthorized'], 401);
        }

        return $this->respondWithToken($token);
    }

    /**
     * Get the authenticated User.
     *
     * @return \Illuminate\Http\JsonResponse
     */
    public function me()
    {
        return response()->json(Auth::user());
    }

    /**
     * Log the user out (Invalidate the token).
     *
     * @return \Illuminate\Http\JsonResponse
     */
    public function logout()
    {
        Auth::logout();

        return response()->json(['message' => 'Successfully logged out']);
    }

    /**
     * Get the token array structure.
     *
     * @param  string $token
     *
     * @return \Illuminate\Http\JsonResponse
     */
    protected function respondWithToken($token)
    {
        return response()->json([
            'access_token' => $token,
            'token_type' => 'bearer',
            'expires_in' => Auth::factory()->getTTL() * 60
        ]);
    }
}

Kemudian selanjutnya mari kita buat routes nya, edit file web.php dan tambahkan script berikut :

<?php


$router->get('/', function () use ($router) {
    return $router->app->version();
});

$router->post('/token', 'AuthController@login');
$router->get('/me', 'AuthController@me');

disini kita tidak akan menggunakan prefix /auth, karena nantinya prefix auth akan dihanle oleh Nginx Proxy, jadi nanti semua request yang mempunyai prefix /auth akan diarahkan ke service ini.

Kemudian cobalah untuk mencoba melakukan hit kepada end point /me, temen – temen bisa pakai postman atau browser, kalo saya biasanya pakai postman. Maka seharusnya temen – temen akan mendapatkan respose seperti ini :

Unauthorized.

Hal ini dikarenakan kita harus melakukan authentikasi terlebih dahulu sebelum mengakses endpoint /me.

Nah untuk mempermudah aplikasi yang menjadi Front End API kita nanti maka response error yang akan kita berikan diusahaakan seragam dan dapat dimengerti, kali ini kita akan membuat respose nya menjadi json. Untuk merubah Error Unauthorized Response, edit file app/Http/Middleware/Authenticate.php menjadi

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Contracts\Auth\Factory as Auth;

class Authenticate
{
    /**
     * The authentication guard factory instance.
     *
     * @var \Illuminate\Contracts\Auth\Factory
     */
    protected $auth;

    /**
     * Create a new middleware instance.
     *
     * @param  \Illuminate\Contracts\Auth\Factory  $auth
     * @return void
     */
    public function __construct(Auth $auth)
    {
        $this->auth = $auth;
    }

    /**
     * Handle an incoming request.
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Closure  $next
     * @param  string|null  $guard
     * @return mixed
     */
    public function handle($request, Closure $next, $guard = null)
    {
        if ($this->auth->guard($guard)->guest()) {
            return response()->json([
                'status_code' => 401,
                'message' => 'Unauthorized'
            ], 401);
        }

        return $next($request);
    }
}

Setelah disave, kemudian kita Hit lagi endpoint /me, seharusnya menampilkan pesan error berikut :

{
    "status_code": 401,
    "message": "Unauthorized"
}

Untuk melakukan pengujian pada end point /token, tentunya kita perlu data contoh, buatlah seeder untuk menambah tabel user, kemudian lakukan migrate, untuk file migration dan seeder nya lihat script berikut :

// Migration
<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class UserTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('users', function (Blueprint $table) {
            $table->increments('id');
            $table->string('name');
            $table->string('email')->unique();
            $table->string('password');
            $table->timestamps();
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('users');
    }
}

// Seeder
<?php

use App\User;
use Illuminate\Database\Seeder;
use Illuminate\Support\Facades\Hash;

class UserTableSeeder extends Seeder
{
    /**
     * Run the database seeds.
     *
     * @return void
     */
    public function run()
    {
        $user = new User;
        $user->name = "Fulan";
        $user->email = 'email@email.com';
        $user->password = Hash::make('email@email.com');
        $user->save();
    }
}

setelah terbentuk 1 data didalam database, kemudian kita harus manambahkan config ke auth.php, dikarenakan lumen ini config nya tidak di expose, maka kita harus mengcopy dari file vendor ke config/auth.php, copy script berikut :

<?php

use App\User;

return [

    /*
    |--------------------------------------------------------------------------
    | Authentication Defaults
    |--------------------------------------------------------------------------
    |
    | This option controls the default authentication "guard" and password
    | reset options for your application. You may change these defaults
    | as required, but they're a perfect start for most applications.
    |
    */
    'defaults' => [
        'guard' => 'api',
        'passwords' => 'users',
    ],


    /*
    |--------------------------------------------------------------------------
    | Authentication Guards
    |--------------------------------------------------------------------------
    |
    | Next, you may define every authentication guard for your application.
    | Of course, a great default configuration has been defined for you
    | here which uses session storage and the Eloquent user provider.
    |
    | All authentication drivers have a user provider. This defines how the
    | users are actually retrieved out of your database or other storage
    | mechanisms used by this application to persist your user's data.
    |
    | Supported: "session", "token"
    |
    */
    'guards' => [
        'api' => [
            'driver' => 'jwt',
            'provider' => 'users',
        ],
    ],

    // optional, if use eloquent
    'providers' => [
        'users' => [
            'driver' => 'eloquent',
            'model' => User::class,
        ]
    ],
];

Kemudian coba test dengan postman untuk end point /token, dengan username dan password sesuai seeder diatas, jika berhasil response nya akan seperti ini :

{
    "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOlwvXC9sb2NhbGhvc3Q6ODAwMFwvdG9rZW4iLCJpYXQiOjE1NzYyMjU0ODMsImV4cCI6MTU3NjIyOTA4MywibmJmIjoxNTc2MjI1NDgzLCJqdGkiOiJnYkJqNEJYYnI2a2J4NGZ5Iiwic3ViIjoxLCJwcnYiOiI4N2UwYWYxZWY5ZmQxNTgxMmZkZWM5NzE1M2ExNGUwYjA0NzU0NmFhIn0.O2C6Vf88QHgk87jKFIvwSbQr-_DGOgeAhMMmg0_DdAg",
    "token_type": "bearer",
    "expires_in": 3600
}

Mungkin begitu saja materi kali ini, jika ada yang kurang jelas bisa PM admin, mohon maaf jika masih banyak kekurangan.

Assalamu’alaikum Wr. Wb, pada kesempatan kali ini saya akan membagikan pengalaman pribadi saya dalam mempelajari Software Architecture khususnya dalam bidang Microservice. Dalam Materi kali ini akan terbagi menjadi beberapa bagian (atau part) yang akan diupdate setiap minggu nya, so jangan sampai ketinggalan ya. :).

dalam materi kali ini kita akan fokus membahas tentang arsitektur yang akan kita buat nantinya, sebelum ke pembahasan lebih lanjut, mari kita lihat desain arsitektur yang akan kita buat nantinya.

Pada desain diatas dapat kita lihat bahwa arsitektur yang akan kita buat adalah berupa API yang nantinya akan diakses oleh Aplikasi Mobile / Web Base yang ada pada device user. Berikut Penjelasan detailnya.

1. Seperti yang kita lihat ada dua end point yang dapat diakses oleh user, yaitu end point /products dan auth/token
2. setiap end point akan dihandle oleh services yang berbeda
3. seperti yang teman – teman lihat bahwa kita harus menggunakan API gateway untuk melakukan distribusi kesetiap services nya, jadi user tidak diperbolehkan melakukan direct calling kesetiap service – service yang ada
4. Tiap – tiap service akan mempunyari Database yang berbeda – beda. kali ini saya akan menggunakan database MySQL dan MongoDB
5. untuk end point /products kita diharuskan melakukan authentikasi terlebih dahulu sebelum melakukan request ke end point ini, untuk mengatasi hal ini maka diperlukan token authentication, Kali ini admin pakai JWT sebagai format token nya.

Nah, cukup jelas bukan ? kalo belum jelas bisa kontak admin via sosial media, Oh iya sebelum temen – temen baca materi ini, temen – temen diharuskan sudah mengerti tentang Konsep API dan Docker ya, dikarenakan kalo belum tau dijamin bingung.

Pada artikel mendatang admin akan membuat service nya menggunakan Lumen dan juga ExpressJS, (Bisa nya cuman itu hehe) yang insyallah akan dipublish minggu depan.

Terimakasih karena sudah meluangkan waktu untuk membaca tulisan yang amat banyak kurang nya ini, Wassalamu’alaikum Wr. WB