Skip to content
This repository has been archived by the owner on Mar 9, 2020. It is now read-only.

Home

Jump to bottom
Joshua Worden edited this page Nov 3, 2015 · 19 revisions

Note: You must fork this repository in order to make changes! Once you fork this repo, a development environment will automatically be provisioned for you. The provisioning process takes 5-10 minutes; if you are unable to login after this time window, please contact [email protected] for assistance.

In this exercise, you will be connecting to a server hosting a development environment for you. This guide will walk through how to connect to this server to make changes, view the changes in your browser, and provide instructions for configuring your FTP client if needed.

If you would prefer to set up and use your own development environment, you can see the project requirements and installation steps.

Your environment

<GHUser> should be replaced in any commands or URIs with your Github username.

Hostname: <GHUser>.test-sandbox.baseplatform.io
Username: <GHUser>
Password: <GHUser>

Connecting

You will need to connect to your environment using SSH. If you are Windows and do not have an SSH client, download Putty.

1. Connect via SSH

Open your Terminal and execute the following command to connect to your instance. When prompted, your password is the same as your username.

ssh <GHUser>@test-sandbox.baseplatform.io

You now have a connection open to your environment -- you will use this later when committing your changes. For now, you will need to generate an SSH key and add it to your Github account to allow your changes to be saved to your fork.

2. Generate an SSH key

In the SSH prompt, execute ssh-keygen -t rsa -b 4096 to generate a new SSH key. Press the Enter key to use the default settings in each of the following prompts.

3. Copy your SSH public key

After you have generated your key, type cat ~/.ssh/id_rsa.pub to display your public key. Copy the following line of text (Starts with ssh-rsa and ends with <GHUser>@test-sandbox.baseplatform.io).

4. Add your new key to Github

Next, go to SSH Keys under your Github account settings. Click on Add SSH Key and paste your new public key into the Key field. Then select Add Key at the bottom.

Making changes

If you are comfortable using server-side tools such as vim or nano, you can use them to modify files in your workspace via SSH.

If you prefer a local text editor or IDE, you can use these configuration instructions to configure an FTP client to access your files. Your FTP client must be capable of SFTP (FTP over SSH), or use the recommended clients.

Previewing changes

You can view your instance of the application by visiting the Hostname above in your browser.

Committing changes

To commit a change, use the command-line git application.

  • To see what files are changed, execute git status.
  • To see what is changed, execute git diff[ filename].
  • To add a file to be committed, execute git add <filename>.
  • To commit your changes, execute git commit -m '<message>'.
  • To push your changes to your repository, execute git push.
Clone this wiki locally