보다 편리한 설명을 위해 OEX에서 프로젝트에 배지를 사용하는 관행

GitHub, GitLab 등의 리포지토리에 있는 현재 프로젝트에 대한 유용한 정보와 함께 README.MD 파일에서 아름다운 배지를 보는 것이 점점 더 보편화되고 있습니다.
예를 들어:





프로젝트가 개발 중입니다The quality of the code. 또한 자체 배지를 제공하여 프로젝트의 코드 유효성 검사 상태를 즉시 보여줍니다. README.MD 파일에 줄을 삽입하면

 [![Quality Gate Status](https://community.objectscriptquality.com/api/project_badges/measure?project=intersystems_iris_community%2Fappmsw-zpm-shields&metric=alert_status)](https://community.objectscriptquality.com/dashboard?id=intersystems_iris_community%2Fappmsw-zpm-shields)

그리고 /.github/workflows/ 디렉터리 github 프로젝트 파일 objectscript-quality.yml에서 다음 배지를 볼 수 있습니다.



이러한 명판을 부여하는 다양한 서비스가 있습니다.
예를 들면 - Shield.io
Markdown으로 작성된 마크업을 포함하여 링크 생성을 단순화하는 화면 양식도 실행합니다.



오랫동안 my projects에서 다양하고 아름답고 유용한 명판을 많이 사용해 왔습니다.

패키지 관리자ZPM의 프로젝트가 완성됨에 따라 패키지 모듈의 저장소 리소스에 대한 요구 사항도 증가합니다.

이제는 프로젝트 파일을 열지 않고도 첫 페이지에서 한눈에 볼 수 있는 더 자세한 정보를 알아야 하는 경우가 점점 더 자주 발생합니다. 이러한 데이터에는 다음이 포함됩니다.

저장소에 저장된 프로젝트 버전. module.xml 파일을 확인하지 않고 확인해야 합니다.

해당 버전이 공개 저장소에 있는 버전과 어떻게 관련되어 있는지. 이미 릴리스를 업데이트할 적절한 시기입니까?...

dockerfile이라는 docker 파일의 설정에서 전달되는 포트는 무엇입니까?

이 모든 것은 shields.io 서비스에서 잘 수행됩니다.

module.xml 파일에서 가져온 zpm 프로젝트의 버전을 표시합니다.

![Repo-GitHub](https://img.shields.io/badge/dynamic/xml?color=gold&label=GitHub%20module.xml&prefix=ver.&query=%2F%2FVersion&url=https%3A%2F%2Fraw.githubusercontent.com%2Fsergeymi37%2Fzapm%2Fmaster%2Fmodule.xml)

클릭하여 해당 파일을 여는 기능을 추가하여 링크를 복잡하게 만들 수 있습니다module.xml.

[![Repo-GitHub](https://img.shields.io/badge/dynamic/xml?color=gold&label=GitHub%20module.xml&prefix=ver.&query=%2F%2FVersion&url=https%3A%2F%2Fraw.githubusercontent.com%2Fsergeymi37%2Fzapm%2Fmaster%2Fmodule.xml)](https://raw.githubusercontent.com/sergeymi37/zapm/master/module.xml)

서비스에서 가져온 zpm 프로젝트의 버전 표시

![OEX-zapm](https://img.shields.io/badge/dynamic/json?url=https:%2F%2Fpm.community.intersystems.com%2Fpackages%2Fzapm%2F&label=ZPM-pm.community.intersystems.com&query=$.version&color=green&prefix=zapm)

서비스 요청 링크의 예:

[![OEX-zapm](https://img.shields.io/badge/dynamic/json?url=https:%2F%2Fpm.community.intersystems.com%2Fpackages%2Fzapm%2F&label=ZPM-pm.community.intersystems.com&query=$.version&color=green&prefix=zapm)](https://pm.community.intersystems.com/packages/zapm)

dockerfile이라는 도커 파일의 설정에서 전달되는 포트 표시

 ![Docker-ports](https://img.shields.io/badge/dynamic/yaml?color=blue&label=docker-compose&prefix=ports%20-%20&query=%24.services.iris.ports&url=https%3A%2F%2Fraw.githubusercontent.com%2Fsergeymi37%2Fzapm%2Fmaster%2Fdocker-compose.yml)

파일을 여는 링크의 예docker-compose.yml:

[![Docker-ports](https://img.shields.io/badge/dynamic/yaml?color=blue&label=docker-compose&prefix=ports%20-%20&query=%24.services.iris.ports&url=https%3A%2F%2Fraw.githubusercontent.com%2Fsergeymi37%2Fzapm%2Fmaster%2Fdocker-compose.yml)](https://raw.githubusercontent.com/sergeymi37/zapm/master/docker-compose.yml)

그러나 더 복잡한 메트릭, 그 조합 또는 사설 로컬 네트워크 내부의 프로젝트에 관해서는 이러한 목적을 위해 저장소 파일 및 서비스https://pm.community.intersystems.com/에서 ZPM 모듈의 버전을 표시하는 결정to bring about my REST service을 결정했습니다.

설치 후 인증 없이 액세스를 제공해야 하는 서비스zpm-shields가 있습니다.

이 링크를 사용하면 예를 들어 README.MD에 삽입할 수 있는 svg 파일을 얻을 수 있습니다.

![Repo](http://localhost:52773/zpm-shields/repo/mode?module=https:%2F%2Fgithub.com%2FSergeyMi37%2Fzapm&color=blue)

여기서 매개변수 값은 다음과 같습니다.zpm-shields/repo - 파일 module.xml 버전에서 추출module - 저장소 링크color - 예: #00987

![Registry](http://localhost:52773/zpm-shields/registry/mode?project=appmsw-dbdeploy&color=gold)

여기서 매개변수 값은 다음과 같습니다.zpm-shields/registry - 서비스에서 요청하여 버전 가져오기project - 프로젝트 이름

![Repo+Registry](http://localhost:52773/zpm-shields/both/mode?module=sergeymi37%2Fappmsw-dbdeploy&project=appmsw-dbdeploy&color=FFA07A)

여기서 매개변수 값은 다음과 같습니다.zpm-shields/both - 파일 module.xml 버전에서 추출하고 서비스에서 요청하여 버전 가져오기project - 프로젝트 이름module - 저장소 링크

내 서비스는 로컬 ZPM 리소스에도 사용할 수 있습니다. 이를 위해서는 로컬 리포지토리 및 개인 레지스터의 전체 경로를 활용해야 합니다.

나는이 배지를 정말 좋아합니다. 나는 그들이 당신에게도 도움이 될 것이라고 생각합니다.