TOPSECRET

hackersground-kr · Aug 26, 2024 · e280f1e · e280f1e
1 parent a06284a
commit e280f1e
Showing 1 changed file with 187 additions and 14 deletions.
diff --git a/README.md b/README.md
@@ -1,3 +1,5 @@
+# `common` - `백수였던 내가 이세계에선 의성 시장?`
+
 해커그라운드 해커톤에 참여하는 `common` 팀의 `백수였던 내가 이세계에선 의성 시장?`입니다.
 
 ## 참고 문서
@@ -22,12 +24,13 @@
 ## 설치 방법
 
 > **아래 제공하는 설치 방법을 통해 심사위원단이 여러분의 제품/서비스를 실제 Microsoft 애저 클라우드에 배포하고 설치할 수 있어야 합니다. 만약 아래 설치 방법대로 따라해서 배포 및 설치가 되지 않을 경우 본선에 진출할 수 없습니다.**
->
-> 안녕하세요 친애하는 운영진분들 운영하시느라 수고가 많으십니다 항상 감사합니다 ☺️
+<br>
+안녕하세요 친애하는 운영진분들 운영하시느라 수고가 많으십니다 항상 감사합니다 ☺️
 
 ### 사전 준비 사항
 
 > **여러분의 제품/서비스를 Microsoft 애저 클라우드에 배포하기 위해 사전에 필요한 준비 사항들을 적어주세요.**
+<br>
 인텔리제이, 도커 데스크탑, 도커 엔진, Azure 계정 (Hackerground에 권한이 있는), 깃허브 계정, 자바 jdk-17 , 맥북으로 배포 절차를 구성하였습니다 맥북으로 진행해주세요.
 
 ## 시작하기
@@ -55,17 +58,15 @@
 
 이미지처럼 경고창이 뜬다면 Trust Project 클릭해주세요.
 
-![image](images/5.png)
-
-이런 화면에서 오른쪽에 코끼리 모양(Gradle) 아이콘을 클릭해주세요.
-
-![image](images/6.png)
+왼쪽 아래에 |>_| 이렇게 생긴 명령어 창을 클릭해줍니다.
 
-Tasks 폴더를 클릭해주세요.
+명령어 창에 아래와 같이 명령어를 적어주세요
 
-![image](images/7.png)
+```bash
+./gradlew build -x test
+```
 
-build 폴더를 더블 클릭 후 build를 찾아 더블 클릭해주세요.
+명령어를 친 뒤 파일에 build 폴더가 생겼다면 성공입니다.
 
 왼쪽 위 빨간 창 닫기 버튼을 통해 인텔리제이 초기화면으로 돌아갑니다.
 
@@ -87,6 +88,9 @@ build 폴더를 더블 클릭 후 build를 찾아 더블 클릭해주세요.
 ~~여기까지 하셨다면 체크포인트 느낌으로 저한테 해커그라운드 잡담방에 중간정도완료!! 보내주세요...ㅎ 가능하시면...말이죠..~~
 
 
+!중요 도커가 실행중이여야합니다!
+
+
 ![image](images/11.png)
 
 오른쪽 아래에 네모 안에 |>_| 이렇게 생긴거 클릭해주세요.
@@ -95,13 +99,13 @@ build 폴더를 더블 클릭 후 build를 찾아 더블 클릭해주세요.
 curl -fsSL https://aka.ms/install-azd.sh | bash
 ```
 
-이 명령어를 쳐서 azd를 깔아줍니다.
+위 명령어를 쳐서 azd를 깔아줍니다.
 
 ```bash
 azd auth login
 ```
 
-이 명령어를 통해 azd에 로그인해주세요.
+위 명령어를 통해 azd에 로그인해주세요.
 
 ```bash
 azd auth login --check-status
@@ -116,6 +120,11 @@ azd auth login --check-status
 azd init -e common-hackergroud
 ```
 
+위 명령어를 실행하고 아래 사진과 같이 나온다면 B 단계로 넘어가시면 됩니다.
+
+<img width="833" alt="image" src="https://github.com/user-attachments/assets/d5f118f5-6ac0-44aa-a1c7-0767f15f585d">
+
+### A 단계
 ![image](images/12.png)
 
 Use code in the current directory에 초록이 뜬 채로 엔터를 클릭합니다.
@@ -155,6 +164,8 @@ services:
             path: Dockerfile
 ```
 
+### B단계
+
 그 다음 명령어창에 아래와 같이 작성하세요.
 
 ```bash
@@ -166,19 +177,181 @@ Select an Azure Subscription to use 를 물을껀데 그때 Hackers Ground 리
 Select an Azure location to use 를 물어보면 13. (Asia Pacific) Korea South (koreacentral) 에 초록불이 들어오도록 한 뒤 앤터를 클릭합니다.
 
 그리고 기다려주세요. 5~10분정도 소모됩니다.
+```bash
+Deploying services (azd deploy)
 
