개발자의 축구 기행문

Username for 'https://github.com': myid
Password for 'https://myid@github.com' :
remote: Support for password authentication was removed on August 13, 2021.
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ fatal: Authentication failed for 'https://github.com/myid/myrepo.git/'

프로젝트에 최초로 git init을 한 경우, 이후 GitHub의 origin 저장소에 push를 시도하면 인증 관련 에러가 발생할 수 있습니다.

이는 GitHub에서 2021년 8월부로 비밀번호 인증을 더 이상 지원하지 않고, 대신 Personal Access Token(PAT) 을 사용하여 인증하도록 변경되었기 때문입니다.

따라서 GitHub 홈페이지에서 새로운 토큰을 발급받고, 이를 로컬 Git에 연동해주어야 합니다.

아래 내용을 따라 진행해주세요.

✅ 새로운 Personal Access Token 생성 방법 (Classic 방식)

1. GitHub 접속 → 로그인
2. 우측 상단 프로필 클릭 → Settings
3. 좌측 메뉴에서 아래로 스크롤 → Developer settings
4. Personal access tokens → Fine-grained tokens 선택
5. 우측 상단 "Generate new token" 클릭

🔧 설정할 항목들

1. Token name (이름)

• 예: study-token

2. Resource owner

• 로그인된 계정 및 추가 사용자

3. Expiration (만료일)

• 90일, 180일, 1년, 또는 No expiration (보안상 90일 추천)
• 개인 스터디 용으로 사용 시 'No expiration'도 사용가능하긴 합니다.

4. Repository access (저장소 접근 권한)

최소 권한 설정 방법

1. Repository Permissions:
   • 기본적으로 Contents, Issues, Pull requests 권한을 선택하면 대부분의 작업 가능
   • 추가적으로 CI/CD가 필요하면 Actions, 보안 관리가 필요하면 Code scanning alerts 권한 추가
2. Account Permissions:
   • 대부분의 경우 기본적인 계정 권한만 필요하므로, Profile, Email addresses 정도만 선택하면 충분합니다.

이후 'Generate token' 클릭 시 아래처럼 새로운 토큰이 생성됩니다.

🛠️ Git에 토큰 저장하기

다음 push에서 GitHub 계정과 토큰을 사용할 수 있도록 설정해야 합니다. 

아래 명령어 입력 시 popup 창이 뜨고, 내용을 입력해주세요.

git push origin main

• 사용자명: GitHub 아이디
• 비밀번호: 방금 만든 토큰

🛠️ 설정 및 토큰 갱신 절차 (macOS/Windows 공통)

1. 기존 인증 정보 삭제

• macOS: Keychain Access에서 github.com 항목 삭제
• Windows: 자격 증명 관리자에서 git:https://github.com 항목 삭제

최근 Mac을 새로 세팅하면서 개발 환경도 처음부터 다시 구성하게 되었습니다.

그 중 가장 먼저 설치한 도구 중 하나가 Homebrew와 Docker입니다.

혹시 저처럼 처음 설치하시는 분들이 있다면 참고하시라고 정리해봤습니다.

Step 1. Homebrew 설치

Homebrew는 macOS에서 패키지나 앱을 간편하게 설치할 수 있게 도와주는 필수 도구입니다. 터미널을 열고 아래 명령어를 입력하면 설치가 시작됩니다.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

설치가 끝나면 터미널에 추가로 아래와 같은 메시지가 뜰 수 있습니다. 이건 brew 명령어를 제대로 인식시키기 위한 설정이니 꼭 따라 해주셔야 합니다.

* Homebrew 설치를 정상적으로 했는데, 아직 터미널에서 brew 명령어를 인식하지 못할 수 있느니, .zprofile을 추가하라는 의미입니다.

🍎 M1/M2/M3 (Apple Silicon) 사용자의 경우

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile eval "$(/opt/homebrew/bin/brew shellenv)"

💻 Intel Mac 사용자

echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile eval "$(/usr/local/bin/brew shellenv)"

제대로 설치되었는지 확인하려면 다음 명령어를 입력해봅니다.

brew --version

* homebrew 설치가 정상적으로 완료 되었다면, 버전 정보가 출력됩니다.

Step 2. Docker 설치

이제 Homebrew를 이용해 Docker를 설치해보겠습니다. Docker는 GUI 앱 형태로 설치되기 때문에 --cask 옵션을 사용합니다.

* --cast 옵션은 Homebrew 에서 GUI 애플리케이션을 설치할 때 사용하는 옵션입니다.

brew install --cask docker

* 설치가 완료되면 응용 프로그램 > Docker에서 앱을 실행하거나 아래 명령어로도 실행할 수 있습니다.

처음 실행할 때는 관리자 권한을 요구하거나 로그인을 해야 할 수도 있어요. 실행이 완료되면 화면 오른쪽 상단 메뉴바에 고래 아이콘 이 생기는데, 이 아이콘이 떠 있다면 Docker가 잘 실행된 상태입니다!

Step 3. 설치 확인

마지막으로 Docker가 정상적으로 설치되었는지 확인해보겠습니다.

docker --version

