Creating a Project

Create a DevOps project to group the resources required to implement a CI/CD workflow.

Each service in Oracle Cloud Infrastructure (OCI) integrates with Identity and Access Management (IAM) for authentication and authorization, for all interfaces (the Console, SDK and CLI, and REST API). Before you begin using the DevOps service, you must create policies to control who has access to DevOps, and the type of access for each group of users.

For details about writing policies for the DevOps service and policy examples, see DevOps IAM Policies.

You must create a topic  for project notification. See Managing Topics and Subscriptions.

For accessing DevOps using the Oracle Cloud Console, REST API, and CLI, see Accessing DevOps.

    1. Open the navigation menu and click Developer Services. Under DevOps, click Projects.
    2. From the left-side menu, select a compartment that you have permission to work in.
      For more information, see Authentication and Authorization.
    3. On the DevOps Projects page, click Create devops project.
    4. On the Create new devops project panel, enter the following information:
      1. Enter a name for the project.
      2. (Optional) Enter a description.
      3. To set up project notifications, click Select Topic.

        Project notifications keep you apprised of important events and the latest project status. They also alert you if you need to take any necessary action such as approving a workflow. You must create a topic  and add subscription  to the topic. See Managing Topics and Subscriptions.
        • For selecting topic using topic name, select a Compartment and an associated Topic.
        • For selecting topic using Oracle Cloud Identifier (OCID), enter OCID of the topic.
    5. (Optional) To add tags to the project, click Show tagging options. Tagging is a metadata system that lets you organize and track the resources in your tenancy.

      If you have permissions to create a resource, you also have permissions to add free-form tags to it.

      To add a defined tag, you must have permissions to use the tag namespace.

      For more information, see Resource Tags.

    6. Click Create DevOps project.

    The DevOps project is created successfully. You can configure required resources such as code repositories, build pipelines, artifact references, target environments, and deployment pipelines.


    To run build and deployment pipelines, you must enable logging for the project. To enable logging, see DevOps Logs.
  • To create a DevOps project, run the create command:

    oci devops project create

    Required parameters for the create command:

    • --compartment-id -c
    • --name
    • --notification-config

    To get all the commands for project:

    oci devops project -h

    To get help for the create command:

    oci devops project create -h
  • To create a DevOps project, use the CreateProject operation.