---
title: 명령 줄 인터페이스 설정
slug: docs-kr/local-development/parse-cli
description: Back4app CLI로 앱 관리 및 클라우드 코드 배포 과정을 설명합니다. 설치 가이드 포함.
image: https://www.back4app.com/_public/img/back4app-og.png
createdAt: 2024-01-25T15:38:03.681Z
---

Back4app 명령줄 인터페이스(CLI)는 앱 관리, 코드 배포 및 클라우드 기능을 터미널에서 직접 처리할 수 있는 강력한 도구입니다. 이 가이드는 설치, 구성 및 시작하는 데 필요한 주요 기능을 안내합니다.

## Back4app CLI로 할 수 있는 것

- Back4app 애플리케이션 생성 및 관리.
- 클라우드 코드 기능 및 기타 로컬 파일 배포.
- 앱 버전 및 릴리스 관리.
- 웹 애플리케이션 배포.
- NPM 모듈 설치 및 관리.

## 1  - 설치

### 전제 조건

:::hint{type="info"}
- Back4app 계정. [여기에서 가입](https://www.back4app.com).
- 당신의 컴퓨터에 Python.
:::

### macOS 및 Linux용

**옵션 1: 스크립트를 통해 설치**

1. 터미널을 열고 실행:

:::BlockQuote
curl https\://raw\.githubusercontent.com/back4app/parse-cli/back4app/installer.sh | sudo /bin/bash
:::

    2\.  도구는 `b4a`로 설치됩니다 `/usr/local/bin/b4a.`

**옵션 2: 수동 설치**

1. 시스템 아키텍처를 확인하려면 다음을 실행하세요:

:::BlockQuote
<u>uname -pm</u>
:::

&#x20;   2\.  시스템에 맞는 올바른 실행 파일을 [이 저장소에서](https://github.com/back4app/parse-cli/blob/back4app/installer.sh) 다운로드하세요.

&#x20;   3\.  다운로드한 파일을 `/usr/local/bin/`:

:::BlockQuote
mv \<downloaded\_file> /usr/local/bin/b4a
chmod 755 /usr/local/bin/b4a
:::

&#x20;   4\.  CLI가 이제 사용할 준비가 되었습니다.

### Windows용

- 다음에서 [b4a.exe](https://github.com/back4app/parse-cli/releases/download/release_3.3.1/b4a.exe) 파일을 다운로드하세요 [릴리스 페이지](https://github.com/back4app/parse-cli/releases).
- 파일을 `C:\Windows\System32`로 이동하여 전역적으로 접근할 수 있도록 하세요.2 - 구성

### CLI를 Back4app 계정에 연결하기

1. Back4app 계정에 로그인하세요.
2. 계정 키를 생성하세요:
   - "안녕하세요, \[사용자 이름]" 메뉴 위에 마우스를 올리세요.
   - 계정 키로 가서 **새 키를 생성하세요.**

![](https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/Vtf9h_neBfwWz0MOTYGb8_screenshot-2024-11-28-at-164118.png)

&#x20;   3\.  CLI에서 키를 구성하세요:

:::BlockQuote
b4a 계정 키 구성
:::

프롬프트가 나타나면 계정 키를 붙여넣으세요.

:::hint{type="danger"}
이 명령은 특정 컴퓨터에서 이 설정을 처음 할 때만 작동합니다. 그렇지 않으면 <font color="#2166ae">`b4a configure accountkey -d`</font>를 실행하여 이전 키를 새 키로 덮어쓰세요.
:::

사용한 계정 키는 <font color="#2166ae">`${HOME}/.back4app/netrc`</font>에 저장됩니다. (Mac 및 Linux용)

## 3 - 사용법

### 새 앱 만들기

1. 터미널을 열고 다음을 실행하세요: `b4a new`
2. 새 앱을 만들려면 "(n)ew"를 선택하세요.
3. 프롬프트에 따라 앱의 이름을 정하고 설정하세요.

### 클라우드 함수 배포

1. 로컬 클라우드 코드 파일을 생성하세요, 예: `main.js`:

```javascript
Parse.Cloud.define("hello", (request) => {
  return "Hello, world!";
});
```

&#x20;   2\.  코드를 배포하세요:

:::BlockQuote
b4a 배포
:::

CLI는 당신의 `cloud` 및 `public` 폴더를 Back4app에 업로드합니다.

### 기타 유용한 명령어

| 명령어          | 설명                       |
| ------------ | ------------------------ |
| b4a list     | 계정에 연결된 모든 앱을 나열합니다.     |
| b4a deploy   | 클라우드 코드 및 호스팅 파일을 배포합니다. |
| b4a releases | 앱의 릴리스를 가져옵니다.           |
| b4a rollback | 주어진 앱의 버전을 롤백합니다.        |

전체 명령어 목록은 `b4a help`를 실행하세요.

## 4 - 문제 해결

### 일반적인 문제

- **권한 오류**: 사용하십시오 `sudo` 리눅스/Mac 설치를 위해 또는 Windows 실행 파일이 올바른 디렉토리에 있는지 확인하십시오.
- **연결 문제**: `b4a configure accountkey`를 다시 실행하여 계정 키 구성을 확인하십시오.
- **배포 오류**: 올바른 구성을 위해 `.parse.local` 및 `.parse.project` 파일을 확인하십시오.

## 5 - 다음 단계

- 사용자 정의 함수를 작성하여 Cloud Code로 실험해 보십시오.
- 오프라인 개발을 위해 [로컬 Parse Server 환경](https://www.back4app.com/docs/local-development/parse-server-local)을 탐색하십시오.

## 결론

Back4app CLI를 사용하면 애플리케이션을 효율적으로 관리하고, 업데이트를 배포하며, 강력한 Cloud Code 기능을 활용할 수 있습니다. 이 가이드를 따라 시작하고 Back4app의 CLI 도구의 모든 잠재력을 탐색하십시오.