-SUCCESS: Your up workflow to provision and deploy to Azure completed in 2 minutes 22 seconds.
+  (✓) Done: Deploying service server
+  - Endpoint: 서버 url
+
+  (✓) Done: Deploying service web
+  - Endpoint: 웹 url
 
-가 뜨신다면 배포 성공 🎉
+SUCCESS: Your up workflow to provision and deploy to Azure completed in 2 minutes 22 seconds.
+```
+가 뜨신다면 배포 성공 🎉 Endpoint에 접속하시면 서비스를 이용하실 수 있어요!!
 
 배포는 성공하셨으니 추가점수를 받으러 가볼까요~!
 
 **깃허브 액션 구성하기**
 
+명령어 창 (터미널창)이 켜졌으면 가만히!
+
+꺼졌다면 오른쪽 아래에서 다시 |>_| 아이콘을 클릭해 명령어창을 켜주세요
+
+명령어창에 아래와 같이 작성합니다.
+
+```bash
+git init
+git add .
+git commit -m "Initial commit"
+```
+
+[깃허브](https://github.com/)로 이동해줄게요
+
+깃허브 Dashboard에서 오른쪽 본인 프로필을 클릭해주세요. (사진이나 아이콘모양을 클릭하면 됩니다)
+
+그럼 오른쪽에 창이 열릴껀데
+
+<img width="333" alt="image" src="https://github.com/user-attachments/assets/bd118379-b2f5-4820-a9f7-11c9e753b87a">
+
+창에서 Your Repositories 클릭해주세요
+
+<img width="1511" alt="image" src="https://github.com/user-attachments/assets/efab038e-1887-4473-8bbc-c8e991faedd9">
+
+사진을 참고해 오른쪽에 New라고 적힌 초록버튼을 클릭해주세요.
+
+<img width="654" alt="image" src="https://github.com/user-attachments/assets/7ae9d933-9d4d-4f15-9505-334e40fe978d">
+
+Repository 이름을 common이라고 적어주세요.
+
+다른건 건들지 말고 오른쪽 아래 Create Repository라고 적힌 초록 버튼을 클릭해주세요.
+
+<img width="1472" alt="image" src="https://github.com/user-attachments/assets/083d00a1-8e42-45d7-b3ac-2c9f0219ebc1">
+
+그럼 레포지토리가 생성이 완료되어 위 그림과 같은 화면이 보이실껍니다.
+
+<img width="1472" alt="image" src="https://github.com/user-attachments/assets/ac0d28e3-5ff4-4771-8a4a-214907344701">
+
+그림에서 https://github.com/{따라하시는분 깃허브 ID}/common.git 부분을 복사해주세요.
+
+그리고 다시 인텔리제이로 돌아가
+
+명령어(터미널) 창에 아래 명령어를 작성해주세요
+
+```bash
+git remote add origin 아까 복사한 주소
+```
+
+ex) git remote add origin https://github.com/yeseong0412/common.git
+
+그리고 아래 명령어를 작성해주세요
+
+```bash
+git push origin main
+```
+
+push가 완료될때까지 잠시 기다릴게요.
+
+<img width="830" alt="image" src="https://github.com/user-attachments/assets/cabfb582-e350-48b3-89e8-d38001e04259">
+
+사진과 같이 push가 완료되었다면 To https://github.com/{따라하시는분 깃허브 ID}/common.git 부분을 클릭해 깃허브로 다시 이동할게요.
+
+<img width="1512" alt="image" src="https://github.com/user-attachments/assets/a731fec8-5ce3-4af9-b78d-fa87e6424b93">
+
+이렇게 프로젝트가 들어온걸 확인하실 수 있죠.
+<br>
+하지만 액션은 실패하게 됩니다.
+<br>
+아직 저희가 해야할 작업이 남아있거든요!
+<br>
+
+https://portal.azure.com/#@hackersground.kr/resource/subscriptions/bfa39d86-1058-4824-8074-e9d283d6c321/resourceGroups/rg-common-hackergroud/providers/Microsoft.CognitiveServices/accounts/rg-common-openai-east/cskeys  로 이동해주세요.
+<br>
+(해커그라운드 조직에 권한이 있는 에저계정으로 로그인이 되어있어야합니다.)
+
+<img width="1512" alt="image" src="https://github.com/user-attachments/assets/9f5ec883-2a32-4a30-adb8-be739c8f4cb6">
+
+사진에 보이는 키 1과 엔드포인트를 아래와 같이 메모장에 잘 저장해주세요.
+
+<img width="327" alt="image" src="https://github.com/user-attachments/assets/520a4341-00f9-4d06-97d2-3b9a0357ebde">
+
+다시 인텔리제이 명령어(터미널) 창으로 돌아가주세요.
+
+```bash
+azd pipeline config
+```
+
+명령어창에 위 명령어를 기입해주세요.
+
+<img width="879" alt="image" src="https://github.com/user-attachments/assets/67442e62-d94b-44e8-8b03-cb2fe6f41479">
+
+기다리다 사진과 같이 "Would you like to commit and push your local changes to start the configured CI pipeline? (Y/n) " 이 뜬다면
+<br>
+n을 기입후 앤터를 눌러 종료해주세요.
+
+<img width="927" alt="image" src="https://github.com/user-attachments/assets/47cdcf29-127b-49d4-8b39-c0c4b8de6a59">
+
+그림과 같이 "SUCCESS: Your GitHub pipeline has been configured!" 가 뜬다면 성공한 것입니다.
+
+But! 아직 할게 남았어요...ㅠㅠㅠㅠ 하지만 거의 다왔으니 조금만 더 가보자고요!
+
+<img width="1512" alt="image" src="https://github.com/user-attachments/assets/d4ac9d76-7a57-4724-8eb3-184cc4a04945">
+
+본인 Repository에서 위, 중간 살짝 오른쪽 부분에 Settings라는게 보일꺼에요 그거 클릭해주세요.
+
+<img width="1512" alt="image" src="https://github.com/user-attachments/assets/360e6ccf-71f2-4326-97a1-f873a7bfd18c">
+
+Secrets and variables부분을 클릭하시고 actions를 클릭해주세요.
+
+<img width="1512" alt="image" src="https://github.com/user-attachments/assets/8b9b5419-9017-4d71-8a76-588b7614024e">
+
+오른쪽 아래 초록버튼인 New repository secret를 클릭해주세요.
+
+<img width="817" alt="image" src="https://github.com/user-attachments/assets/d3c7a122-2ad3-4972-b3d5-d385025a4d2b">
+
+아까 메모장에 복사해둔 키1을 복사해 Secret부분에 넣어주세요. (Name은 KEY입니다 Name은 사진 따라하시면 됩니다.)
+<br>
+다 하셨으면 왼쪽 아래 Add Secret 클릭!
+
+<img width="1512" alt="image" src="https://github.com/user-attachments/assets/f2316d6e-6026-4996-b13c-395f27346d8c">
+
+그리고 다시 오른쪽 아래 초록버튼인 New repository secret를 클릭해주세요.
+
+<img width="870" alt="image" src="https://github.com/user-attachments/assets/90e54f1c-ab8a-4459-b379-2b644277ca75">
+
+이것도 마찬가지로 메모장에 복사해둔 엔드포인트를 복사해 Secret부분에 넣어주세요. (Name은 ENDPOINT입니다. Name은 사진 따라하시면 됩니다.)
+<br>
+왼쪽 아래 Add Secret 클릭!
+
+<img width="1512" alt="image" src="https://github.com/user-attachments/assets/a817c8ab-6a44-4bb0-a99c-b8fe2f16196d">
+
+세팅이 끝나셨으면 왼쪽 위 이름 옆에 common 클릭해주세요.
+
+<img width="1512" alt="image" src="https://github.com/user-attachments/assets/91704ac0-f5f4-48e6-8709-c6a3143e65c4">
+
+그리고 Actions 클릭
+
+<img width="1512" alt="image" src="https://github.com/user-attachments/assets/9e797571-4c6b-4d7b-83c5-c5e5c357f0b1">
+
+왼쪽에 .github/workflows/azure-dev.yml 클릭해주세요
+
+<img width="1512" alt="image" src="https://github.com/user-attachments/assets/c414a05e-40ec-4ac7-b060-b335fed21e58">
+
+오른쪽 Run workflow클릭 후 Branch가 main인지 확인 후 초록버튼인 Run workflow를 클릭해주세요.
+
+<img width="1163" alt="image" src="https://github.com/user-attachments/assets/4c96fd2e-6900-48e2-9bb3-e93dc7979c33">
+
+페이지를 새로고침을 하면 액션하나가 작동중일껍니다.
 
+기다리시다 초록불이 뜨면 액션까지 성공! 🎉🚀🔥
 
+수고하셨습니다!!!!
 
+**체크리스트**
+- [X] Azure container apps로 배포를 했는가?
+- [X] Github Action, Bicep을 통한 배포 자동화를 성공하였는가?
 
+common 1등 하겠습니다.