Getting started with SourceBuild

Available in Classic and VPC

Getting started with SourceBuild checks the environmental requirements for SourceBuild, guides you through the usage scenarios and glossaries, and describes what you have to for the normal use of SourceBuild. The content covered in Getting started with SourceBuild 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.

• SourceCommit of NAVER Cloud Platform
• GitHub
• Bitbucket
• GitHub Enterprise

Commit code with SourceCommit

To commit code using NAVER Cloud Platform's SourceCommit, follow these steps:

1. Access NAVER Cloud Platform console.
2. Click Services > Developer Tools > SourceCommit, in order.
3. Click the [Create repository] button.
4. Enter the repository name and description, select initialization settings, and then click the [Next] button.
5. Select whether to integrate with File Safer which is a security service, and then click the [Next] button.
6. After checking the final information, click the [Create] button.

Create Object Storage bucket

To create Object Storage buckets to store build outputs, follow these steps:

1. Access NAVER Cloud Platform console.
2. Click the Services > Storage > Object Storage menus, in that order.
3. Click the [Subscribe] button.
4. When the Subscribe popup window appears, click the [Apply] button.
5. Click the Bucket Management menu.
6. Click the [Create bucket] button.
7. Enter a name for the bucket to create, and then click the [Next] button.
8. Set the permission for the use of the bucket, and then click the [Next] button.
9. Select the statuses of locking and encryption of the saving target, and then click the [Next] button.
10. After checking the final information, click the [Create bucket] button.

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, follow these steps:

1. Access NAVER Cloud Platform console.
2. Click the Services > Containers > Container Registry menus, in that order.
3. Click the [Create registry] button.
4. After entering the name of the cluster to be created, select the Object Storage bucket with which you want to integrate, and then click the [Create] button.
   • You can connect 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.

• Customer account: can use all SourceBuild functions without limits
• Sub account created by customer: one of the following permissions is required to use SourceBuild
  • NCP_INFRA_MANAGER: can use all services in NAVER Cloud Platform including SourceBuild, same as the customer account. However, some management features of My page are excluded.
  • NCP_SOURCEBUILD_MANAGER: can use all features in SourceBuild

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, follow these steps:

1. In the NAVER Cloud Platform console, click Services > Developer Tools > SourceBuild, in order.
2. Click the [Create build project] button.
3. Check if Object Storage is selected as In use in Required preparations, and then click the [Next] button.
4. Enter a name for the build project to create, select the build target, and then click the [Next] button.
   • 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 the [Next] button.
   • 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 the [Next] button.
7. Set whether to save build outputs and completed images, and then click the [Next] button.
8. Select whether to integrate with Cloud Log Analystics for storing build logs and File Safer for scanning malicious code in outputs, and the click the [Next] button.
9. After confirming the information you entered, click the [Create] button.