Getting started

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 do to use SourceBuild properly. Getting started describes the following:

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

Prepare source code

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

• NAVER Cloud Platform's SourceCommit
• GitHub
• Bitbucket
• GitHub Enterprise

Commit code with SourceCommit

To commit code using NAVER Cloud Platform's SourceCommit:

1. Access the NAVER Cloud Platform console.
2. In the top-right corner, click Region & Platform.
3. Select your region and platform, then click [Apply].
4. In the top-left corner, click Menu.
5. Navigate to All 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, 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 artifacts:

1. In the NAVER Cloud Platform console, navigate to Menu > All 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 to create, and then click [Next].
7. Set permissions to use the bucket, and then click [Next].
8. Select whether to enable locking and encryption for stored objects, 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 NAVER Cloud Platform's Container Registry and integrate it with Object Storage. To integrate Container Registry:

1. In the NAVER Cloud Platform console, navigate to Menu > All Services > Containers > Container Registry.
2. Click [Create registry].
3. After entering the name of the registry to be created, select the Object Storage bucket with which you want to integrate, and then click [Create].
   • You can integrate only one registry with a bucket.

Set user permissions

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

• Your account: Full access to all SourceBuild features
• Sub accounts created by you: Requires one of the following permissions to use SourceBuild:
  • NCP_INFRA_MANAGER: Access to all services, except for the My Account > Manage billing information and expense > Manage billing and payment menu on the console
  • NCP_SOURCEBUILD_MANAGER: Full access to all SourceBuild features

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:

1. In the NAVER Cloud Platform console, navigate to Menu > All Services > Developer Tools > SourceBuild.
2. Click [Create build project].
3. Check if Object Storage is selected as In use in Prerequisites, and 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 image from SourceBuild, Container Registry, or Public Registry.
   • Set up and enter detailed items based on the selected image source.
6. Set commands to proceed with a build, and then click [Next].
7. Set whether to save build artifacts 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 then click [Next].
9. After confirming the entered information, click [Create].