Getting Started with Engine Yard Kontainers

Overview

This guide shows you how to quickly get started with Engine Yard Kontainers (EYK) by deploying our sample Ruby Quiz application.

Please be sure to have installed Ruby 2.x, Ruby Bundler, and Git locally.

This guide uses both the EYK web console and Command Line Interface (CLI). Before you begin, download and install the EYK CLI


Deploying an Application

The video tutorial walks through all of the steps in this guide. You can use both the video and this guide as references when deploying your own application.

Engine Yard Kontainers Video Tutorial

Step-by-Step Guide

Warning
You will need to have the EYK CLI Tool downloaded and installed on your system prior to following these steps. For details, see the Download the Kontainers CLI Tool article.
  1. Create an EYK account:
    • In your browser:
      1. Navigate to eyk.ey.io and set up an account
  2. Create a Cluster for your Application:
    • In the Clusters tab:
      1. Click Clusters from the menu bar at the top
        step-2-1.png

      2. Click the '+ Add Cluster' button to create a new Cluster
        step-2-2.png

    • On the Add New Cluster page:
      1. Cluster Name: Enter a name for your cluster, e.g. 'quizcluster'
      2. Region: Select the AWS Region where you want your Cluster to reside
      3. Organization: Choose the account you just created
      4. Click the Create Cluster button
        mceclip0.png
        You will be returned to the Applications page after creating your Cluster

  3. Copy the ssologin command to your clipboard after your Cluster is created using the icon indicated below.
    mceclip2.png
  4. Use the EYK ssologin command to login:
    • Open a command line:
      1. Mac/Linux: Open a command line
      2. Windows: Click Start, then type cmd
    • Paste and run the command from the web console:
      1. This is an example command, yours will vary based on Cluster and Account names.
        eyk ssologin https://eyk.quizcluster.example-account.ey.io
        Expected result:
        Logged user <user-name> (<email-address>) in.
      2. The ssologin command uses your browser to authenticate. Your browser should display the following:
        LoginSuccess.png
  5. Upload your SSH key in order to deploy your code: For details on generating an SSH key see the Set up SSH keys article in the Engine Yard Developer Center for Mac and Linux users. See the Add SSH keys from Windows article for Windows users.
    • In your CLI:
      1. Enter: eyk keys:add ~/.ssh/id_rsa.pub where: ~/.ssh/ is the path to your public key on Mac/Linux or C:\Users\USERNAME\.ssh on Windows.
        Expected result:
        Uploading id_rsa.pub to deis... done
        NOTE: These paths and filenames are examples - your actual path and filename may be different.
  6. Prepare your code for the push to EYK:
    • In your CLI:
      1. Enter: git clone https://github.com/engineyard/ruby-quiz
        Expected result:
        Cloning into ‘ruby-quiz’...
        remote: Enumerating objects: 154, done.
        remote: Counting objects: 100% (154/154), done.
        remote: Compressing objects: 100% (119/119), done.
        remote: Total 154 (delta 23), reused 148 (delta 20), pack-reused 0
        Receiving objects: 100% (154/154), 1.35 MiB | 7.06 MiB/s, done.
        Resolving deltas: 100% (23/23), done.
    • Navigate to the cloned repository:
      1. Enter: cd ruby-quiz
  7. Create your application in EYK:
    • In your CLI:
      1. Enter: eyk create quizapp
        Expected result:
        Creating Application... done, created quizapp
        Git remote eyk successfully created for app quizapp.
        InformationTo learn more about the capabilities of the EYK CLI tool, enter eyk -h in the command line to get a complete list of commands that are available.
  8. Push your code to the new EYK remote target. This target was created in the previous step. The current branch will be deployed, 'master' in this case. Optionally, you can specify the branch of your repository using an additional parameter following 'eyk'.
    • In your CLI:
      1. Enter: git push eyk
        Expected result:
        Enumerating objects: 154, done.
        Counting objects: 100% (154/154), done.
        Delta compression using up to 4 threads
        Writing objects: 100% (154/154) 1.35 MiB | 28.69 MiB/s, done.
        Total 154 (deltat 23), reused 154 (delta 23)
        remote: Resolving deltas: 100% (23/23), done.
        Starting build... but first, coffee!
        ——> Restoring cache...
        No cache file found. If this is the first deploy, it will be created now.
        Step 1/12 : FROM ruby:2.6.6
        ...
        Done, quizapp:v2 deployed to Workflow ... To ssh://eyk-builder.<cluster-name>.<account-name>.ey.io:2222/rubyquiz.git
        * [new branch] master -> master
  9. Test your application: Validate that your application is up and running by connecting to your application’s URL. Executing the open command will open the application in your default browser.
    • In the CLI:
      1. Enter: eyk open
  10. Success! You just deployed your first application on EYK. 
    Success.png

Back to top


Related Articles

Back to top

Comments

Please sign in to leave a comment.

Powered by Zendesk