Create and manage repositories

This page describes how to create repositories and manage code and settings in Codeflow.

Create repository

A repository is a space for storing source code and managing history.

1. Go to the KakaoCloud console > Developer Tools > Codeflow.

2. From the Repository menu, click [Create repository].

3. Enter the required information, then click [Create].

   Item	Description
   Name	Repository name
   Description	Repository description, up to 100 characters
   Default branch name	The default is main, and you can change it if needed.
   Approval rule	Configure pull request merge conditions. - Single approval: The pull request can be merged when one of the specified reviewers approves it. - All agreement: The pull request can be merged only when all specified reviewers approve it.

4. From the Repository menu, check the created repository.

Import external repository

Repositories from other Git repositories, such as GitHub and GitLab, can be imported into a Codeflow repository through mirror push.

1. Create a repository to import the code into.
2. Clone the source repository as a bare repository, then mirror push it to the Codeflow repository.

git clone --bare ${SOURCE_REPOSITORY_URL}
cd ${REPOSITORY_NAME}.git
git push --mirror ${CODEFLOW_REPOSITORY_URL}

Parameter	Description
SOURCE_REPOSITORY_URL	Source repository URL
REPOSITORY_NAME	Source repository name
CODEFLOW_REPOSITORY_URL	Codeflow repository URL - You can check it in the list in the Repository menu

3. After the push is complete, check the Code and Commits tabs of the repository to verify that branches, tags, and commit history have been reflected correctly.

Guide

• IAM access key authentication is required when pushing to a Codeflow repository. For more information, see Create access key.
• Importing a large repository may take time.
• For repositories with many references such as branches and tags, some references may not be reflected. In this case, push branches and tags in separate stages, then check whether the number of branches and tags matches the source repository.
• If you do not need the full commit history, you can reduce the time required by cloning and importing only recent history.

View repository

1. Go to the KakaoCloud console > Developer Tools > Codeflow.

2. From the Repository menu, view the repository list.

   In the list, you can check each repository's name, description, URL, last commit time, and creation time.

   Git authentication

   You can clone source code or connect a remote repository by using the repository URL. IAM access key authentication is required for Git clone.

   • Username: IAM access key ID
   • Password: Secret access key
   • For more information, see Create access key.

3. Select a repository to go to its details page. The details page consists of the following tabs.

   Tab	Description
   Details	Basic information such as name, description, URL, approval rule, language, and creation time
   Code	Browse file and folder lists, modification time, size, and other basic information
   Commits	Commit list and basic information such as ID, message, and author
   Pull requests	Pull request list, status, and approval status
   Workflows	Workflow files, execution history, and management
   Action settings	Repository token, runners, and repository variable management

   info

   In the dropdown at the upper-right of the repository page, select Branches or Tags to check Code and Commits information based on the selected reference.

Code

You can browse repository folders and files and check each item's path, last modified time, size, and type.

Files can be downloaded individually from the [⋮] button, but folders cannot be downloaded. To download all code, use the [Download] button on the right side of the screen.

Select a file to go to the file details page. You can check the name, path, latest commit information, file contents, and commit history. File contents are provided as Preview or Code view, and you can download the file.

Guide

• Some view modes may not be provided depending on the file format.
• Files larger than 10 MB have limited view modes, so download the file to check it.

Commits

You can check commit ID, message, author, and commit time.

Select a commit ID to go to the commit details page. You can check the changed file list, diff, and change statistics. Changes are provided in Unified view or Split view.

• Click file view to go to the file details page for that file.
• You can download patch files (.patch) and diff files (.diff).
• You can create a branch or create a tag based on the commit.

Guide

Diff files larger than 1 MB have limited view modes. Use a local Git client to check the changes.

Pull requests

In the pull request list, you can check the base branch (merge target), work branch (branch containing changes), status, and approval status.

Status indicates pull request progress, and Approval status indicates reviewer review results.

Approval status	Status	Description
Pending	OPEN	Approval or review is in progress
Approved	OPEN	Approval conditions have been met
Rejected	OPEN	The pull request was not approved and was rejected
Merged	CLOSED	The pull request was approved and merged into the base branch
Canceled	CLOSED	The pull request was canceled

The creator can cancel, merge, or delete a pull request from the [⋮] button.

Guide

Pull request reviews, such as approval, review cancellation, and rejection, can be performed on the pull request details page. For more information, see Create and manage pull requests.

Workflows

You can check workflow file lists and execution history. For how to run workflow files, cancel execution, check logs, and delete execution history, see Manage workflows.

Action settings

You can manage repository tokens, runners, and repository variables. For runner registration and execution and repository variable management, see Action settings.

Modify repository settings

You can modify the repository name, description, default branch, and approval rule.

1. Go to the KakaoCloud console > Developer Tools > Codeflow.
2. From the Repository menu, click the [⋮] button for the target repository and select the menu for the item to modify.
   • Name, description: Change information
   • Default branch: Modify default branch
   • Approval rule: Modify approval rule
3. After completing the change, click [Save] or [Modify].

Guide

If you modify the repository approval rule, the changed rule applies only to pull requests created afterward.

Delete repository

Caution

Deleted repositories cannot be recovered. All data, including stored code, commit history, and pull requests, is permanently deleted.

1. Go to the KakaoCloud console > Developer Tools > Codeflow.
2. From the Repository menu, select [⋮] button > Delete for the target repository.
3. In the popup, enter the deletion phrase and click [Delete].