1. 맥락
•
환영합니다! 
•
처음부터 작업을 함께하지 못하여 죄송스러운 한편, 뒤늦게라도 오시게 되어 정말 기쁜 마음입니다.
1-1. 추가역자를 구하게 된 이유
1.
책의 퀄리티: 만약 원서의 퀄리티만 본다면 사실 그냥 이대로만 내도 원서보다 낫습니다. 하지만 결국 책이 잘 되어야 역자도 그 책을 썼다고 자랑스럽게 말할 수 있는 법입니다. 하지만 이보다 퀄리티를 조금 더 올려 주고 싶습니다. 어떤 퀄리티를 올리고 싶은지는 계속 설명 드리겠습니다.
2.
역자의 관련 지식 부족: 역자진의 지식이 모자란 부분은 9장(GCP와 쿠버네티스), 12장 현업 인사이트 부분입니다. 9장의 경우 원문의 쿠버네티스 설명이 정말 정말 부실한 것을 알 수 있습니다. 12장의 경우 현업 인사이트라고 하며 내용이 소개되었는데, 이 내용 또한 오늘날의 내용과 동떨어져 있는 것이 현실입니다. 그래서 이 부분을 보완해야 합니다.
3.
리소스 부족: 지금 역자1(@이장후), 역자2(@Il Sup Lee)는 사용할 수 있는 리소스가 거의 없는 상태입니다. 출판이 너무 많이 지연되었기 때문에 책 출판을 위한 마무리 작업에 모든 리소스를 인볼브 중입니다. 그래서 전반적으로 모든 내용들이 정리되었지만 소스코드와 관련된 부분은 다시 정리하고 있지 못하는 상황입니다.
1-2. 책의 퀄리티와 관련된 이슈와 이를 위한 역자의 노력들 기록
1.
(성공) 책의 문제에 대한 컨센서스를 공유, 불필요한 문장 제거와 부록 제거
a.
다음 글을 참고하세요. 꼭 다 읽어 보세요. 책을 번역하기 위해 읽고 다시 읽어가는 과정에서 어떤 점들이 문제점으로 지적되는지 이해하기 편할 것입니다.
2.
(진행중) 책의 취지를 ‘실전’이 아니라 MLOps 에 대해 이해를 도울 수 있는 컨셉으로 선회
a.
다음 글을 참고하세요. 다 읽어 보시기를 권장드립니다. 역자의 말이 들어간다면 이런 느낌으로 들어갈 것 같습니다. 제가 생각하는 책의 방향성을 시사하고 있기 때문입니다 (사실, 저는 이런 느낌의 책을 기대하지 않았습니다. 그런데, 이 책이 이런 포지션에 있는 것이 가장 정확하기 때문에 이런 글을 작성하게 되었습니다.)
3.
(실패) 응집성을 한껏 높여 줄 새로운 실습 작성
a.
어떤 노력을 하려고 했는지는 다음 글을 참고하세요. 하지만 실패했습니다. 이 작업이 성공한다면 응집성은 물론 퀄리티가 크게 높아지겠지만 리소스가 없을 뿐더러, ‘놀림받지 않을’ 거대한 시스템의 코드를 작성할 자신이 없었기 때문입니다. 어떤 느낌의 응집성이 부족하다고 느꼈는지 이해를 하는 정도면 충분할 것 같습니다.
2. DRI
2-0. 파일 수정 방법
1.
구글 드라이브 이일섭_작업중 폴더 경로의 8장 로컬로 다운로드
2.
파일의 변경 내용 추적 ON -> 파일 수정
3.
수정 된 파일 업로드
4.
(?) 4. 이전 파일은 사용금지 or 이전파일 폴더로 옮김
2-1. 추가역자님이 필수적으로 해 주셔야 하는 내용
장 | 개선사항 |
전체 | 등장하는 실습 소스코드들 잘 동작하는지 확인, 개선이 필요하다고 생각하고 할 수 있다고 생각하는 경우 개선. 1~7장의 경우 @이장후가 소스코드의 내용을 거의 다 수정해 두었습니다. 적극적으로 도와줄 수 있으니 편하게 물어봐 주셔도 좋습니다. 우선순위는 9장(예시1) > 10장 > 8장 > 7장(예시2) > 나머지 순입니다. |
9장 | GCP, 쿠버네티스와 관련된 내용 그림 수정(예시3), 설명 추가, 개념 추가 (역자 노트(예시4)를 이용해도 좋고, 역주를 이용해도 좋고, 본문 내용을 아예 수정해 버려도 좋습니다. 1~7장과 톤앤매너만 맞춰 주세요) |
전체 | 글 전체에 아우르는 오개념 확인(예시5) |
@4/2/2023 | 2-1 / 반드시 고쳐야 함 | 2-1.5 / 중요한 욕심 @4/12/2023 → 4/16/2023 | 2-2 / 하면 좋다 |
1, 2, 3, 4 | - 오개념 수정, 그림 수정 제안, 추가할 역주에 대해서 고민하기 | ||
5 | @4/11/2023 | - [소스코드] 데이터레이크, 피처스토어 대한 이야기가 계속 언급되는데, 데이터 파이프라인과 관련된 실습을 넣는다면 간단히 넣어볼 것 | |
6 | @4/10/2023
- 오개념 수정, 그림 수정 제안, 추가할 역주에 대해서 고민하기 | ||
7 | @4/9/2023
- 오개념 수정, 그림 수정 제안, 추가할 역주에 대해서 고민하기 | ||
8 | | - 오개념 수정, 그림 수정 제안, 추가할 역주에 대해서 고민하기 | |
9 | - 오개념 수정, 그림 수정 제안, 추가할 역주에 대해서 고민하기
- [소스코드] 안도는 소스코드 수정 | - 설명 추가, 디테일하게 (예를 들어 1. 큐브플로 설명 추가/제거/개편 2. 마스터노드 - 워커 노드 아키텍처 설명 대폭 추가 3. Pod 가 죽어도 자동으로 재생성된다는 개념(replica set) 삽입)
- [소스코드] 앞부분 실습 내용과 일관된 스타일로 소스코드 수정
- [소스코드] 쿠버네티스의 중요한 역할을 보여줄 수 있도록 소스코드 수정 개념(컨테이너 되살리기, 로드밸런싱) | - [소스코드] 쿠버네티스에서 머신러닝 모델 돌리기 실습이 가능하도록 소스코드 수정 |
10 | @4/5/2023
- 오개념 수정, 그림 수정 제안, 추가할 역주에 대해서 고민하기
- [소스코드] 안도는 소스코드 수정 (애저 계정 생성 오류) | - [소스코드] CD 환경에서 자동으로 ONNX로 변환 | |
11 | @4/7/2023
- 오개념 수정, 그림 수정 제안, 추가할 역주에 대해서 고민하기
- [소스코드] 안도는 소스코드 수정 | ||
12 | @4/8/2023
- 오개념 수정, 그림 수정 제안, 추가할 역주에 대해서 고민하기
- [소스코드] 안도는 소스코드 수정 |
예시1: 9장, 쿠버네티스 입문
9장은 GCP와 함께 쿠버네티스를 다루고 있습니다. 이 소스코드는 일단 실행시키기까지 설치과정 등에 대한 안내가 전혀 없어 실습을 시작하기까지의 거리가 너무 멀뿐더러 아예 돌지도 않습니다.
그런데 이 내용은 이 책의 2장과 7장에 등장했던 내용을 바탕으로 하는 실습입니다. 문제는 2장과 7장에 등장했던 내용의 실습이 작동하지 않아서, 한글판으로 모두 바꾸었다는 것입니다. 당연히 2장과 7장의 소스코드는 한글판이고 소스코드의 상태, API 의 상태도 다른데 이 상태로 그대로 둘수는 없겠지요. 제가 작성한 소스코드는 여기에 보관되어 있습니다.
소스코드 저장소를 개인 계정으로 생성하셔도 괜찮습니다. 링크만 여기 걸어도 됩니다. 출판되어 잘 되는 경우 스타를 가져가세요.
예시2: 7장, 마르코 폴로? 뭐 어쩌라고
7장에 이런 내용이 나옵니다.
이와 더불어 소개하고 싶은 것은 AWS Step Function이라는 제품이다. AWS Step Function을 이용하면 여러 개의 람다 함수를 연결지을 수 있다.
그러면서 다음과 같은 코드가 등장하는데요,
읽어보시면 알겠지만, 워크플로를 만들면 그림이 저렇게 등장한다는 내용이 달랑 등장할 뿐, 저것을 어떻게 이해하고 실제로 어떻게 사용될 수 있는지에 대한 언급은 전혀 되지 않고 있습니다. 앞뒤 실습과도 전혀 어울리지 못하는 느낌입니다. 이 모든 내용을 추가할 수는 없습니다. 하지만 역자님 재량대로 내용을 수정하거나, 역주를 추가하거나, 역자노트를 추가하거나, 소스코드를 앞뒤 문맥과 더욱 잘 어우러지도록 내용을 조금 더 센스있게 다듬어 준다면 더욱 좋은 글이 될 것 같습니다.
예시3: 9장, 알아보지 못하겠는 그림 수정
9장에 보면 이런 그림이 등장합니다.
쿠버네티스 이야기를 하는데 뜬금없이 쿠브플로 그림이 등장해 있습니다. 설명도 없습니다.
위 그림은 백 번 양보해도 도저히 알아먹을 수가 없습니다. 필요없다고 생각하시면 지워 버리시고, 임의의 설명을 추가해 주셔도 좋습니다. 예를 들어 이런 설명을 역자 노트로 넣어도 좋습니다. 열심히 쿠버네티스에 대해 공부한 입장에서 봐도 뭔지 모르겠습니다.
예시: 역자 노트
예시4: 역자 노트를 어떻게 쓰는 것인가
2장 3절에는 다음과 같은 내용이 등장합니다.
필자가 머신러닝이라는 개념을 그리디를 이용해 설명하는 과정에서 실습이 그 의도를 전혀 드러내지 못하고 있는 상황이었습니다. 그래서 역자 노트를 위와 같이 추가했습니다. 어떻게 역자 노트를 작성할 수 있는지에 대한 아이디어를 얻어 가세요. 저렇게 서식을 맞추어 작성할 필요는 없습니다. 내용을 추가해 주시면 저와 편집자님이 수정해 드리겠습니다.
예시5: 오개념 확인
오개념 보기
Search
평소에 잡아 주셨던 내용과 별반 다르지 않습니다.
시간이 절대 넉넉하지 않습니다. 20일 * 3시간 = 60시간이라는 기준은 정말 집약적으로 작업을 완료하였을 경우의 예상 시간입니다. 따라서 사소한 문장 윤문 정도까지 처음부터 짚고 넘어가려고 하지는 마세요. 편집자님이 한번 더 짚어 주실 것입니다. 영 마음쓰인다면 눈에 캥기는 것 정도만 짚고 넘어가 주세요.
2-2. 이것까지 해주신다면 퀄리티를 훨씬 더 올라갈 수 있음
우선순위 순서 | 개선사항 |
12장 | 억지스러운 내용 제거, 역자노트 추가, 역주 추가 |
전체 | 거시적 응집성 향상(예시6)을 위한 본문 수정, 역자노트 추가, 역주 추가 |
전체 | 미시적 응집성 향상(예시7,8)을 위한 본문 수정, 역자노트 추가, 역주 추가 |
전체 | 문장 윤문 |
이 내용은 필수내용을 충분히 완료한 뒤 욕심이 나고 시간이 남는경우 해 주시면 감사하겠습니다.
예시6: 1장에 나온 내용 회수
•
1장에는 “데이터플로 자동화” 같은 것들이 MLOps 의 근간이라고 이야기합니다. 그런데 결국 3~7장까지 언급하는 것은 주로 DevOps 입니다. 도대체 어느 부분에서 데이터플로 자동화가 등장하는지, 만약 후반부에서 등장한다면 조금 더 티를 내 주시면 됩니다.
•
책 전반적으로 “~~ 는 MLOps 를 떠받치는 기둥이다” 라는 표현이 등장합니다. 그런데 책 후반부에 갈수록 그런 언급이 점점 사라지다가 찾을 수 없게 되어 버립니다. 띠용.
예시7: 5장, feature store? 그래서 그게 뭔데
•
feature store 이라는 컨셉이 책에서 등장하였지만 너무 피상적으로만 알려 줍니다. 확인해보시면 이해하실 수 있을 것입니다. 9장 등에서 다시 등장하지만, 그럼에도 저는 피상적이라는 생각이 들었습니다.
예시8: 11장, CLI? 그게 왜 필요한데
•
11장에서는 setup tool 과 CLI 에 대해서 계속 강조하고 강조합니다. 그런데 도대체 왜인지를 앞부분과 연관지어 알려주지 않습니다. 생각해 보시면 예상 독자들이 CLI 가 MLOps 에서 왜 중요한건지 전혀 모르지 않을까요?
•
실제로 그것이 중요하지 않을지라도 해야 합니다.
3. 워크플로
•
처음부터 번역을 하는 경우 권장하는 워크플로가 있지만, 지금 굉장히 시간이 촉박한 상황이라는 것을 이해해 주셨으면 합니다. 지금 번역 작업을 8개월째 잡고 있는 경험상, 제가 권장드리는 워크플로는 다음과 같습니다.
1.
처음부터 끝까지, 최대한 악감정 없이 읽어본다: 전체적으로 문체가 어떻게 구성이 되어 있는지, 사람들이 댓글을 이용해서 피드백은 어떻게 주고받는지, 책들이 어떤 형태로 구성되어 있는지 이해하기 위함입니다. 문제가 있다고 생각하는 부분은 간단히 메모를 하면서만 넘어갑니다. 수정도 하지 마시고, 최대한 수용적인 태도로 차분히 읽어봅니다. 그래야 실습들이 어떤 연관성을 가지고 연결되는지(예시1), 역자노트(예시4)를 어떻게 구성하는지 등을 파악하실 수 있습니다. 특히 지금 들어오신 역자님께서 하시는 일은 ‘책 전체를 이해하고 이에 맞도록 다양한 내용들을 수정’ 하는 아주 막중한 임무를 맡고 있습니다. 따라서 수정 이전에 책의 전체 내용을 파악하는 작업을 반드시, 반드시 선행하셔야 합니다. 원서는 시간 절약을 위해 한글이 잘 이해되지 않을 때에만 열어보세요.
파일을 Google Docs 로 절대 열지 않습니다. 열었으면 아무것도 수정하지 말고 살포시 닫아주세요. 서식이 다 날아갑니다!
2.
수정할 파일을 확인한다: 아쉽게도 이번 출판 작업에는 진보된 도구를 사용하지 않고 MS Word 파일을 구글 drive 에 올려 사용하고 있습니다. google drive 를 로컬 컴퓨터에 마운트해 두고, MS Word 를 열어 해당 파일을 열고 작업을 하게 됩니다. 이 경우 동시 작업이 굉장히 제한됩니다. 다행인 점은 당분간 @Il Sup Lee 님은 원고작업을 하기 어렵고, @이장후 는 파리에 있어 파일 편집 시간대가 같지 않습니다. 파일을 작성하시기 전 카톡을 남겨 주시고, 파일 작성을 마치고 카톡을 남겨 주세요. 휴먼 뮤텍스입니다!
3.
파일을 수정한다: 파일은 반드시 추적 기능을 활성화하고 편집합니다. 파일이 분리되어도 어떤 부분이 수정되었는지 금방 확인이 가능합니다.
4. 궐기!
이 글을 읽고 다시 읽어 주세요!
지금 상태로라면 아마존 기준 4점짜리 오라일리 책이 됩니다. 좋은 책들은 4.5점 그냥 넘어가는거 아시죠? 저희가 저자는 아니지만, 책이라는 것은 저희 손으로 만드는, 이름이 걸리는 작품입니다. 지금은 마지막 스퍼트를 달리는 단계입니다. 리소스 투자를 너무 많이 하신다고 생각하실 수 있지만, 가장 가성비 좋은 부분을 하고 계신다는 점은 정말 정말 약속드릴 수 있습니다. 한국에서만큼은 훌륭한 책이 될 수 있도록 저희가 할 수 있는 만큼 최선을 다해 보도록 합시다!
5. 소스코드 수정 사항
9장 147페이지 @4/26/2023 워드 파일에 반영완료
@4/26/2023 워드 파일에 반영완료9장 148페이지 @4/26/2023 워드 파일에 반영완료
@4/26/2023 워드 파일에 반영완료9장 158페이지 @4/29/2023
@4/29/2023 9장 158페이지 @4/29/2023
@4/29/20239장 159페이지 @4/29/2023
@4/29/20239장 160페이지 @4/29/2023
@4/29/20239장 165페이지 @4/29/2023
@4/29/20239장 166페이지 @4/29/2023
@4/29/20239장 167페이지 @4/29/2023
@4/29/202310장 7페이지 @4/23/2023 워드 파일에 반영완료
@4/23/2023 워드 파일에 반영완료10장 8페이지 @4/23/2023 워드 파일에 반영완료
@4/23/2023 워드 파일에 반영완료11장 6페이지
11장 11페이지
11장 12페이지
11장 12페이지
11장 13페이지
11장 14페이지
11장 15페이지
11장 16페이지
11장 22페이지
11장 26페이지
12장 398페이지
6장 202페이지
6장 204페이지
6. 아키텍쳐 수정 필요 사항
9장 153페이지 (반영 X) @4/29/2023
7. 중요한 욕심
글에 노란 줄이 쳐진 부분이 추가 된 부분 입니다.
글에 삭제줄 쳐진 부분이 삭제 된 부분입니다.
•
1_2_3_4_5_6_7_9_12 쿠버네티스 파트
[ 책 반영 @4/29/2023] 9.1.2 ‘hello world’ 쿠버네티스 324페이지
책 반영 @4/29/2023] 9.1.2 ‘hello world’ 쿠버네티스 324페이지 [ 책 반영 @4/29/2023] 9.1.2 ‘hello world’ 쿠버네티스 326페이지
책 반영 @4/29/2023] 9.1.2 ‘hello world’ 쿠버네티스 326페이지[ 책 반영 @4/29/2023] 9.1.2 ‘hello world’ 쿠버네티스 327페이지 (@4/29/2023 )
책 반영 @4/29/2023] 9.1.2 ‘hello world’ 쿠버네티스 327페이지 (@4/29/2023 )[ 책 반영 @4/29/2023] 9.1.2 ‘hello world’ 쿠버네티스 334페이지
책 반영 @4/29/2023] 9.1.2 ‘hello world’ 쿠버네티스 334페이지[ 책 반영] 9.1.2 ‘hello world’ 쿠버네티스 HPA 실습
책 반영] 9.1.2 ‘hello world’ 쿠버네티스 HPA 실습기타 논의 @4/2/2023
•
9장
1.
너무 초심자를 배려하지 않은 설명: 큐브플로, 쿠버네티스… 대거 개편
a.
큐브플로
b.
마스터노드 - 워커 노드 아키텍처
c.
Pod 가 죽어도 자동으로 재생성된다는 개념
2.
쿠버네티스가 하고자 하는 것들 중에 가장 중요한 부분도 제대로 설명하지 못한다. (로드밸런싱, 되살리기, 오토스케일링 등)
a.
Pod 가 죽어도 자동으로 재생성되는 실습 예제
3.
머신러닝 서비스를 구축하지도 않고 coin 예제를 사용한다.
parse me : 언젠가 이 글에 쓰이면 좋을 것 같은 재료들.
1.
None
from : 과거의 어떤 생각이 이 생각을 만들었는가?
1.
supplementary : 어떤 새로운 생각이 이 문서에 작성된 생각을 뒷받침하는가?
1.
None
opposite : 어떤 새로운 생각이 이 문서에 작성된 생각과 대조되는가?
1.
None
to : 이 문서에 작성된 생각이 어떤 생각으로 발전되고 이어지는가?
1.
None
참고 : 레퍼런스
1.
None