Getting started

Prev Next

Available in Classic and VPC

Getting started checks the environmental requirements for SourceBuild, guides you through the quickstart and glossary, and describes what you have to for the normal use of SourceBuild. The content covered in Getting started is as follows:

  • How to prepare a source code
  • How to create Object Storage buckets
  • How to integrate with Container Registry
  • How to set the user permissions required for the use of SourceBuild
  • How to create a build project

Prepare source code

You can prepare the source code to be built from each repository.

Commit code with SourceCommit

To commit code using NAVER Cloud Platform's SourceCommit:

Caution
  • This section introduce the simple way to commit code. For the complete commit methods, see SourceCommit user guide.
  • Charges may apply depending on the usage. For more information about the service pricing information, see About SourceCommit on the portal.
  1. Access the NAVER Cloud Platform console.
  2. Click Region and Platform at the top right of the console screen.
  3. Select the region and platform currently in use, and then click [Apply].
  4. Click i_menu at the top left of the console screen.
  5. Navigate to Services > Developer Tools > SourceCommit.
  6. Click [Create repository].
  7. Enter the repository name and description, select initialization settings, and then click [Next].
  8. Select whether to integrate with File Safer which is a security service, and then click [Next].
  9. After checking the final information, click [Create].

Create Object Storage bucket

To create Object Storage buckets to store build outputs:

Caution
  • In this section, we will briefly introduce how to create a bucket. For the complete creation methods, see Object Storage user guide.
  • Charges may apply depending on the usage. For more information about the service pricing information, see About Object Storage on the portal.
  1. From NAVER Cloud Platform console, navigate to i_menu > Services > Storage > Object Storage.
  2. Click [Subscribe].
  3. When the Subscribe popup appears, click [Apply].
  4. Click the Bucket Management menu.
  5. Click [Create bucket].
  6. Enter the name of the bucket you're going to create and then click [Next].
  7. Set the permission for the use of the bucket, and then click [Next].
  8. Select the statuses of locking and encryption of the saving target, and then click [Next].
  9. After checking the final information, click [Create bucket].

Integrate with Container Registry

After the build is complete, to store the build environment as an image, create a registry in Container Registry of NAVER Cloud Platform and integrate the registry with Object Storage. To enable Container registry service:

Caution
  • This section briefly introduces how to integrate with Container Registry. For the complete integration methods, see Container Registry user guide.
  • Charges may apply depending on the usage. For more information about the service pricing information, see About Container Registry on the portal.
  1. From the NAVER Cloud Platform console, navigate to i_menu > Services > Containers > Container Registry.
  2. Click [Create registry].
  3. After entering the name of the cluster to be created, select the Object Storage bucket with which you want to integrate, and then click [Create].
    • You can integrate only one registry to a bucket.

Set user permissions

Check the SourceBuild permissions for your login account and set the sub account permissions in Services > Management & Governance > Sub Account from the console as needed.

  • Your account: You can use all SourceBuild features without limits.
  • Your sub account: Requires one of the following permissions to use SourceBuild:
    • NCP_INFRA_MANAGER: Permission to access all services, except that access to the console menu My Account > Manage billing information and expense > Manage billing and payment is restricted
    • NCP_SOURCEBUILD_MANAGER: Full access to all SourceBuild features
Note

To set detailed permissions for each action in the sub account, see the following documentations:

Create build project

If you have prepared the source code, bucket, and registry and set permissions, create a build project on the console. To create a build project:

Caution

This section briefly introduces how to create a build project. For the complete creation methods, see Create build project.

  1. From the NAVER Cloud Platform console, navigate to Services > Developer Tools > SourceBuild.
  2. Click [Create build project].
  3. Check if Object Storage is selected as In use in Required preparations, and then click [Next].
  4. Enter a name for the build project to create, select the build target, and then click [Next].
    • Select the repository in which the source code for the build target is stored from SourceCommit, GitHub, Bitbucket, and Github Enterprise Server.
    • When selecting GitHub, Bitbucket, or Github Enterprise Server, log in to integrate the service and select the detailed path.
  5. Select a build environment image, set up the build environment, and then click [Next].
    • Select the source of the build environment from SourceBuild, Container Registry, and Public Registry
    • Set up and enter detailed items depending on the image source you selected
  6. Set commands to proceed with a build, and then click [Next].
  7. Set whether to save build outputs and completed images, and then click [Next].
  8. Select whether to integrate with Cloud Log Analytics for storing build logs and File Safer for scanning malicious code in outputs, and the click [Next].
  9. After confirming the information you entered, click [Create].