Open topic with navigation

User Guide > Tasks > Working with Deployment > Creating an OpenShift Target

Creating an OpenShift Target

Creating an OpenShift target in Zend Studio allows you to deploy your application on OpenShift.

Prerequisites

Adding an OpenShift Target

This procedure describes how to add an existing OpenShift target in Zend Studio.

 

 

Instructions on how to complete a procedure

To add an OpenShift target:

  1. From the Menu bar,  select Window | Show View | Targets to add the Targets view to your perspective.

  1. In the Targets view, click on the Add Target icon .
    The Add Target dialog is displayed.

  1. Select the OpenShift icon, and click Next.
    The OpenShift Target Details dialog is displayed.

  1. Enter the following information:

  • Username: Your OpenShift account username.

  • Password: Your OpenShift account password.

  • SSH Private Key: Your OpenShift SSH Keypair.

  1. Click Finish.
    Zend Studio validates the existing targets on your OpenShift account. If Zend Server has not been initialized for your Zend Server cartridge, the OpenShift Target Initialization dialog is displayed. If Zend Server has been initialized, skip to step 9.

  1. Enter a Zend Server password. The password is required to access the Zend Server user interface.

  2. Click Next.
    The Zend Server EULA is displayed.

  1. Read and accept the EULA, and click Finish.
    Zend Studio will initialize the Zend Server cartridge in your OpenShift account.
  2. Add your Zend Server credentials:
    • Host: Address of your Zend Server host (e.g., http://localhost:10081, http://192.168.0.1:10081).
    • Key Name: Enter name of Web API key.
    • Key Secret: Enter Web API key. For more information on how to get a Web API key, see Adding API Keys.
  3. Click Finish.
    The new OpenShift target is added to the Targets view.

You can now deploy a project on OpenShift by dragging an existing project from the PHP Explorer onto the new target. For more information on deploying, see Deploying an Application.

Possible Problems when Testing the Connection

There are a number of issues that may arise when testing the connection to create the new OpenShift target in Zend Studio. This section describes the possible errors you may encounter after entering your OpenShift account credentials and clicking Test Connection, and the steps to take to solve them.

Wrong OpenShift Account Credentials

If you are creating a new OpenShift target and do not have an OpenShift account, or if you have entered wrong account credentials, you will not be able to establish a connection to OpenShift and create the new target in Zend Studio, and may need to create a new OpenShift account.

 

 

Instructions on how to complete a procedure

To create an OpenShift account from the Target Details dialog:

Click the Create new OpenShift account link.

To create an OpenShift account from your browser:

Go to https://openshift.redhat.com/app/account/new

 

Error Message: Domain Has Not Been Created Yet

This error is displayed if your OpenShift account does not include a defined domain. The domain is defined when you create your first application in OpenShift.

 

 

Instructions on how to complete a procedure

To define a domain:

  1. In the Target Details dialog, click Create New OpenShift Target.
    The Create New OpenShift Domain is displayed.

  1. Enter a domain name, and click Next.
    The Create New OpenShift Target dialog is displayed.

  1. Name the new target (The target name cannot be identical to the name of any existing applications in your OpenShift account).
  2. Select an available Gear profile from your OpenShift account.
  3. To automatically install the MySQL cartridge, select the 'Add MySQL Database' check-box.
  1. Enter a Zend Server password. The password is required to access the Zend Server user interface.
  2. Click Next.
    The Zend End-User License Agreement is displayed.

  1. Read and accept the license agreement, and click Finish.
    Zend Studio creates the new OpenShift target with the Zend Server 5.6 cartridge.
  1. Back in the Target Details dialog, click Test Connection again, and Finish to add the target.
    The OpenShift target is added to the Targets view, and can now be used to deploy applications.

 

Error Message: No Valid Target Detected

This error is displayed if your OpenShift target includes a defined domain, but does not contain any Zend Server 5.6 applications on it (Zend Server 5.6 cartridge).

 

 

Instructions on how to complete a procedure

To add a valid target to your OpenShift account:

  1. In the Target Details dialog, click Create New OpenShift Target.
    The Create New OpenShift Target dialog is displayed.

Note:

If your OpenShift account does not have a defined domain, the Create New OpenShift Domain is displayed (see above).

  1. Name the new target (The target name cannot be identical to the name of any existing applications in your OpenShift account).
  2. Select an available Gear profile from your OpenShift account.
  3. To automatically install the MySQL cartridge,select the 'Add MySQL Database' check-box.
  1. Enter a Zend Server password. The password is required to access the Zend Server user interface.
  2. Click Next.
    The Zend Server End-User License Agreement is displayed.

  1. Read and accept the license agreement, and click Finish.
    Zend Studio creates the new OpenShift target with the Zend Server 5.6 cartridge.
  1. Back in the Add Target dialog, click Test Connection again, and Finish to add the target.
    The OpenShift target is added to the Targets view, and can now be used to deploy applications.

 

©1999-2014 Zend Technologies LTD. All rights reserved.