Users service

Service in charge of users management, including basic CRUD operations, and roles assignment. This service is also capable of issuing tokens in order to access the whole platform.

Features

• User management
• Roles management
• Authentication/Authorization tokens management

Getting started

The following instructions will set the development environment in your local machine, as well as let you run locally an instance of the system.

Note: This guide covers only Mac OS X setups.

Prerequisites

Get source code

Clone the repository or download source code:

$ git clone https://github.com/coding-eval-platform/users-service.git

or

$ wget https://github.com/coding-eval-platform/users-service/archive/master.zip

Set up Runtime

This project requires Java 11. The following is a guide to install Java 11, and optional jenv to manage your Java environments.

1. Install Java 11:

   $ brew cask install java
   

   Note: If you already had a previous version of Java installed in your system, this will upgrade it. If you want to have several versions of Java installed in your machine, you can use the cask versions tap:

   1. Tap the cask versions repository:

      $ brew tap homebrew/cask-versions
      

   2. Install a previous version of Java:

      $ brew cask install java8
      

2. Install and configure jEnv (Optional):

   Perform this step if you want to run multiple versions of Java in your machine. For more information, check jEnv webpage. Also, check this guide.

   1. Download software:

      $ brew install jenv
      

   2. Update your bash or zsh profile to use jEnv:

      Bash

      $ echo 'export PATH="$HOME/.jenv/bin:$PATH"' >> ~/.bash_profile
      $ echo 'eval "$(jenv init -)"' >> ~/.bash_profile
      

      If you want to use jEnv now, don't forget to source again your profile:

      $ source ~/.bash_profile
      

      Zsh

      $ echo ‘export PATH=”$HOME/.jenv/bin:$PATH”’ >> ~/.zshrc
      $ echo ‘eval “$(jenv init -)”’ >> ~/.zshrc
      

      If you want to use jEnv now, don't forget to source again your profile:

      $ source ~/.zshrc
      

   3. Locate the JDK installations in your machine. They will likely be in the /Library/Java/JavaVirtualMachines/ directory.

   4. Add a Java version to jEnv:

      $ jenv add /Library/Java/JavaVirtualMachines/{{jdk-version}}/Contents/Home
      

      Replace the {{jdk-version}} placeholder with an actual version of Java. For example:

      $ jenv add /Library/Java/JavaVirtualMachines/openjdk-11.0.2.jdk/Contents/Home
      

   5. Configure jEnv:

      To set a global version of Java, use the following command:

      $ jenv global {{jdk-version}}
      

      Replace the {{jdk-version}} placeholder with an actual version of Java. For example:

      $ jenv global openjdk-11.0.2.jdk
      

      You can check the Java versions being managed by jEnv using the following command:

      $ jenv versions
      

      Similarly, you can set the Java Version with a local or shell scope:

      Local Scope

      If you want to set the Java version for the current working directory:

      $ jenv local {{jdk-version}}
      

      Shell Scope

      If you want to set the Java version for the current session:

      $ jenv shell {{jdk-version}}
      

Building tool

The building tool used for the project is Maven.

$ brew install maven

If you have installed jEnv, you can enable the maven plugin, in order to execute maven using the jEnv managed Java:

$ jenv enable-plugin maven

Restart your shell session in order to have the plugin running.

Check this resource for more information about jEnv plugins.

Database

The project requires a PostgreSQL database.

Create a local database (Optional)

1. Install PostgreSQL

$ brew install postgresql

2. Create a user and a database for the application. You can check the create user and create database documentations to learn how to perform this step.

Set up project to use the database

Set the following properties with the appropiate values:

• spring.datasource.url
• spring.datasource.username
• spring.datasource.password

You can do this by changing the <project-root>/users-service-application/src/main/resources/application.yml file, in the development section, or by defining the properties through the command line (with -Dkey=value properties, or with --key=value properties) when running the application.

Note: These properties can be filled with the values of a local database, or with the values of a remote database.

Build

1. Install artifacts:

   $ cd <project-root>
   $ mvn clean install
   

   Doing this will let you access all modules defined in the project scope.

2. Build the project:

   $ mvn clean pacakge
   

   Note: In case you change the <project-root>/users-service-application/src/main/resources/application.yml, you must build again the project. Otherwise, if you want to change a property on the fly, use command line properties.

Run

You can run the application using the following command:

$ java [-Dkey=value properties] -jar <project-root>/users-service-application/target/users-service-application-0.0.1-SNAPSHOT.jar [--key=value properties]

The following is a full example of how to run the application:

java \
	-Dspring.datasource.url=jdbc:postgresql://localhost:5432/coding-eval-platform__users-service \
	-Dspring.datasource.username=coding-eval-platform__users-service \
	-Dspring.datasource.password=coding-eval-platform__users-service \
	-jar <project-root>/users-service-application/target/users-service-application-0.0.1-SNAPSHOT.jar \
	--spring.profiles.active=dev

Note: In case of using a new database, this will create all tables.

Other stuff

1. (Optional) Install Flyway CLI. Check the documentation in order to learn how to do it.

   Flyway is a tool for performing database migrations easier (i.e changing schema, adding system data, etc.). Check their website for more information.

2. (Optional) Create a Flyway configuration file. This file must contain the following properties:

   # Flyway CLI configuration
   
   flyway.url=<database-url>
   flyway.user=<database-username>
   flyway.password=<database-user-password>
   

   This configution file will let you use Flyway easier. It won't ask for credentials each time you want to use it.

   Note: The .gitignore file declares the flyway.conf file, so this information should not leak into GitHub.

License

Copyright 2019 Bellini & Lobo

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Authors

• Juan Marcos Bellini
• Daniel Lobo