Code Monkey home page Code Monkey logo

ca-project's Introduction

Stories in Ready Stories in Ready Stories in Ready Stories in Ready Stories in Ready Stories in Ready Stories in Ready Stories in Ready Stories in Ready

Keystone project

This project is meant for you to make awesome, with the skills in your Continuous Delivery and DevOps toolbox. Have fun, automate and be awesome!

Welcome to Initrode

Congratulations, you just scored your first job. Fresh out of college. It pays decently and the interviewers seemed nice. There are all sorts of perks. It even sounded like you would work with some bleeding edge technologies.

So now you're ready for whatever tasks they'll throw at you. You started yesterday together with a few college grads. You spent the day yesterday getting access to the building. You know now how to both obtain lunch and relieve any pressures such a feast might impose on you.

You've got your state-of-the-art laptops booted and are ready to make the world a better place. To innovate! To use all the skills you've gathered while studying at the university.

Speak of the devil

Your project manager calls you for a meeting and let's you in on the details on the first task that you'll complete.

He truly knows that you are very eager to get started and do cool stuff. But unfortunately they have a Python Flask Web application that runs in production at a bunch of customers, and no one quite remembers how it works. It's called CoDeChan, just like 4chan but for CoDe. You get it, right, don't you? Ahh never mind then....

The application is CoDe Chan an anonymous posting tool. No one really knows why or for what the customers use it. But never the less, it brings in some cash.

It is of course important to keep this running well and good, otherwise Initrode might end up looking very bad indeed.

Congratulations, on your second day you became the proud owner of a piece of Legacy Code.

Now, where to start?

The bare necessities

You've been handed a huge pile of .. Well you do not quite know of what.

You know that you need two things in order for you to be a success.

You need to know what is happening to the code and who is working on what.

The first step is obvious. Put your code under version control and set up a task management system for your project.

Waffle.io

An easy way to create an agile task management setup for your project is to use GitHub issues together with a waffle. This allows you to have a full swim lane and track your tasks in a nice visual way that is completely integrated with GitHub.

Go to waffle.io and add your repository containing "CoDe Chan" to "your waffle" :).

Task

  • Make a Git repository containing the code
  • Make sure that you have a waffle for your Github repository.

From now on you should consider every step in a task as a story. You should break it down into tasks that you groom.

Bat out of hell

In some ancient documentation you can see that you can run the application with the command python run.py.

Try that and see how that flies for you.

Of course dependencies are not explicitly managed, so you can't just start up the application.

Figure out the dependencies, put them in requirements.txt so you can install them with pip install -r requirements.txt.

Now that you've fixed that hurdle and you've actually got an application running, spend a few minutes familiarizing yourself with it.

Task

  • Investigate dependencies
  • Put dependencies in requirements.txt
  • Install dependencies with pip install -r requirements.txt
  • Run application with python run.py
  • Familiarize yourself with the application

I'll pack my bags and go

You've got your dependencies handled and all is good. Or sort of good. It is tedious to set up dependencies on each system that you want to run on.

Luckily you know how to use Docker.

Task

  • Create a Dockerfile containing your application code and requirements
  • Build Docker image
  • Run the application in Docker

Testing the waters

The ability to run your project in Docker has made many things easier for you. You even have the ability to track code changes and manage your self-organizing team. Things are looking up for you.

You keep stepping a bit on each others toes, so of course you look into some sort of automated tests. Luckily the project was not created by entities of pure evil. There are some tests that can be run. You need to automate them. You can run the current set of tests with python tests.py.

Continuous Integration is the goal, and you look to your good old friend Jenkins for some needed support.

Task

  • Setup a Jenkins master
  • Setup a Continuous Integration pipeline ( perhaps using the Flow? )
  • Run the tests in the pipeline
  • Make sure you maintain mainline integrity

Cut out the boring stuff

Every time that release time comes around, you get uncomfortable. You do not feel safe about deploying to producting, and it always seems to be the case that nothing is quite the same from time to time.

It is now time to script your way to deployment.

Task

  • Create a script that runs the application locally
  • Augment your script such that you can deploy to multiple targets ( eg. local, staging, production )

A means to an end

You realise that your process is actually quite mature now, but you don't exactly feel you're quite done.

Even though you are testing the internal quality of your code - you do not have any means of functional testing.

You just want the bare minimum test. So you add a test in your pipeline that will deploy your Dockerized application temporarily and test its availability.

Even a very simple thing as being able to reach your server with curl or wget would be much better than what you have now. Nothing.

Task

  • Use your automated deploy to deploy in testing
  • Do functional testing
  • Display result in Jenkins
  • This might not be a tollgate criteria, but it is important information for you to gain.

Now we have time for the cool stuff

You've reached a very mature point for your software development. You have a containerized, automatically testable and deployable application.

You know who is working on what and why. You have full faith that you can refactor your legacy project without destroying anything.

As you dare to change the code, it is no longer legacy, it is just your software.

Now it is time to tread new paths.

Task

The following are suggestions to explorations that you can take.

  • Deploy to production if functional tests pass
  • Allow rollbacks to a previous version
  • Setup an ELK-stack for monitoring
  • Use for instance HAProxy to have multiple containers running in production, through a single interface
  • Use persistent storage for your SQLite database
  • Setup a database in a separate Docker container, change application to use it
  • Investigate the usage of docker-compose for your multi-container setup
  • Investitage the usage of Kubernetes for your multi-container setup
  • Run a linter as part of the pipeline
  • Add something to do your buildtasks for you. Gradle, Rake, Grunt, Make, etc.
  • Stress the application, using for instance the docker image rufus/siege-engine
  • Do some TDD on the application
    • Make sure that you can't do an empty post
    • Make links in a post clickable
    • Make the layout prettier
    • Add additional pages
    • Add fields to the post
  • Refactor to remove the unused User and login code from the application

ca-project's People

Contributors

waffle-iron avatar randomsort avatar sofusalbertsen avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.