Managing a Project
After creating a project, you can manage it from the Project Settings page.
You can change a project’s properties such as its name, description, security level, and the wiki markup language.
Editing Project Properties
After creating a project, you can edit a project's properties from the Project Settings page.
When you’re finished, use the project navigation bar to switch to another page.
Deleting a Project
You can delete a project from the Project Settings: Properties page.
- Open the project.
- In the navigation bar, click Project Settings.
- Click Properties.
- In the Properties page, click Delete Project.
- In the Delete Project dialog, select the I understand that my project will be permanently deleted check box.
- Click Delete.
Changing the Wiki Markup Language of a Project
Oracle Developer Cloud Service supports wiki markup languages for document authoring, collaboration, and formatting comments. The wiki markup language is specified in the New Project wizard and in the Properties page of the Project Settings page.
-
Wiki pages in the Wiki page
-
Comments field of an issue in the Issues page
-
Comments field in the Conversation tab of the Merge Request page
-
Comments field in the Add Comment dialog of the source code while a merge request is in progress.
-
Comments field in the Approve Merge Request dialog, Reject Merge Request dialog, and Merge dialog of the Merge Request
- In the navigation bar, click Project Settings.
- Click Properties.
- In the Properties page, select the Wiki markup language from the Markup Language options.
Note:
The changed wiki markup language will be used by new wiki pages and new comments in the Issues and Merge Request pages. Existing wiki pages and comments will continue to use the old wiki markup language.Configuring the Project as a Project Template
You can define an existing project to be used as a template for new projects. When specified, the project's name appears in the Template list in the Template page of the New Project wizard.
From the Project Settings: Properties page, you can define and change the properties of the template project. While defining a template, you use variables and rules. Variables define data to be accepted and used when the new project is created. Rules define the information or artifacts to be copied from the template project to the new project.
About Project Templates
A project template is a project that can be used as a starting point by users when they create a project. While creating a project, if you choose a template, its data is copied to the new project.
Project template data may include its Git repositories, build job configurations, deployment configurations, links, wikis, and announcements.
For example, if a project template hosts a sample application in its Git repositories; information on how to use the application in its wiki pages; build configuration in its jobs; and Oracle Cloud deployment target details in its deployment configurations, then the data of the project template is copied to the new project. Project users can review or update the sample application, run builds of pre-configured jobs, and deploy build artifacts to Oracle Cloud using pre-configured deployment configurations.
When you define a project template, you define its visibility (who can use the project template), configure rules (what data can be copied from the project template), and use variables (customize actions based on user input).
After a project is created using a template, any updates made to the template project are not reflected in the created project.
The following table lists artifacts that can be copied from the project template to the new project:
Artifact | Copied to the New Project |
---|---|
Git Repositories |
Yes External repositories of the project are not copied by default. To copy them to the new project, add an additional rule. See Adding or Editing an External Git Repository Rule. |
Maven repository and artifacts |
No |
Environments |
No |
Releases |
No |
Snippets |
No |
Merge Requests |
No |
Issues |
No |
Agile boards |
No |
Build jobs |
Yes User credentials used in the job configuration are not copied. |
Deployment configurations |
Yes |
Linked Docker registries |
No |
Wiki pages |
Yes |
Announcements |
Yes |
Links |
Yes |
Tags |
No |
Webhooks |
No |
RSS/Atom Feeds |
No |
Project Template’s Visibility
A project template’s visibility can be in one of the following states: Draft, Private, or Shared.
-
Draft
The project template is under design and is not available in the Templates page of the Create Project wizard.
-
Private
The project template is available to organization users, but is not visible by name. It can be accessed through its private key only.
It is visible by name to all members of the project template.
-
Shared
The project template is a shared template and is available to all users of the organization.
About Project Template Rules
Using project template’s rules, you define what data is copied to the new project. When you define a project as a project template, all rules are enabled by default.
Some rules can't be edited and some rules can’t be added more than once. The following table lists rules available in a project template:
Rule | Description | Edit? | Add more than once? |
---|---|---|---|
Build Jobs |
Copies all build jobs of the project template to the new project. |
No |
No |
Wiki Content |
Copies all wiki pages of the project template to the new project. |
No |
No |
Links |
Copies all link rules of the project template to the new project. |
No |
No |
Git Repository |
Copies the specified Git repository along with its branches to the new project. |
Yes |
Yes |
External Git Repository |
Copies the specified external Git repository along with its branches to the new project. |
Yes |
Yes |
Deployments |
Copies all deployment configurations of the project template to the new project. |
No |
No |
Announcements |
Copies all announcements of the project template to the new project. |
No |
No |
As described in the above table, Git repository rules can be added more than once, while other rules can be added only once. You can add a Git repository rule for each repository and edit the rule to change the default behavior of copying Git repository files to the new project.
Project Template Variables
Using variables in a project template, you can get user input in the Create Project wizard. Based on the input, you can change the behavior or properties of data copied to the new project.
Variables, if defined, are available in the Properties page of the Create Project wizard. You can also use them while configuring Git repository rules.
The following types of variables are available.
-
Boolean
Accepts a True-False (or Yes-No) value.
-
Choice
Accepts a value from a list of values.
-
String
Accepts a string value.
-
URL
Accepts a valid URL value.
Defining a Project Template
You can specify an existing project to be used as a template from the Administration: Properties page
Defining a Private Project Template
Private project templates are not listed by name in the Templates page of the New Project wizard, unless you are a member of the project template. Non-members can use a private project template only if they have the private key of the project template.
To generate a new private key, edit the project template, click Show, and then click Regenerate. You may want to do this if you do not want users who already have the old key value to copy the project data from the template.
Defining a Project Template with an External Git Repository
You can define a project template with external Git repositories, such as GitHub or BitBucket. In the Create Project wizard, when the project template is selected, the external Git repositories are also copied to the new project.
Using Project Template Rules
You can add, edit, and remove rules of a template. Only Git repository rules can be edited and added more than once. Other rules can’t be edited or added more than once.
Adding a Rule
-
In the navigation bar, click Administration.
-
Click Properties.
-
In the Template section, click Edit.
-
In the Rules section, click Add Rule. From the menu, select the rule.
Deleting a Rule
-
In the navigation bar, click Administration.
-
Click Properties.
-
In the Template section, click Edit.
-
In the Rules section, to the right of the rule you want to remove, click Remove
.
Using Variables
You can add or edit variables from the Variables section on the Template page.
Adding a Variable
-
In the navigation bar, click Administration.
-
Click Properties.
-
In the Template section, click Edit.
-
In the Variable section, click Add Variable. From the menu, select the variable type.
-
Fill in the fields of the variable and click Save
.
Editing a Variable
-
In the navigation bar, click Administration.
-
Click Properties.
-
In the Template section, click Edit.
-
In the Variable section, click Edit
.
-
Update the fields of the variable and click Save
.
Deleting a Variable
-
In the navigation bar, click Administration.
-
Click Properties.
-
In the Template section, click Edit.
-
In the Variable section, to the right of the variable you want to remove, click Remove
.
Deleting a Project Template
Deleting a project template removes the template’s definition that includes its settings, rules, and variables. The project data is not deleted.
- In the navigation bar, click Administration.
- Click Properties.
- In the Template section, click Delete Template.
- In the Delete Template Definition dialog box, click Delete Template.