이 명령어를 입력했을 때 버전 정보가 잘 나온다면 성공입니다!

저는 이렇게 macOS에 Homebrew와 Docker를 설치하고 본격적인 개발 환경을 시작했습니다. 혹시 설치 중 막히는 부분이나 궁금한 점 있으시면 댓글 남겨주세요! 😊

Docker 설치 방법 in Mac OS

1. Docker 공식 홈페이지로 이동합니다.

• https://docs.docker.com/desktop/install/mac-install/

2. Mac OS 칩셋 선택

M1, M2, M3.. 계열을 구매한 사용자라면 'Apple Silicon' 을 선택하시고,

intel 계열을 구매한 사용자라면 'Intel chip'를 선택해주세요.

3. 다운로드 받은 Docker dmg 파일 실행 및 설치

4. Docker 실행 및 정상 설치 확인

Homebrew 란?

Homebrew는 macOS 및 Linux 운영 체제에서 소프트웨어 패키지를 설치하고 관리하는 오픈 소스 패키지 관리자 입니다.

• 커맨드 라인 인터페이스를 통해 간편하게 소프트웨어 설치 가능
• 간편한 패키지 관리 및 업데이트
• maxOS 용으로 개발 되었지만 Linux 용 포트도 존재

즉, 터미널에서 명령어를 통해 프로그램을 설치할 수 있기 때문에 mac 사용자 사이에서는 필수 프로그램으로 여겨집니다.

• Homebrew 홈페이지 : https://brew.sh/

Homebrew 설치 방법

1. Terminal 실행

2. 설치 명령어 실행(아래 명령어를 복붙 합니다.)

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3. 설치 확인

brew --version

Homebrew 가 정상적으로 설치되었으면 brew 명령어를 통해 버전 확인을 할 수 있습니다.

* 만약 설치 시 Warning: /opt/homebrew/bin is not in your PATH 에러가 발생하면 아래 링크를 확인 해주세요.

https://gabrielyj.tistory.com/217

mac os 에서 Homebrew 설치 시 발생하는 PATH 문제 해결

문제 해결 방법

발생된 에러 '/opt/homebrew/bin is not in your PATH' 는 해당 경로 등록함으로 쉽게 해결할 수 있습니다.

1. 터미널에서 아래 명령어를 실행합니다.

echo 'export PATH=/opt/homebrew/bin:$PATH' >> ~/.zshrc

2. 확인 (생략 가능)

vi ./.zshrc

3.  명령어 실행으로 zshrc 쉘 환경을 재로드

source ~/.zshrc

4. brew 버전 확인

brew --version

남는 노트북으로 혼자 스터디를 위한 웹 서버를 사용 했습니다.

당시 cpu 2코어에 램2기가 짜리 노트북으로 썼는데 오래된거 치곤

스터디용 웹 서버로는 문제없이 말끔히 잘 사용 했습니다.

그러다가 어느 순간 맛이 가더니 영영 돌아오지 못할 강을 건넜지요 ㅜㅜ

그때 태양광 발전기 사용하는 친구집에 설치 했었는데 더이상 신세지기 미안해서

새로운 웹 서버는 제가 사는집에 설치 하기로 했습니다.

그런데... 기존에 iptime을 사용 할때는 포트포워딩부터 DDNS설정까지

아주 쉽게 사용 했었는데 U+은 좀 많이 헤매게 되더라구요 ㅠㅠ

당연히 제 실력이 미달이라 많이 버벅됬지만요...ㅎㅎ

그래서 기록용으로 포스팅 합니다.

1. U+는 192.168.219.1 이 기본 게이트웨이 입니다. 해당 url로 접속 해주세요. 

(업체마다 219 부분 숫자가 다르다고 하더군요)

그리고 사용하시는 공유기를 클릭 합니다.

2. 패스워드는 따로 변경하지 않으셨다면 공유기에 붙어있는 웹 admin 암호 입니다. 

3. 그리고 상태정보 -> DHCP 할당 정보에 들어갑니다. 

4. 직접 사용할 웹 서버 물리적 주소(MAC)와 할당할 IP주소를 적어주세요.

그리고 우측 위의 추가 버튼을 누르신 후 맨 밑 설정 적용을 눌러줍니다.

(해당 웹 서버 사용처에서 ipconfig으로 확인해줍니다)

5. 그리고 메뉴바에서 네트워크 설정 -> NAT 설정으로 들어갑니다.

6. 서비스 포트를 적어줍니다. 보통 웹 서버로 사용 하신다면, 8080-8080으로 해주시고,

추가적으로 포트를 더 사용하신다면 원하시는 범위만큼 설정 해주세요.

프로토콜은 TCP/IP로 해주시고 내부 주소는 할당 받은 IP를 적어주시면 됩니다.

내부 포트는 거의 8080이고 혹시 다르시면 알맞게 적어주세요.

그리고 추가 후 저장을 해줍니다. 

7. 위에는 내부(192.168.219.XXX:8080)로 접속한것이고,

아래는 외부에서(XXX.XXX.XXX.XXX:8080)으로 접속한 것입니다.

외부에서 접속하는 방법은 해당 공유기의 외부IP를 참조 하시면 됩니다.