기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS CodeCommit 리포지토리에서 파일 작업하기
CodeCommit에서 파일은 버전이 관리되고 독립적으로 작동하는 정보입니다. 본래의 사용자 외에, 해당 파일이 저장된 리포지토리와 브렌치의 다른 사용자들도 이용할 수 있습니다. 사용자는 개인용 컴퓨터처럼 디렉터리 구조를 활용하여 리포지토리 파일을 정리할 수 있습니다. CodeCommit은 개인용 컴퓨터와 달리 파일에 대한 모든 변경 내용을 자동으로 추척합니다. 사용자는 파일의 버전을 비교할 수 있으며 서로 다른 버전의 파일을 서로 다른 리포지토리 브랜치에 저장할 수 있습니다.
리포지토리에 파일을 추가하거나 기존 파일을 편집할 때는 Git 클라이언트를 활용합니다. CodeCommit 콘솔, AWS CLI, CodeCommit API 등을 이용할 수도 있습니다.
![\[CodeCommit 콘솔에서 파일을 생성하는 화면\]](http://docs.aws.amazon.com/ko_kr/codecommit/latest/userguide/images/codecommit-create-file.png)
CodeCommit에서 리포지토리의 다른 측면을 다루는 방식에 대해 자세히 알아보려면 [리포지토리 작업](repositories.md), [풀 요청 작업](pull-requests.md), [브랜치 작업](branches.md), [커밋 작업](commits.md), [사용자 기본 설정으로 작업](user-preferences.md) 섹션을 참조하세요.
**Topics**
+ [AWS CodeCommit 리포지토리의 파일 찾아보기](how-to-browse.md)
+ [AWS CodeCommit 리포지토리에 파일 생성 또는 추가](how-to-create-file.md)
+ [AWS CodeCommit 리포지토리에서 파일의 콘텐츠 편집](how-to-edit-file.md)
# AWS CodeCommit 리포지토리의 파일 찾아보기
CodeCommit 리포지토리에 연결한 후, CodeCommit 리포지토리를 로컬 리포지토리에 복제하거나 CodeCommit 콘솔을 사용하여 그 콘텐츠를 검색할 수 있습니다. 이 주제에서는 CodeCommit 콘솔을 사용하여 CodeCommit 리포지토리의 콘텐츠를 검색하는 방법에 대해 설명합니다.
**참고**
활성 CodeCommit 사용자는 CodeCommit 콘솔에서 코드를 검색하는 데 요금이 부과되지 않습니다. 요금이 부과될 수 있는 상황에 대해 자세히 알아보려면 [요금](https://aws.amazon.com/codecommit/pricing/)을 참조하세요.
![\[CodeCommit 콘솔에서 파일의 콘텐츠 보기\]](http://docs.aws.amazon.com/ko_kr/codecommit/latest/userguide/images/codecommit-code-browse-file.png)
## CodeCommit 리포지토리 탐색
CodeCommit 콘솔을 사용하여 특정 리포지토리에 포함된 파일을 검토하거나 파일의 콘텐츠를 빠르게 훑어볼 수 있습니다.
**리포지토리의 콘텐츠를 검색하려면**
1. [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home)에서 CodeCommit 콘솔을 엽니다.
1. **리포지토리** 페이지의 리포지토리 목록에서 검색하려는 리포지토리를 선택합니다.
1. **코드** 보기에서 리포지토리의 기본 브랜치의 콘텐츠를 검색합니다.
보기를 다른 브랜치나 태그로 변경하려면 보기 선택 버튼을 선택합니다. 드롭다운 목록에서 브랜치나 태그 이름을 선택하거나 필터 상자에서 브랜치나 태그 이름을 입력한 다음, 목록에서 선택합니다.
1. 다음 중 하나를 수행합니다.
+ 디렉터리의 콘텐츠를 보려면 목록에서 선택합니다. 탐색 목록에서 아무 디렉터리나 선택하면 해당 디렉터리 보기로 돌아갈 수 있습니다. 디렉토리 목록 상단에 있는 위쪽 화살표를 활용할 수도 있습니다.
+ 파일의 콘텐츠를 보려면 목록에서 선택합니다. 파일이 커밋 객체 한도보다 크면 콘솔에 표시할 수 없으며, 해당 파일은 대신 로컬 리포지토리에서 봐야 합니다. 자세한 내용은 [할당량](limits.md) 단원을 참조하십시오. 파일 보기를 종료하려면, 코드 탐색 표시줄에서 살펴보고 싶은 디렉터리를 선택합니다.
**참고**
콘솔에서 모든 바이너리 파일을 볼 수 있는 것은 아닙니다. 이진 파일을 선택하고 그 파일을 잠재적으로 볼 수 있는 경우, 콘텐츠를 표시할 것인지 여부를 확인하라는 경고 메시지가 나타납니다. 파일을 보려면 **파일 콘텐츠 표시**를 선택합니다. 파일을 보지 않으려면 코드 탐색 표시줄에서 살펴보고 싶은 디렉터리를 선택합니다.
마크다운 파일(.md)을 선택한 경우, **렌더링된 마크다운** 및 **마크다운 소스** 버튼을 사용하여 렌더링된 뷰와 구문 뷰 사이를 전환할 수 있습니다. 자세한 내용은 [콘솔에서 마크다운 사용하기](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/aws-markdown.html)를 참조하세요.
# AWS CodeCommit 리포지토리에 파일 생성 또는 추가
CodeCommit 콘솔, AWS CLI, 또는 Git 클라이언트를 사용하여 리포지토리에 파일을 추가할 수 있습니다. 로컬 컴퓨터에서 리포지토리로 파일을 업로드하거나, 콘솔의 코드 편집기를 사용하여 파일을 생성할 수 있습니다. 편집기를 사용하면 readme.md 파일과 같은 간단한 파일을 리포지토리의 브랜치에 빠르고 쉽게 추가할 수 있습니다.
![\[CodeCommit 콘솔에서 파일 업로드 보기\]](http://docs.aws.amazon.com/ko_kr/codecommit/latest/userguide/images/codecommit-commit-first-file.png)
**Topics**
+ [파일 생성 또는 업로드 (콘솔)](#how-to-create-file-console)
+ [파일 추가 (AWS CLI)](#how-to-create-file-cli)
+ [파일 추가 (Git)](#how-to-create-file-git)
## 파일 생성 또는 업로드 (콘솔)
CodeCommit 콘솔을 사용하여 파일을 생성하고 CodeCommit 리포지토리의 브랜치에 추가할 수 있습니다. 파일 생성 과정 중에 사용자 이름과 이메일 주소를 입력할 수 있습니다. 또한 파일을 추가한 사용자와 그 이유를 다른 사용자가 파악할 수 있도록 커밋 메시지를 추가할 수도 있습니다. 로컬 컴퓨터에서 리포지토리의 브랜치로 직접 파일을 업로드할 수도 있습니다.
**리포지토리에 파일을 추가하려면**
1. [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home)에서 CodeCommit 콘솔을 엽니다.
1. **리포지토리**에서 파일을 추가할 리포지토리를 선택합니다.
1. **코드** 보기에서 파일을 추가할 브랜치를 선택합니다. **코드** 보기를 열면 기본 브랜치의 콘텐츠가 표시되도록 기본 설정되어 있습니다.
보기를 다른 브랜치로 변경하려면 보기 선택 버튼을 선택합니다. 드롭다운 목록에서 브랜치 이름을 선택하거나 필터 상자에서 브랜치 이름을 입력한 다음, 목록에서 선택합니다.
1. **파일 추가**를 선택하고 다음 옵션 중 하나를 선택합니다.
+ 코드 편집기를 사용하여 파일의 콘텐츠를 만들고 리포지토리에 추가하려면 **파일 생성**을 선택합니다.
+ 로컬 컴퓨터에서 리포지토리로 파일을 업로드하려면 **파일 업로드**를 선택합니다.
1. 이 파일을 리포지토리에 추가한 사람과 그 이유에 대한 정보를 다른 사용자에게 제공합니다.
+ **작성자 이름**에 이름을 입력합니다. 이 이름은 커밋 정보에서 작성자 이름과 커미터 이름으로 모두 사용됩니다. CodeCommit은 IAM 사용자 이름이나 콘솔 로그인의 파생물을 작성자 이름으로 사용하도록 기본 설정되어 있습니다.
+ **이메일 주소**에는 다른 리포지토리 사용자가 이러한 변경에 대해 문의할 수 있도록 이메일 주소를 입력합니다.
+ **커밋 메시지**에는 간단한 설명을 입력합니다. 이는 선택 사항이지만 적극 권장됩니다. 입력하지 않을 경우, 기본 커밋 메시지가 사용됩니다.
1. 다음 중 하나를 수행합니다.
+ 파일을 업로드하는 경우에는 로컬 컴퓨터에서 파일을 선택합니다.
+ 파일을 생성하려는 경우에는 추가할 콘텐츠를 코드 편집기에서 입력한 다음 파일의 이름을 제공합니다.
1. **변경 사항 커밋**을 선택합니다.
## 파일 추가 (AWS CLI)
AWS CLI와 **put-file** 명령을 사용하면 CodeCommit 리포지토리에 파일을 추가할 수 있습니다. **put-file** 명령을 사용하여 파일의 디렉터리 또는 경로 구조를 추가할 수도 있습니다.
**참고**
CodeCommit에서 AWS CLI 명령을 사용하려면 AWS CLI를 설치합니다. 자세한 내용은 [명령줄 참조](cmd-ref.md) 섹션을 참조하세요.
**리포지토리에 파일을 추가하려면**
1. 로컬 컴퓨터에서, CodeCommit 리포지토리에 추가할 파일을 생성합니다.
1. 터미널 또는 명령줄에서 다음을 지정하여 **put-file** 명령을 실행합니다.
+ 파일을 추가할 리포지토리.
+ 파일을 추가할 브랜치.
+ 해당 브랜치에서 수행된 가장 최근 커밋의 축약되지 않은 커밋 ID(팁 또는 헤드 커밋)
+ 파일의 로컬 위치. 이 위치에 사용되는 구문은 로컬 운영 체제에 따라 달라집니다.
+ 업데이트된 파일이 리포지토리에 저장된 경로(있는 경우)를 포함하여 추가할 파일의 이름.
+ 이 파일에 연결할 사용자 이름과 이메일.
+ 이 파일을 추가한 이유를 설명하는 커밋 메시지.
사용자 이름, 이메일 주소 및 커밋 메시지는 선택 사항이지만, 다른 사용자에게 변경을 수행한 사용자와 변경 이유를 알려줍니다. 사용자 이름을 제공하지 않는 경우, CodeCommit은 IAM 사용자 이름이나 콘솔 로그인 파생물을 작성자 이름으로 사용하도록 기본 설정되어 있습니다.
*예를 들어, *MyDemorepo*라는 리포지토리 내에 최근 커밋 ID가 4c925148EXAMPLE*이고 이름이 *feature-randomizationfeature*인 브랜치에 *ExampleSolution.py*라는 파일을 추가하려면 다음과 같이 합니다.
```
aws codecommit put-file --repository-name MyDemoRepo --branch-name feature-randomizationfeature --file-content file://MyDirectory/ExampleSolution.py --file-path /solutions/ExampleSolution.py --parent-commit-id 4c925148EXAMPLE --name "María García" --email "maría_garcía@example.com" --commit-message "I added a third randomization routine."
```
**참고**
바이너리 파일을 추가할 때는 반드시 `fileb://`를 사용하여 파일의 로컬 위치를 지정해야 합니다.
이 명령이 제대로 실행되면 다음과 비슷한 출력이 반환됩니다.
```
{
"blobId": "2eb4af3bEXAMPLE",
"commitId": "317f8570EXAMPLE",
"treeId": "347a3408EXAMPLE"
}
```
## 파일 추가 (Git)
로컬 리포지토리에서 파일을 추가해서 CodeCommit 리포지토리에 변경 내용을 푸시할 수 있습니다. 자세한 내용은 [Git 및 시작하기 AWS CodeCommit](getting-started.md) 섹션을 참조하세요.
# AWS CodeCommit 리포지토리에서 파일의 콘텐츠 편집
CodeCommit 콘솔 AWS CLI또는 Git 클라이언트를 사용하여 CodeCommit 리포지토리에 있는 파일의 콘텐츠를 편집할 수 있습니다.
![\[CodeCommit 콘솔에서 파일 편집 보기\]](http://docs.aws.amazon.com/ko_kr/codecommit/latest/userguide/images/codecommit-edit-file.png)
**Topics**
+ [파일 편집 (콘솔)](#how-to-edit-file-console)
+ [파일 편집 또는 삭제 (AWS CLI)](#how-to-edit-file-cli)
+ [파일 편집 (Git)](#how-to-edit-file-git)
## 파일 편집 (콘솔)
CodeCommit 콘솔을 사용하여 CodeCommit 리포지토리의 브랜치에 추가된 파일을 편집할 수 있습니다. 파일 편집 프로세스의 한 부분으로 사용자 이름과 이메일 주소를 입력할 수 있습니다. 또한 다른 사용자가 변경을 수행한 사용자와 변경 이유를 이해할 수 있도록 커밋 메시지를 추가할 수도 있습니다.
**리포지토리에서 파일을 편집하려면**
1. [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home)에서 CodeCommit 콘솔을 엽니다.
1. **리포지토리**에서 파일을 편집할 리포지토리를 선택합니다.
1. **코드** 보기에서 파일을 편집할 브랜치를 선택합니다. **코드** 보기를 열면 기본 브랜치의 콘텐츠가 표시되도록 기본 설정되어 있습니다.
보기를 다른 브랜치로 변경하려면 보기 선택 버튼을 선택합니다. 드롭다운 목록에서 브랜치 이름을 선택하거나 필터 상자에서 브랜치 이름을 입력한 다음, 목록에서 선택합니다.
1. 브랜치의 콘텐츠를 검색하고 편집할 파일을 선택합니다. 파일 보기에서 **편집**을 선택합니다.
**참고**
이진 파일을 선택하는 경우, 콘텐츠를 표시할 것인지 여부를 확인하라는 경고 메시지가 나타납니다. 이진 파일 편집에 CodeCommit 콘솔을 사용하면 안 됩니다.
1. 파일을 편집하고 이러한 변경을 수행한 사용자와 변경 이유에 대한 정보를 다른 사용자에게 제공합니다.
+ **작성자 이름**에 이름을 입력합니다. 이 이름은 커밋 정보에서 작성자 이름과 커미터 이름으로 모두 사용됩니다. CodeCommit은 IAM 사용자 이름이나 콘솔 로그인의 파생물을 작성자 이름으로 사용하도록 기본 설정되어 있습니다.
+ **이메일 주소**에는 다른 리포지토리 사용자가 이러한 변경에 대해 문의할 수 있도록 이메일 주소를 입력합니다.
+ **커밋 메시지**에 변경에 대한 간단한 설명을 입력합니다.
1. **변경 사항 커밋**을 선택하여 파일의 변경 사항을 저장하고 리포지토리에 커밋합니다.
## 파일 편집 또는 삭제 (AWS CLI)
AWS CLI 및 **put-file** 명령을 사용하여 CodeCommit 리포지토리의 파일을 변경할 수 있습니다. 또한 변경된 파일을 원래와 다른 위치에 저장하고 싶은 경우에는 **put-file** 명령을 사용하여 변경된 파일에 대한 디렉터리나 경로 구조를 추가할 수 있습니다. 파일을 완전히 삭제하려면 **delete-file** 명령을 사용하면 됩니다.
**참고**
CodeCommit에서 AWS CLI 명령을 사용하려면를 설치합니다 AWS CLI. 자세한 내용은 [명령줄 참조](cmd-ref.md) 단원을 참조하십시오.
**리포지토리에서 파일을 편집하려면**
1. 파일의 로컬 복사본을 사용하여 CodeCommit 리포지토리에 추가할 내용을 변경합니다.
1. 터미널 또는 명령줄에서 다음을 지정하여 **put-file** 명령을 실행합니다.
+ 편집된 파일을 추가할 리포지토리.
+ 편집된 파일을 추가할 브랜치.
+ 해당 브랜치에서 수행된 가장 최근 커밋의 축약되지 않은 커밋 ID(팁 또는 헤드 커밋)
+ 파일의 로컬 위치.
+ 업데이트된 파일이 리포지토리에 저장된 경로(있는 경우)를 포함하여 추가할 업데이트 파일의 이름.
+ 이 파일 변경에 연결할 사용자 이름과 이메일.
+ 수행한 변경을 설명하는 커밋 메시지.
사용자 이름, 이메일 주소 및 커밋 메시지는 선택 사항이지만, 다른 사용자에게 변경을 수행한 사용자와 변경 이유를 알려줍니다. 사용자 이름을 제공하지 않는 경우, CodeCommit은 IAM 사용자 이름이나 콘솔 로그인 파생물을 사용하도록 기본 설정됩니다.
*예를 들어, *MyDemorepo*라는 리포지토리 내에 최근 커밋 ID가 4c925148EXAMPLE*이고 이름이 *feature-randomizationfeature*인 브랜치에 *ExampleSolution.py*라는 파일을 편집한 내용을 추가하려면 다음과 같이 합니다.
```
aws codecommit put-file --repository-name MyDemoRepo --branch-name feature-randomizationfeature --file-content file://MyDirectory/ExampleSolution.py --file-path /solutions/ExampleSolution.py --parent-commit-id 4c925148EXAMPLE --name "María García" --email "maría_garcía@example.com" --commit-message "I fixed the bug Mary found."
```
**참고**
변경된 이진 파일을 추가하려면 `fileb://MyDirectory/MyFile.raw` 표기법을 따르는 `--file-content`를 사용해야 합니다.
이 명령이 제대로 실행되면 다음과 비슷한 출력이 반환됩니다.
```
{
"blobId": "2eb4af3bEXAMPLE",
"commitId": "317f8570EXAMPLE",
"treeId": "347a3408EXAMPLE"
}
```
파일을 삭제하려면 **delete-file** 명령을 사용합니다. 예를 들어, *MyDemoRepo*라는 리포지토리에서 최근 커밋 ID가 *c5709475EXAMPLE*이고 이름이 main인 브랜치에서 *README.md*라는 파일을 삭제하려면 다음과 같이 합니다.**
```
aws codecommit delete-file --repository-name MyDemoRepo --branch-name main --file-path README.md --parent-commit-id c5709475EXAMPLE
```
이 명령이 제대로 실행되면 다음과 비슷한 출력이 반환됩니다.
```
{
"blobId":"559b44fEXAMPLE",
"commitId":"353cf655EXAMPLE",
"filePath":"README.md",
"treeId":"6bc824cEXAMPLE"
}
```
## 파일 편집 (Git)
로컬 리포지토리에서 파일을 편집해서 CodeCommit 리포지토리에 변경 내용을 푸시할 수 있습니다. 자세한 내용은 [Git 및 시작하기 AWS CodeCommit](getting-started.md) 단원을 참조하십시오.