orangutech / cvpz

CVPZ

CV for Curriculum Vitae is a written overview of a person's experience and other qualifications. PZ 'cause it sounds easy.

TOC

• Who, What, Why, How

• Getting Started

  • Running Locally from PowerShell
  • Running Under Docker from PowerShell or Bash
  • Running Under Docker from Visual Studio 2017

• Architecture

  • Identity Service
  • Web Interface
  • Profile Service
  • Engagement Service
  • Continuous Integration

• Sponsors

  • Become a Sponsor

Who

CVPZ is a community project created by the South Sound Developers User Group (SSDUG) in lovely Olympia, WA. The group is led by Eve Ragins and this project was started and led by Carter Barnes.

What

Developers continuously need to keep their resumes current, documenting every project, engagement, and various details of accomplishments. Many have created git repositories that can store versions of these resumes well. However, as the breadth of experience expands it becomes hard to manage the growing amount of data in a single document. There are places to manage resume information, but these tools do not allow management of versions of the individual projects or the ability to query history to aid in highlighting specific experience.

Why

We are hoping to inspire community involvement by building a simple and useful tool and to create an open space for anyone who wants to be involved to come and play. As a community we can expose each other to our favorite technologies and libraries, build relationships and refine our soft skills. Ultimately this should affect our local development community in many positive ways.

How

By having one common goal to work toward, we will share ideas and continually move the project forward. We will start with the setup of some infrastructure and then work on basic requirements. The possibilities are endless with collaborative effort!

Getting Started

1. Install Docker for Windows, Mac or Linux.
   • Note: Docker required x64 bit and is not supported on Windows Home editions. The Docker-Toolbox can be installed instead. (Tutorial here)
   • Further Note: It was discoved that there is a compatibility problem with CVPZ and the docker toolbox for version 17.03 and earlier. The problem was resolved in the most recent release (17.04.0.ce). To ensure your docker toolbox is up to date, run the command docker version.
2. Install .NET Core SDK 2.0.
3. Install Visual Studio Code, the Insiders Edition is highly recommended.
4. Clone the repository: git clone https://github.com/ssdug/CVPZ.git.
5. Change directory into the cloned repository cd CVPZ.
6. Restore packages: dotnet restore .\CVPZ.sln.
7. Open the project in VSCode code-insiders . or code . depending on what version you chose to install.
   • Note: On Mac OS: after installing, open up VS Code, Press: Command + Shift + P and then type in and select Shell Command : Install 'code' command in PATH. This will enable you to open VS Code from Terminal with the code . command.

Running Locally from PowerShell

1. Open PowerShell.
2. Change directory into the cloned repository cd CVPZ.
3. Execute the command scripts\local_up.ps1.
   • This will build the project and start all services running in the background.
4. Execute the command scripts\local_ping.ps1
   • This will hit the api/health/ping endpoint on all services.
5. To shut down the image, execute the command scripts\local_down.ps1

Running Under Docker from PowerShell or Bash

1. Ensure Docker for Windows is running and set to Linux containers.
2. Open PowerShell.
3. Change directory into the cloned repository cd CVPZ.
4. Execute the command scripts\docker_up -r -b.
   • This will build the project and start all services running in the background.
5. Execute the command scripts\services_ping
   • This will hit the api/health/ping endpoint on all services.
6. To shut down the image, execute the command scripts\docker_down

Note: Docker is configured to expose ports for each service, so the services_ping scripts works for both workflows.

Note: Under Bash scripts are run with the sudo command, so you may be prompted for your password when running them.

Running Under Docker from Visual Studio 2017

1. Ensure Docker for Windows is running and set to Linux containers.
2. Open Visual Studio.
3. Open the CVPZ.sln.
4. Select either Debug or Release configuration.
5. Right click the docker-compose project and select debug.

Architecture

Identity Service

1. IdentityServer 4
2. OAuth

Web Interface

1. Angular2
2. Node
3. Bootstrap

Profile Service

1. .Net Core Api
2. MongoDB

Engagement Service

1. .Net Core Api
2. How to query Skills
3. How to query Avalability

Continuous Integration

1. Apveyor
2. xUnit

Sponsors

CodeSmart, Inc

Thank you to CodeSmart for providing space, pizza and beer for our initial kick off meeting.

• CVPZ Hack Night - March 16th, 2017

Kiehl Northwest

Thank you to Kiehl for booking space, obtaining banquit license and providing pizza and beer for our second hackathon.

• CVPZ Hackathon II - May 4th, 2017

Become a Sponsor

If you or your organization are interested in sponsoring a hackathon or a user group meeting, please contact us via Meetup. Just click the contact us button.