Working with Oracle Developer Cloud Service Projects

An Oracle Developer Cloud Service project is a collection of features and services provided by Oracle Developer Cloud Service.

For frequently asked questions, see Questions about the Welcome page and Projects.

About Oracle Developer Cloud Service Projects

An Oracle Developer Cloud Service project is a collection of Git repositories, branch merge requests, wikis, issues, deployment configurations, and builds.

An Oracle Developer Cloud Service project can host multiple Git repositories. Each Git repository can have multiple branches and hundreds of code files. You can create a merge request for each branch of the Git repository and ask reviewers to review the code. You can create and configure multiple build jobs to generate different project artifacts and then deploy the artifacts to Oracle Java Cloud Service - SaaS Extension, publicly available Oracle Java Cloud Service instances, or Oracle Application Container Cloud Service instances..

Watch a short video or click the Tutorial link to learn about the pages of Oracle Developer Cloud Service.

Tutorial icon Tutorial

The following table describes the pages of Oracle Developer Cloud Service.

Page Description

Project

Shows the Git repository URLs, Maven repository URL, news feed, and the latest activity feed of the project.

Code

Shows the Git source code repositories and enables you to view and compare the source code of the files and the commit activities.

Maven

Shows the project Maven repository and enables you to view, upload, and search artifacts.

Snippets

Shows the snippets created by you or shared by project members.

Merge Requests

Enables you to create and manage branch merge requests, and review the code.

Issues

Shows all issues of the project and enables you to create and manage tasks, defects, and new features.

Agile

Enables you to manage project issues using the Agile methodology.

Build

Enables you to create and manage project builds and jobs.

Deploy

Enables you to create deployment configurations and deploy project artifacts to Oracle Java Cloud Service - SaaS Extension, publicly available Oracle Java Cloud Service instances, or Oracle Application Container Cloud Service instances.

Wiki

Enables you to create and manage wiki pages.

Administration

Enables you to configure the project properties. The Administration page is visible to project owners only.

Creating a Project

You can create a project from the Welcome page after logging in to Oracle Developer Cloud Service.

Before you create a project, know about the technologies used by Oracle Developer Cloud Service. See Before You Begin Using Oracle Developer Cloud Service. You may also want to set up your account preferences before using Oracle Developer Cloud Service. See Setting Oracle Developer Cloud Service Preferences.

Tip:

If you are a NetBeans IDE or a JDeveloper user, you can create an Oracle Developer Cloud Service project in the IDE itself and push the application source code files to the project Git repository. See Creating an Oracle Developer Cloud Service Project in NetBeans IDE and Creating an Oracle Developer Cloud Service Project in JDeveloper.

Watch a short video or click the Tutorial link to learn about creating an Oracle Developer Cloud Service project.

Tutorial icon Tutorial

To create an Oracle Developer Cloud Service project in the web user interface:
  1. From the Welcome page, click + New Project.
  2. In the Project Details page of the New Project wizard, complete the elements using the descriptions in the following table.
    Element Description

    Name

    Enter the project name.

    The project name must be unique in the organization, must be two or more characters long, and must begin with a letter or a number and continue with letters, numbers, .(period), _(underscore), - (hyphen), or space.

    Description

    Enter the project description.

    Security

    Select the project's privacy level.

    Private projects are accessible to invited members only.

    Shared projects are accessible to all members of the organization. Any member of the organization can view the source code, create or update issues, edit wiki pages, and interact with project builds. However, only project members and owners can push changes to the Git repository and perform deployment operations on the deployment configurations.

    Preferred Language

    Specify the preferred language for your email notifications.

    To configure email notifications, see Setting Email Notifications.

    To change the language of the user interface, update the language in your account preferences. See Setting Language Preferences.

  3. Click Next.
  4. In the Template page of the New Project wizard, complete the elements using the descriptions in the following table.
    Element Description

    Empty Project

    Select to create the project with no Git repository.

    You can add or import a Git repository later.

    Initial Repository

    Select to create the project with an initial repository. You will choose initialization options in the next page of the wizard.

    project

    Select the template project.

    When you choose a template project, its Git source repositories, wiki pages, Maven artifacts, and build jobs are cloned to the new project. See Using a Template Project.

  5. Click Next.
  6. In the Project Properties page, complete the elements using the descriptions in the following table.
    Element Description

    Wiki Markup

    Select the project’s wiki markup language.

    You can use the specified markup language to format the content of the wiki pages and comments in the Issues and the Merge Request pages.

    Initial Repository

    Specify how to initialize the Git repository.

    • Select Empty Repository to create an empty repository.

    • Select Initialize repository with README file to initialize the repository with a readme.md file created in the master branch.

      You can edit the contents of the readme.md file after the project is created.

    • Select Import existing repository to import an existing Git repository.

      See Importing a Git Repository.

    This field is available if you selected Initial Repository in the previous page of the wizard.

    Note:

    Depending on the chosen template, you may see some additional input fields in the Project Properties page.

  7. Click Finish.

After you create a project in Oracle Developer Cloud Service, you are assigned to the Owner role and are automatically navigated to the Project page. The new project is automatically provisioned with Git and Maven repositories, and all components are activated.

After creating the project, you can perform various actions such as add more Git repositories, push application source code files to the repository, and add users. See the following topics for more information.

Opening a Project

You can open a project from the Welcome page.

If you are invited to join a project, see Accessing Oracle Developer Cloud Service Using the Web Interface and About the Oracle Developer Cloud Service Welcome Page for more information about accessing Oracle Developer Cloud Service and the Welcome page.

To open a project:

  1. Open the Service URL of Oracle Developer Cloud Service and sign in.
  2. In the Welcome page, choose the filter toggle button (if necessary), and click the project name link to open it.
The Project page of the project opens. See the As a project Owner or a project Member, what can I do after I create or open a project? FAQ to learn more about what you can do after opening a project.

To open another project from an open project, click the project name and select the desired project from the Switch Project menu.

Using a Template Project

If you chose a template project while creating a project, some artifacts from the template project are copied or added to the new project.

The following artifacts are cloned from the template project:

  • Git repositories

    All Git repositories of the template project are cloned to your project. The Git repositories contain a copy of the template project’s source code. You can clone the template project repositories to your local machine, modify it, add or remove branches, and then push it back to the same repository or another repository of your choice. In the navigation bar, click Code to view the cloned Git repositories and their content.

    If you do not want to use a template project repository, you can delete it. See Deleting a Git Repository.

  • Build jobs

    All existing build jobs of the template project are copied to your project. In the navigation bar, click Builds to see all copied jobs. You may modify these jobs or create their copies. See Configuring a Job.

  • Deployment configurations

    All existing deployment configurations of the template project are copied to your project. In the navigation bar, click Deploy to see all copied deployment configurations.

  • Wiki pages

    All existing wiki pages of the template project are copied to your project. In the navigation bar, click Wiki to see all copied wiki pages.

Note:

After you create a project based on a template, any updates made to the template project will not be reflected in the created project.