Oracle by Example brandingCreate a Project and Import a Git Repository in Visual Builder Studio

section 0Before You Begin

This 10-minute tutorial shows you how to create a project in Oracle Visual Builder Studio (VB Studio) and import a Node.js microservice application's source code files from a GitHub repository.

Background

Oracle Visual Builder Studio (VB Studio) is a DevOps and lifecycle management tool, and provides the infrastructure to help you build and deploy apps.

A VB Studio project is a collection of Git repositories, branch merge requests, wikis, issues, deployment configurations, and builds.

What Do You Need?

  • A web browser
  • Your Oracle Cloud account credentials
  • Access to a VB Studio instance
  • DEVELOPER_ADMINISTRATOR identity domain role assigned to you

section 1Open the VB Studio Console

You can sign in to VB Studio from the Oracle Cloud console page.

  1. In a web browser's address bar, enter https://cloud.oracle.com/sign-in.
  2. In Cloud Account Name, enter your Oracle Cloud account name and click Next.

    Example:

    Description of oracle_cloud_account.png follows
    Description of the illustration oracle_cloud_account.png
  3. On the Single Sign-On page, click Continue.
  4. On the Oracle Cloud Account Sign In page, enter your Oracle Cloud username and password, and then click Sign In.
    Description of oracle_cloud_sign_in.png follows
    Description of the illustration oracle_cloud_sign_in.png
  5. In the upper-left corner, click Navigation Menu Menu icon and select OCI Classic Services.
  6. Under Platform Services, select Developer.
    Description of navmenu_developer.png follows
    Description of the illustration navmenu_developer.png
  7. In the Instances tab, click Manage this instanceAction menu and select Access Service Instance.
    Description of vbstudio_instance.png follows
    Description of the illustration vbstudio_instance.png

section 2Create a Project

  1. On the Organization page, click + Create.
  2. On the Project Details page of the New Project wizard, enter these values and click Next.
    • Name: My Nodejs App
    • Description: Node.js REST microservice application
    Description of projectwizard_projectdetails.png follows
    Description of the illustration projectwizard_projectdetails.png
  3. On the Template page, select Initial Repository and click Next.
    Description of projectwizard_template.png
    Description of the illustration projectwizard_template.png
  4. On the Initial Repository Project Properties page, in Initial Repository, select Import existing repository.
  5. In the text box, enter https://github.com/oraclevbstudio/my_nodejs_app.git
    Description of projectwizard_projectproperties.png
    Description of the illustration projectwizard_projectproperties.png
  6. From the Wiki Markup drop-down list, select Markdown and click Finish.

Wait for the project's provisioning to complete. After provisioning completes, the Project Home page opens.

Description of project_home.png
Description of the illustration project_home.png

In the Repositories tab, click the Git repository's name to view these imported files:

  • main.js: The main Node.js file with these functions:
    • A get function that outputs a static Hello World message and a false error message
    • A post function that adds two numbers passed as input at runtime

    The app uses Node.js modules express and bodyParser to create the REST service.

  • package.json: The JSON file that defines the app's name as NodeJSMicro, and bodyParser and express as its dependencies.
  • README.md: The Readme wiki file
Description of imported_files.png
Description of the illustration imported_files.png

The project's Project Owner role is also granted to you. In the navigation menu, click Project Home and then click the Team tab to verify the Project Owner label next to your name.

Description of project_team.png
Description of the illustration project_team.png