时空索引>> cadre>> 返回
项目作者： JacobBHartman

项目描述 ：
Water polo API with an associated example application
高级语言： Ruby
项目地址: git://github.com/JacobBHartman/cadre.git
创建时间： 2020-10-22T05:38:39Z
项目社区：https://github.com/JacobBHartman/cadre
开源协议：
下载


cadre

  1. API platform for water polo, and sports in general
  2. An application that interacts with the API

Prerequisites

  • Mac Mojave 10.14.6
  • Docker for Mac 2.2.0.3
    • Docker Engine 19.03.5
    • docker-compose 1.25.4
  • Git 2.20.1

Software

These are the versions of the major software I used. These are not prerequisites for you to run the app.

  • Rails 6.0.3.4
  • Ruby 2.7.2
  • Node 12.19.0
  • sqlite3 3.27.2 (not currently static)
  • yarn 1.22.5 (not currently static)

Install

  1. # copy and paste assuming you have the prerequisites
  2. git clone https://github.com/JacobBHartman/cadre.git
  3. cd cadre
  4. docker-compose build
  5. # docker-compose build --no-cache is slower but better if Dockers image cache interfere
  6. docker-compose up
  7. # go to localhost:8001 in your browser

In a separate terminal:

  1. docker exec -it $(docker container ls | grep "cadre_ruby" | awk '{print $1}') /bin/bash

And then from within the container:

  1. ./dev/github.sh
  2. # follow the prompt

Purpose

The purposes of this project are to…

  1. demonstrate my ability to acquire proficiency in technologies that I haven’t worked with before
    • Ruby on Rails
    • A database other than MySQL, so I’ll probably go with PostgreSQL and get to touch SQLite
    • Implement my own caching
    • If it makes sense, Vue
  2. demonstrate a complete aptitude for the DevOps toolkit including:
    • Jenkins, might switch to Gitlab or something else to learn something new
    • Docker to get it out the door, but will use LXC if I have time and have determined it makes sense
    • Terraform, though I wouldn’t mind toying with Pulumi
    • Ansible, I used Saltstack but didn’t like it. I previously used Ansible and liked it alot. It seems to be the most popular.
    • Kubernetes, do I need to look into Rancher?
    • Helm, do I need this, how does it help me? This project should help answer those questions.
    • Bash, use best practices for scripting
    • AWS, I risk pigeonholing myself in AWS further but if I want to get frisky I can switch to GCP
    • System design and justification
  3. build a project that I’ve been wanting to build for two years now

Topics to add to README

  • Configuration
  • Database creation
  • Database initialization
  • How to run the test suite
  • Services (job queues, cache servers, search engines, etc.)
  • Deployment instructions

Scope

I define project scope using Github Projects

  • MVP, MVP, MVP: Version 0 (local)
  • Make External: Version 1
    • The app should be externally available on a working domain name
    • Minimum AWS, Terraform, Docker files, Jenkins. Ansible if necessary
  • Mature: Version X
    • Complete API: pools, players, coaches, games, scores, etc.
    • Not water polo specific
    • Example applicaton that looks good and uses the API

Dev Diary

Located in /dev/diary

To-Do

Handled by Github’s Issue Tracking

Contributers

JacobBHartman