이 페이지에는 Google Season of Docs에 선정된 기술 문서 프로젝트의 세부정보가 포함되어 있습니다.
프로젝트 요약
- 오픈소스 조직:
- FreeBSD 프로젝트
- 기술 문서 작성자:
- 래리
- 프로젝트 이름:
- FreeBSD 핸드북 업데이트
- 프로젝트 길이:
- 장기 실행 (5개월)
Project description
이 GSoD2020 프로젝트는 FreeBSD 핸드북의 두 장으로 구성됩니다.
- 테스트: FreeBSD 개발자 핸드북의 새로운 장
- LDAP: 업데이트된 도움말이 FreeBSD 핸드북의 장에 병합됨
테스트: FreeBSD 개발자 핸드북의 새로운 챕터:
참고: 이 프로젝트는 초기 단계에서 더 탐색적인 성격을 띌 것입니다. 작성 단계에서는 요구사항이 변경될 수 있습니다.
준비 작업에는 다음이 포함됩니다. * FreeBSD 및 기타 BSD의 개발자 테스트 프레임워크, 관행 등에 관한 현재 문서 및 메모 검토 * 현재 또는 이전 FreeBSD 문서 및 메모 예를 들면 다음과 같습니다. * TestSuite: https://wiki.freebsd.org/TestSuite * 이전 'TestingFreeBSD' 페이지: https://wiki.freebsd.org/TestingFreeBSD * 관련 프로젝트의 최신 문서 및 메모 예를 들면 다음과 같습니다. * http://wiki.netbsd.org/tutorials/atf/ * 관련 도구의 기본 문서 예를 들면 다음과 같습니다. * Kyua 테스트 프레임워크: https://github.com/jmmv/kyua/ * 자동화 테스트 프레임워크 (ATF): https://github.com/jmmv/atf/ * 관련 프레임워크를 설치하고 구성하여 익숙해집니다. * 테스트 프레임워크를 사용하여 현재 테스트 실행 * 소수의 새 테스트 작성 * (매우 중요) 독자 (소프트웨어 개발자 및 테스터)에게 챕터에서 보고 싶은 내용에 관해 컨설트합니다.
문서의 정확한 구성은 결정되지 않았습니다. 하지만 이 장을 읽은 후에는 다음 작업을 최소한 수행할 수 있어야 합니다.
- FreeBSD를 테스트하기 위해 테스트 프레임워크를 설치하고 구성합니다.
- 테스트 프레임워크 테스트를 작성합니다.
- 테스트 프레임워크에서 테스트를 실행합니다.
가능한 경우 다음 사항이 강조됩니다. * 자동화를 극대화하여 테스트 인프라 설정, 테스트 작성, 테스트 실행 작업을 줄입니다. * 새 버그가 수정될 때마다 테스트 사례를 추가합니다. * 포괄적인 자동 회귀 테스트 * (해당하는 경우) 단위 테스트, 기능 테스트, 부하 테스트와 같은 표준 테스트 시나리오의 예를 다룹니다.
가능한 경우 개발자에게 테스트 프레임워크를 설명하고 안내하는 데 그치지 않고, 프로세스를 최대한 간단하게 유지하여 개발자가 더 많은 테스트를 통합하고 신규 개발자의 참여가 지연되지 않도록 하는 것이 목표입니다.
LDAP: 업데이트된 도움말이 FreeBSD 핸드북의 챕터에 병합되었습니다.
LDAP에서 테스트 장과 달리 업데이트된 도움말 또는 장의 범위는 잘 알려져 있습니다.
FreeBSD 핸드북의 현재 챕터와 이 도움말에는 모두 유용한 정보가 많이 포함되어 있습니다. 하지만 업데이트해야 합니다. 새 챕터가 될 새로운 버전의 도움말이 시작되었지만 완료해야 합니다.
다음과 같은 작업이 포함됩니다. * 현재 핸드북 챕터 및 현재 도움말의 교정 * GSoD2020에 대비하여 초기 패스가 완료되었습니다. * 핸드북의 각 섹션을 테스트하여 무엇이 효과가 있고 무엇을 수정해야 하는지 확인합니다. * GSoD2020에 대비하여 서버 구성을 개선사항이 식별된 상태로 테스트했습니다. * 다른 섹션이 남아 있습니다. * 신규 콘텐츠 작성 및 현재 콘텐츠 수정 * 서버 섹션의 업데이트된 콘텐츠가 시작되었습니다. 완료해야 합니다. * 기타 섹션은 남아 있습니다. * 최종 초안이 완료된 후 클린 FreeBSD 시스템에서 모든 콘텐츠를 테스트합니다. * 이 작업은 누락된 부분을 파악하는 데 중요하므로 중요합니다.
최종 도움말 또는 핸드북 챕터에는 다음 섹션이 포함되어야 합니다.
(1) LDAP 소개 (2) 서버 구성: (a) FreeBSD에서 작동하는 기본 OpenLDAP 서버 구성에 관한 설명 워크스루입니다. (b) FreeBSD에서 기본적이지만 작동 가능한 OpenLDAP 서버 구성(예: (2a의 결과))에 대한 완전한 예.
'기본적이지만 작동'에는 해싱된 비밀번호가 있는 서버 구성, 네트워크를 통한 보안 연결, 시뮬레이션되었지만 대표적인 사용자 데이터 예시가 포함됩니다.
(선택사항 - GSoD2020 중에 결정됨) 서버 구성에 FreeBSD의 389 디렉터리 서버에 상응하는 적용 범위가 포함될 수도 있습니다. 389 Directory Server에는 실험용 FreeBSD 지원이 있었지만 현재 상태를 확인해야 합니다.
(3) 클라이언트 구성: (a) (2)에 제공된 예시 서버 연결에 연결할 수 있는 FreeBSD의 기능 클라이언트 구성에 관한 설명 워크스루입니다. (b) FreeBSD에서 작동하는 클라이언트 구성의 전체 예(예: (3a)의 결과)
클라이언트 구성 섹션에는 다음에 관한 하위 섹션이 포함됩니다. * 플러그인 인증 모듈 (PAM), 예: pam_ldap, pam_mkhomedir, nss-pam-ldapd * 이름 서비스 스위치 (NSS), 예: nss_ldap, nss-pam-ldapd * (선택사항 - GSoD2020 중에 결정됨) SSSD - FreeBSD의 프로덕션 환경에서 SSSD의 상태를 확인해야 합니다. * (선택사항 - GSoD2020 중에 결정됨) FreeIPA - FreeBSD에서 FreeIPA의 사용 및 기능을 조사해야 합니다. FreeIPA는 LDAP 외에도 다양한 항목을 다루므로 이 핸드북 챕터에 포함하기 전에 FreeIPA 구성의 범위를 평가해야 합니다.
(4) 보안 고려사항 * 이 도움말의 현재 버전에는 보안 고려사항에 관한 섹션이 포함되어 있습니다. 이 콘텐츠 중 일부는 관련 섹션으로 이동될 수 있습니다. 하지만 참고용으로 보안 고려사항에 관한 전용 섹션은 있어야 합니다.
(5) 문제 해결 * LDAP 구성 문제를 해결하기 위한 전략
(6) OpenSSL 부록
업데이트된 핸드북 챕터 / 도움말을 통해 독자는 두 개의 클린 FreeBSD 시스템을 가져와 LDAP 서버와 LDAP 클라이언트를 설정하고 서버에 대해 클라이언트를 인증할 수 있습니다.
업데이트된 핸드북 챕터 / 도움말을 읽은 후에는 독자가 OpenLDAP 문서, LDAP RFC와 같은 더 전문적이거나 포괄적인 문서를 살펴보고 요구사항을 충족하도록 FreeBSD LDAP 구성을 빌드하거나 수정하는 데 필요한 기반을 갖추게 됩니다.