We want everyone at Startup Weekend's January 13, 2012 event to hit the ground running. So we're running a boot camp for all participants on Startup Weekend Eve that will give you the tools you need to be ready to start working immediately on your project. If you attend, you will:
- Get your computer configured with all the tools needed to work collaboratively with your future team members.
- Setup and configure a GitHub account with a skeleton project including:
- App Engine - web framework with simple user accounts, database, and hosting.
- Backbone.js - Rich application HTML5 framework
- Bootstrap - HTML design toolkit
- jQuery - client side Javascript framework
Bring your laptop (Windows, Mac, or Linux) with you; we'll have developers able to help you through any rough patches you have with tool installation. Our goal is to get everyone able to modify, build, and deploy their own copy of the skeleton app by the end of the evening.
When: Thursday, Jan 12, 2012 from 6pm - 9pm
Where: StartPad, 811 First Ave, Suite 480, Seattle
Phone: (206) 388-3466
You'll need to install Git and create an account on GitHub. If you would like a tutorial on using Git, I recommend Git Simple Guide and Git Tutorial.
- Install Git for Windows
- Install Git for Mac
- Install Git for Linux
You should then create your own copy of the repository by forking it on GitHub.
- Go to the Master Bootcamp Repository.
- Click on the Fork button.
Now, you need to check out the files to your own machine.
Go to a directory where you want to install your project files (e.g., ~/src or c:\src). Then use the following commands (on Windows, you should run these command from the Git Bash shell, not the windows command prompt):
$ git clone https://github.com/<your-github-username>/gtug-ae-bootcamp
$ cd gtug-ae-bootcamp
$ git remote add upstream git://github.com/mckoss/gtug-ae-bootcamp
The rest of your development machine configuration can be setup by running this command:
$ bin/make-gtug-env.sh
This script will install (if you don't them already):
- Python 2.5 (yes its old, but it's the official version supported by Google App Engine).
- pip - Python package installer (the new easy_install).
- virtualenv: Python environment isolation builder.
- Google App Engine: Google's web application service (for Python).
Note: If you want to merge any updates that have been made on the master in your own repository, use the following commands:
$ git fetch upstream
$ git merge upstream/master
You should now be able to run the sample application on your machine.
- Run the Launcher App
- File/Add Existing Application...
- Select Path to: ~/src/gtug-ae-bootcamp/app
- Select Port: 8080
- Click Add
- Select your app in the list and click the Run button.
- Open a web browser at address: http://localhost:8080
You should see the Todos application running in your browser!
First, activate your local Python environment:
$ source activate
Now, run the built-in development web server to run the app:
$ dev_appserver.py app
Open your browser at http://localhost:8080 to view the application.
You can run your application at http://<your-app-name>.appspot.com
.
- Go to the App Engine Admin Console
- Click the Create button.
- You may be asked to verify your account via SMS ... do that.
- Application identifier:
todoapp-<your-name>
(e.g., "todoapp-mckoss"). - Application Title: "GTUG Bootcamp Sample"
- Click Create Application
- Edit the file gtug-ae-bootcamp/app/app.yaml:
- Change
todoapp-mckoss
to betodoapp-<your-name>
- Change
- Deploy your application.
- Open the App Engine Luancher
- Select your app.
- Click the Deploy button.
- Enter your Google Account credentials.
- Wait until "Completed update of app:" message.
- Visit
http://todoapp-<your-name>.appspot.com
Alternatively, you can deploy via the command line via:
$ appcfg.py update app
You can view an online version of the app at http://todoapp-mckoss.appspot.com/
To learn more about the application internals, visit the Application Walkthrough.