Deploy Your App

You now have Course Builder on your system. The final step is to get it into your cloud project so that it can be served over the web.

Note: Google App Engine requires user authentication before you can deploy your app. If you get any auth-related issues while trying to deploy, please see the Google App Engine community forum for help.

Download Dependencies

Before you deploy, ensure you have all the things (like libraries, other software) you need to be successful. The deploy script mentioned in the section below will try to download any dependencies also, but in this step you will get more messages about the process. These messages may help you if anything is wrong. To download dependencies, open a command prompt and get to your coursebuilder directory. Type the following command:

bash ./scripts/

Deploy from Mac and Linux

Open a command prompt and get to your coursebuilder directory. Type the following command:

bash ./scripts/ <your_project_id>

If your deployment was successful, you can visit your new site.

Issues Deploying from Mac

If you run into errors, it may be because you need to install Xcode. Open a command prompt and go through the following steps.

  1. Go to the root of your Course Builder directory
  2. Type this: xcode-select --install
  3. Try deploying again. If you do not encounter any further problems, you do not need to do anything else. If you continue to encounter problems, go to the next step.
  4. Type this: sudo xcodebuild -license
  5. Accept the agreement if you agree.
  6. Try deploying again.

It should work now.

If you get a 403 authentication error that says, “You do not have permission to modify this app,” then you may need to install the gcloud command-line tool so the app knows that it’s really you.

Deploy from Windows

Windows is now supported as of version 1.11. In the scripts directory, there are two batch files:

  • windows_start_local.bat starts a local dev server so you can explore Course Builder in your browser for testing.
  • windows_deploy.bat deploys your application to Google App Engine.

Note: If you have an older version of Windows, you may need to manually download Cygwin. Watch the terminal for errors and instructions.