Working with Projects

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

About 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 to learn about an Oracle Developer Cloud Service project.

Creating a Project

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

Watch a short video to learn about creating an Oracle Developer Cloud Service project.

You can create a project and initialize it in the following ways:

• Empty project

  See Creating an Empty Project.

• (Default) Project with an initial Git repository

  See Creating a Project with an Initial Git Repository.

• Project with data from a private template project

  See Creating a Project from a Private Project Template.

• Project with data from a shared template project

  See Creating a Project from a Shared Project Template.

Before You Create a Project

Before you create a project, you should know about the technologies used by Oracle Developer Cloud Service and configure your user preferences.

• Know about the technologies used by Oracle Developer Cloud Service. See Before You Begin Using Oracle Developer Cloud Service.

• Configure your user preferences. See Setting User Preferences.

• Learn about project roles. See About Project Roles

Creating an Empty Project

An empty project is a project with no pre-configured Git repository. You can add or import a Git repository later.

Tutorial

To create an empty project:

1. From the Project Home 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.

3. Click Next.
4. In the Template page of the New Project wizard, select Empty Project, and click Next.
5. 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.

6. Click Finish.

Creating a Project with an Initial Git Repository

You can create a project with an initial Git repository with the project name as the name of the Git repository. You can choose the Git repository to be empty, populated with a ReadMe file, or populated with data imported from another Git repository.

To create a project with an initial Git repository:

1. From the Project Home 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.

3. Click Next.
4. In the Template page of the New Project wizard, select Initial Repository, and click Next.
5. 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.

6. Click Finish.

Creating a Project from a Private Project Template

You can create a project with data copied from a private project template. Private project templates are not listed by name, but are accessible through their private keys. To create a project from a private project template, you must have its private key.

To create a project from a private project template:

1. From the Project Home 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.

3. Click Next.
4. In the Template page of the New Project wizard, select Private Template, and click Next.
5. In the Private Template Selection page, enter the private key in Private Key, and click Next.
6. In the Project Properties page of the of the New Project wizard, complete the elements using the descriptions in the following table.

   Depending on the project template, some fields listed in the following table may not be available, or you may see some additional input fields.

   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.

7. Click Finish.

Creating a Project from a Shared Project Template

You can create a project with data copied from a shared project template. Shared project templates are listed by name and are available to all users of the organization.

To create a project from a shared project template:

1. From the Project Home 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.

3. Click Next.
4. In the Template page of the New Project wizard, select the project template, and click Next.
5. In the Project Properties page of the of the New Project wizard, complete the elements using the descriptions in the following table.

   Depending on the project template, some fields listed in the following table may not be available, or you may see some additional input fields.

   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.

6. Click Finish.

Creating a Project from IDEs

You can create an Oracle Developer Cloud Service project from JDeveloper and NetBeans IDE.

See Creating an Oracle Developer Cloud Service Project in JDeveloper and Creating an Oracle Developer Cloud Service Project in NetBeans IDE.

After You Create a Project

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.

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.

• Getting Familiar with the User Interface

• Using Git Repositories

• Viewing the Project Summary

• Managing Project Users

Opening a Project

You can open a project from the Project Home 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 Project Home 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. On the Project Home page, choose the filter toggle button (if necessary), and click the project name link to open it.

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

Description of the illustration odcs_changeproject.png

Using a Project Template

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

The following artifacts are cloned from the project template:

• Git repositories

  The Git repositories of the project template are copied to the new project. The Git repositories contain a copy of the template project’s source code. You can clone the project repositories to your local computer, 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 Git 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 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 deployment configurations of the template project are copied to your project. In the navigation bar, click Deploy to see all copied deployment configurations. You may modify the deployment configurations or delete them.

• Wiki pages

  All wiki pages of the template project are copied to your project. In the navigation bar, click Wiki to see all copied wiki pages. You may modify the wiki pages or delete them.

• Announcements

  All active project announcements of the template project are copied to your project. In the navigation bar, click Project Home to see all copied announcements. The announcements are read-only and cannot be edited, but they can be activated or deactivated.

• Links

  All Link rules of the project template are copied to your project. In the navigation bar, click Project Settings and then click Links to see all copied link rules.

Note:

After you create a project using a template, any updates made to the template project are not reflected in the created project.