Back to Tutorials

Contents 1 Deploying an Application 1.1 Related Resources 2 Procedure 2.1 Open an Existing Solution 2.2 Add an AppProject to the Solution 2.3 Add a Page to AppProject: QuoteOfTheDayApp 2.4 Edit the Page 2.5 Add the Form to the Page 2.6 Set the Main Page for Application Property 2.7 Check in the Solution 2.8 Post the Application 2.9 Deploy the Application 3 Managing a Deployed Application 3.1 Updating a Deployed Application 3.2 Activating/Deactivating a Deployed Application 3.3 Assigning a URL to a Deployed Application 3.4 Making the application available

[edit] Deploying an Application

To deploy an application, the solution must meet the following criteria:

• The solution must contain at least one page.
• The Main Page for Application property (on the AppProject) must be set to the main page for the application.
• The entire solution must be checked into the Depot.

Once the application is completed and checked into the Depot, you post the application to Production (the production datastore). When you post the application, a copy of the entire solution is placed into the production datastore. Only posted applications can be deployed for end users. When you deploy the application, a URL is assigned to the application (the URL points to the production version of the application in the production datastore). The production datastore can contain multiple versions of the same application and you can point the URL to any version of a posted application. You can also easily deactivate a deployed application.

This tutorial takes you through the steps for deploying the solution built in the Quote of the Day tutorial. The general procedure for deploying, however, is the same regardless of the application being deployed.

[edit] Related Resources

• For a detailed introduction to Bungee Builder, see the Introduction to Bungee Builder tutorial, which combines a guided tour of Bungee Builder with the Hello World tutorial.
• For documentation on Bungee Builder, see the Bungee documentation wiki.

[edit] Procedure

[edit] Open an Existing Solution

Open the Quote Of The Day solution. 

1. In the Solution Toolbar, click the Open Solution icon.
2. In the dialog box that's displayed, expand your DesignGroup and select Solution: QuoteOfTheDay.
3. Click OK.

[edit] Add an AppProject to the Solution

1. In the Solution Explorer, right-click on QuoteOfTheDay (the solution at the top level of the tree) and select Add Project (alternatively, you can click the Add Project icon in the Solution Toolbar--to the left of the Save icon).
2. In the dialog box that's displayed, do the following:
   1. In Project Name, type QuoteOfTheDayApp
   2. Click OK.

[edit] Add a Page to AppProject: QuoteOfTheDayApp

1. In the Solution Explorer, right-click AppProject: QuoteOfTheDayApp and select Add Page (alternatively,you can select AppProject: QuoteOfTheDayApp and click the Add Page button--first button on the left--at the top of the Solution Explorer).
2. The project is automatically expanded to display the page (by default, the name of a new page is NewPage).
3. In the Property Editor, change the name of the page to QuoteApp (press Tab or Enter, or click outside the text box to update the page name).

[edit] Edit the Page

Prepare the page for the forms you're going to use in the application. In this case, you're using only one form so the page needs only one cell.

1. In the Solution Explorer, double-click QuoteApp. A blank, two-row by two-column page is displayed in the Design Editor.
2. Delete one column and one row so the page is left with just one cell.

[edit] Add the Form to the Page

1. In the Solution Explorer, expand TypeLib: QOTD and select the class (clsQOTD).
2. In the Solution Detail, drag frmQOTD onto the page in the Design Editor.

[edit] Set the Main Page for Application Property

1. In the Solution Explorer, select AppProject: QuoteofTheDayApp.
2. In the Property Editor, for the Main Page for Application property, click the ellipsis button.
3. In the dialog box that's displayed, expand AppProject: QuoteofTheDayApp and select Page: QuoteApp. Click OK.

[edit] Check in the Solution

1. In the Solution Explorer, right-click on AppProject: QuoteofTheDayApp and select Check In.
   1. Important Make sure that all elements of your solution are checked in and up-to-date (for information on how to check in objects, see Using Check In and Check Out). The status of each element is indicated by a symbol to the right of the icon. A green plus (+) indicates the item has not been checked in. A green check mark indicates the item is checked out by you. Nothing indicates the item is checked in and up-to-date. A yellow triangle means your copy is out of date--a sync is required. A red check mark indicates the item is checked out by someone else.

[edit] Post the Application

1. At the top of Bungee Builder, click the Staging tab.
2. Under Depot, expand the DesignGroup that contains your application then select AppProject: QuoteOfTheDayApp.
3. Click Post.
4. A dialog box is displayed.
   1. In Application Name, type a name for the application (such as QOTD).
   2. In Version, type a version number for the posted application (such as 1.0).
   3. Click OK.

[edit] Deploy the Application

Note You may have to refresh your browser to make a newly posted application visible.

1. Under Production, expand the DesignGroup that contains your application, expand the AppProject, then select the version you want to deploy.
2. Click Deploy.
3. A dialog box is displayed with the Thresholds for Beta/Free Deploy applications.
   1. Click OK.
4. A dialog box is displayed. This dialog box lets you assign a name and set whether SSL (Secure Socket Layer) is allowed or required. By default, the name used when the application is posted to Production is used.
   1. In Deployment Name, type the name of the deployed application.
   2. Select Allow SSL to allow SSL to be used with the application.
   3. Select Require SSL to require that SSL be used with the application.
   4. Manage the URL
      1. If you would like to use the long Bungee url, leave the URL field as is. If you would like to use a URL managed by you, enter that URL here (e.g., http://bungee.mydomain.com, http://www.mydomain.com, http://www.mydomain.com/bungee, etc.).
         1. Note If you would like to use a URL managed by you for deployment, update the DNS for the domain with a C-Name record that points to run.bungeelabs.com. See below for more information.
   5. Click OK.
      1. Note Leave the Allow SSL and Require SSL not selected.

[edit] Managing a Deployed Application

After you have deployed an application, you can manage how the application is accessed and what version is accessed.

To manage a deployed application:

1. Under Deployments, select a deployed application.
2. In the bottom section of the window, expand Deployment Settings.
   1. Tip To quickly see all deployed applications for an AppProject, select the AppProject under Production. All the deployed application are displayed under Deployments.

[edit] Updating a Deployed Application

1. In the Revision Management section, under Select A Post of this Application, select the version you want the deployment to "point" to.
2. Click Update.

[edit] Activating/Deactivating a Deployed Application

When you deploy an application, by default, Active is selected. To deactivate a deployed application, select the deployed application, select Update this Deployment and remove the check mark from Active then click Update.

[edit] Assigning a URL to a Deployed Application

Near the bottom of the window is Application URL. This is the URL your users use to access your Bungee-powered application. By default, the URL is a long URL automatically generated with bungeelabs.com as the domain. Alternatively, a domain managed by you could be used. A C-Name record that points to run.bungeelabs.com, must be added to the DNS for your domain. You can create one C-name and then use a path to differentiate between deployments (e.g., http://bungee.mydomain.com/app1, …/app2, etc.) or you can create separate C-Name records for every application, (e.g., http://bungeeapp1.mydomain.com, http://bungeeapp2...., etc.). When a user enters this URL into their browser, the request is forwarded by your DNS server to the Bungee Grid servers. A Bungee Grid server inspects the path and sub-domain the request was looking for and matches it to the deployed application identified with the same url.

[edit] Making the application available

There are two ways you can make your application available to end users: as a stand-alone Web page or embedded into an HTML Web page. To make the application available as a stand-alone application, simply publish the URL specified during the deployment phase to your end users. To embed the application into an HTML page, add an IFRAME into the page that points to the URL specified during the deployment step.