

# Mountpoint 설치
<a name="mountpoint-installation"></a>

명령줄을 사용하여 Mountpoint for Amazon S3의 사전 빌드된 패키지를 다운로드하고 설치할 수 있습니다. Mountpoint 다운로드 및 설치 지침은 사용 중인 Linux 운영 체제에 따라 다릅니다.

**Topics**
+ [Amazon Linux 2023(AL2023)](#mountpoint-install-al2023)
+ [RPM 기반 배포판(Amazon Linux 2, Fedora, CentOS, RHEL)](#mountpoint-install-rpm)
+ [DEB 기반 배포판(Debian, Ubuntu)](#mountpoint.install.deb)
+ [기타 Linux 배포판](#mountpoint-install-other)
+ [Mountpoint for Amazon S3 패키지의 서명 확인](#mountpoint-install-verify)

## Amazon Linux 2023(AL2023)
<a name="mountpoint-install-al2023"></a>

Mountpoint는 AL2023 버전 2023.9.20251110 이후 Amazon Linux 2023 리포지토리에서 직접 사용할 수 있습니다.

1. 다음 명령을 입력하여 설치합니다.

   ```
   sudo dnf install mount-s3
   ```

1. Mountpoint for Amazon S3가 성공적으로 설치되었는지 확인합니다.

   ```
   mount-s3 --version
   ```

   다음과 유사한 출력 화면이 표시되어야 합니다.

   ```
   mount-s3 1.21.0+1.amzn2023
   ```

## RPM 기반 배포판(Amazon Linux 2, Fedora, CentOS, RHEL)
<a name="mountpoint-install-rpm"></a>

1. 사용하는 아키텍처에 해당하는 다음 다운로드 URL을 복사합니다.

   *x86\_64*:

   ```
   https://s3.amazonaws.com/mountpoint-s3-release/latest/x86_64/mount-s3.rpm
   ```

   *ARM64 (Graviton)*:

   ```
   https://s3.amazonaws.com/mountpoint-s3-release/latest/arm64/mount-s3.rpm
   ```

1. Mountpoint for Amazon S3 패키지를 다운로드합니다. `{{download-link}}`를 앞 단계의 해당 다운로드 URL로 바꿉니다.

   ```
   wget {{download-link}}
   ```

1. (선택 사항) 다운로드한 파일의 신뢰성 및 무결성을 확인합니다. 먼저 사용하는 아키텍처에 해당하는 서명 URL을 복사합니다.

   *x86\_64*:

   ```
   https://s3.amazonaws.com/mountpoint-s3-release/latest/x86_64/mount-s3.rpm.asc
   ```

   *ARM64 (Graviton)*:

   ```
   https://s3.amazonaws.com/mountpoint-s3-release/latest/arm64/mount-s3.rpm.asc
   ```

   그런 다음, [Mountpoint for Amazon S3 패키지의 서명 확인](#mountpoint-install-verify)을 참조하세요.

1. 다음 명령을 사용하여 패키지를 설치합니다.

   ```
   sudo yum install ./mount-s3.rpm
   ```

1. 다음 명령을 입력하여 Mountpoint가 성공적으로 설치되었는지 확인합니다.

   ```
   mount-s3 --version
   ```

   다음과 유사한 출력 화면이 표시되어야 합니다.

   ```
   mount-s3 1.21.0
   ```

## DEB 기반 배포판(Debian, Ubuntu)
<a name="mountpoint.install.deb"></a>

1. 사용하는 아키텍처에 해당하는 다운로드 URL을 복사합니다.

   *x86\_64*:

   ```
   https://s3.amazonaws.com/mountpoint-s3-release/latest/x86_64/mount-s3.deb
   ```

   *ARM64 (Graviton)*:

   ```
   https://s3.amazonaws.com/mountpoint-s3-release/latest/arm64/mount-s3.deb
   ```

1. Mountpoint for Amazon S3 패키지를 다운로드합니다. `{{download-link}}`를 앞 단계의 해당 다운로드 URL로 바꿉니다.

   ```
   wget {{download-link}}
   ```

1. (선택 사항) 다운로드한 파일의 신뢰성 및 무결성을 확인합니다. 먼저 사용하는 아키텍처에 해당하는 서명 URL을 복사합니다.

   *x86\_64*:

   ```
   https://s3.amazonaws.com/mountpoint-s3-release/latest/x86_64/mount-s3.deb.asc
   ```

   *ARM64 (Graviton)*:

   ```
   https://s3.amazonaws.com/mountpoint-s3-release/latest/arm64/mount-s3.deb.asc
   ```

   그런 다음, [Mountpoint for Amazon S3 패키지의 서명 확인](#mountpoint-install-verify)을 참조하세요.

1. 다음 명령을 사용하여 패키지를 설치합니다.

   ```
   sudo apt-get install ./mount-s3.deb
   ```

1. 다음 명령을 실행하여 Mountpoint for Amazon S3가 성공적으로 설치되었는지 확인합니다.

   ```
   mount-s3 --version
   ```

   다음과 유사한 출력 화면이 표시되어야 합니다.

   ```
   mount-s3 1.21.0
   ```

## 기타 Linux 배포판
<a name="mountpoint-install-other"></a>

1. 운영 체제 설명서를 참조하여 필수 구성 요소인 `FUSE` 및 `libfuse2` 패키지를 설치합니다.

1. 사용하는 아키텍처에 해당하는 다운로드 URL을 복사합니다.

   *x86\_64*:

   ```
   https://s3.amazonaws.com/mountpoint-s3-release/latest/x86_64/mount-s3.tar.gz
   ```

   *ARM64 (Graviton)*:

   ```
   https://s3.amazonaws.com/mountpoint-s3-release/latest/arm64/mount-s3.tar.gz
   ```

1. Mountpoint for Amazon S3 패키지를 다운로드합니다. `{{download-link}}`를 앞 단계의 해당 다운로드 URL로 바꿉니다.

   ```
   wget {{download-link}}
   ```

1. (선택 사항) 다운로드한 파일의 신뢰성 및 무결성을 확인합니다. 먼저 사용하는 아키텍처에 해당하는 서명 URL을 복사합니다.

   *x86\_64*:

   ```
   https://s3.amazonaws.com/mountpoint-s3-release/latest/x86_64/mount-s3.tar.gz.asc
   ```

   *ARM64 (Graviton)*:

   ```
   https://s3.amazonaws.com/mountpoint-s3-release/latest/arm64/mount-s3.tar.gz.asc
   ```

   그런 다음, [Mountpoint for Amazon S3 패키지의 서명 확인](#mountpoint-install-verify)을 참조하세요.

1. 다음 명령을 사용하여 패키지를 설치합니다.

   ```
   sudo mkdir -p /opt/aws/mountpoint-s3 && sudo tar -C /opt/aws/mountpoint-s3 -xzf ./mount-s3.tar.gz
   ```

1. `PATH` 환경 변수에 `mount-s3` 바이너리를 추가합니다. `$HOME/.profile` 파일에 다음 줄을 추가합니다.

   ```
   export PATH=$PATH:/opt/aws/mountpoint-s3/bin
   ```

   `.profile` 파일을 저장하고 다음 명령을 실행합니다.

   ```
   source $HOME/.profile
   ```

1. 다음 명령을 실행하여 Mountpoint for Amazon S3가 성공적으로 설치되었는지 확인합니다.

   ```
   mount-s3 --version
   ```

   다음과 유사한 출력 화면이 표시되어야 합니다.

   ```
   mount-s3 1.21.0
   ```

## Mountpoint for Amazon S3 패키지의 서명 확인
<a name="mountpoint-install-verify"></a><a name="verify"></a>

1. GnuPG를 설치합니다(`gpg` 명령). 다운로드한 Mountpoint for Amazon S3 패키지의 신뢰성 및 무결성을 확인하는 데 필요합니다. GnuPG는 Amazon Linux Amazon Machine Image(AMI)에 기본적으로 설치됩니다. GnuPG를 설치한 후 2단계로 진행합니다.

1. 다음 명령을 실행하여 Mountpoint 퍼블릭 키를 다운로드합니다.

   ```
   wget https://s3.amazonaws.com/mountpoint-s3-release/public_keys/KEYS
   ```

1. 다음 명령을 실행하여 Mountpoint 퍼블릭 키를 키 링으로 가져옵니다.

   ```
   gpg --import KEYS
   ```

1. 다음 명령을 실행하여 Mountpoint 퍼블릭 키의 지문을 확인합니다.

   ```
   gpg --fingerprint mountpoint-s3@amazon.com
   ```

   표시된 지문 문자열이 다음 중 하나와 일치하는지 확인합니다.

   ```
   8AEF E705 EBE3 29C0 948C  75A6 6F1C 3B3A EF4B 030B
   673F E406 1506 BB46 9A0E  F857 BE39 7A52 B086 DA5A (older key)
   ```

   지문 문자열이 일치하지 않는 경우, Mountpoint 설치를 완료하지 말고 [AWS Support](https://aws.amazon.com/premiumsupport/)에 문의하세요.

1. 패키지 서명 파일을 다운로드합니다. `{{signature-link}}`를 앞 섹션에 나온 해당 서명 링크로 바꿉니다.

   ```
   wget {{signature-link}}
   ```

1. 다음 명령을 실행하여 다운로드한 패키지의 서명을 확인합니다. `{{signature-filename}}`을 앞 단계에 나온 파일 이름으로 바꿉니다.

   ```
   gpg --verify {{signature-filename}}
   ```

   예를 들어 Amazon Linux가 포함된 RPM 기반 배포판의 경우 다음 명령을 실행합니다.

   ```
   gpg --verify mount-s3.rpm.asc
   ```

1. 출력에 `Good signature`라는 문구가 포함되어야 합니다. 출력에 `BAD signature`라는 문구가 포함된 경우 Mountpoint 패키지 파일을 다시 다운로드하고 이러한 단계를 반복합니다. 문제가 지속될 경우 Mountpoint 설치를 마치지 말고 [AWS Support](https://aws.amazon.com/premiumsupport/)에 문의하세요.

   출력에는 신뢰할 수 있는 서명에 대한 경고가 포함될 수 있습니다. 이는 문제가 있다는 뜻이 아니며, Mountpoint 퍼블릭 키를 독립적으로 확인하지 않았다는 의미일 뿐입니다.