스크린샷, 설명, 기타 메타데이터를 Nerdpack에 추가하고 모두 Instant 옵저버빌리티 에 업로드하세요.
CLI 업데이트
명령을 실행하기 전에 최신 버전의 CLI가 있는지 확인하십시오.
$nr1 update
권한을 확인하세요
Nerdpack을 게시하고 카탈로그 정보를 업데이트하려면 다음이 필요합니다.
- 게시한 계정에 액세스합니다.
- Nerdpack 관리에 필요한 권한입니다 .
Nerdpack 게시
카탈로그 정보를 업데이트하려면 먼저 생성한 Nerdpack을 게시 해야 합니다.
Nerdpack의 카탈로그 메타데이터 업데이트
Nerdpack을 Instant 옵저버빌리티 카탈로그에 게시한 후 Nerdpack의 메모데이터를 업데이트하여 사용자에게 Nerdlet 또는 시각화에 대한 모든 정보를 알려주세요.
{ "tagline": "", "details": "", "categoryTerms": [], "keywords": [], "repository": "", "whatsNew": "", "support": { "email": { "address": "" }, "issues": { "url": "" }, "community": { "url": "" } }}
뉴렐릭 홈페이지에서 상단 탐색 메뉴의 + Integrations & Agents 으로 이동하세요.
앱 필터나 검색창을 사용하여 게시된 Nerdpack을 찾으세요. Nerdpack의 이름과 nr1.json
에 있는 간략한 설명 외에는 정보나 세부정보 페이지가 없습니다. 스크린샷, 아이콘, 세부정보 또는 새로운 기능이 없습니다. 이를 위해서는 Nerdpack에 카탈로그 정보를 제공해야 합니다.
Nerdpack의 루트에서 Nerdpack의 스크린샷과 메타데이터를 보관할 카탈로그 디렉터리를 만듭니다.
$nr1 create --type catalog✔ created: launchers/launcher/catalog✔ created: nerdlets/home/catalog✔ catalog created successfully! catalog is available at "./catalog"
루트 catalog
디렉터리 내에서 Nerdpack에 대한 정보를 사용자에게 표시하기 위한 특정 파일과 디렉터리를 찾을 수 있습니다.
$ls catalogREADME.md additionalInfo.md config.json documentation.md screenshots
파일 | 설명 |
---|---|
읽어보기.md | 카탈로그의 정보와 메타데이터를 사용하는 방법을 알려주는 마크다운 파일 |
구성.json | 다음 필드를 포함하는 JSON 파일:
|
문서.md | Nerdpack의 Nerdlets 또는 시각화를 사용하는 방법을 사용자에게 알려주는 마크다운 파일입니다. 이는 세부정보 보기의 Documentation [문서] 탭에 표시됩니다. |
추가정보.md | 애플리케이션 사용에 대한 추가 정보를 위한 선택적 마크다운 파일 |
스크린샷 | Nerdlet의 선택된 이미지 또는 시각화와 같이 Nerdpack을 보여주는 스크린샷이 포함된 디렉토리입니다. 여기에는 6개 이상의 이미지가 포함될 수 있습니다. 모든 스크린샷은 다음 기준을 충족해야 합니다.
|
또한 이 명령은 Nerdpack의 각 실행기, Nerdlet 및 시각화에 대한 catalog
디렉터리를 생성합니다. 내부에는 각 Nerdpack 항목에 대한 스크린샷을 추가할 수 있는 디렉토리가 있습니다.
$ls launchers/launcher/catalogscreenshots$ls nerdlets/home/catalogscreenshots
Nerdpack의 documentation.md
파일을 업데이트합니다.
Enter your first and last name into the fields provided. When you're done, press **Submit** to see a personalized "Hello!" message.
config.json
파일을 업데이트합니다.
{ "tagline": "Say hi!", "details": "DemoApp says Hello to a user.", "categoryTerms": [], "keywords": ["hello world"], "repository": "https://github.com/newrelic/developer-website", "whatsNew": "feat: Initial commit"}
루트 screenshots
디렉터리 또는 Nerdpack 항목 screenshots
디렉터리에 스크린샷을 포함합니다.
Instant 옵저버빌리티 카탈로그에 정보를 제출하십시오:
$nr1 catalog:submitUploading screenshots from demo-app... ✔ Screenshots uploaded from: demo-appUploading screenshots from demo-app/launchers/launcher... ✔ Screenshots uploaded from: demo-app/launchers/launcherUploading screenshots from demo-app/nerdlets/home... ✔ Screenshots uploaded from: demo-app/nerdlets/home ✔ Updated metadata for DemoApp 1.0.0
변경 사항을 보려면 Instant 옵저빌리버티로 이동하세요. 새로운 세부정보를 보려면 Nerdpack을 클릭하세요. 그런 다음 What's inside [내부 내용을] 클릭하여 Nerdpack의 개별 항목에 대해 업로드한 스크린샷을 확인하세요.
Nerdpack 아이콘 업데이트
Nerdpack 내에서는 두 가지 유형의 아이콘을 설정할 수 있습니다.
- 카탈로그에서 Nerdpack을 나타내는 전체 Nerdpack에 대한 하나입니다.
- Nerdlet을 나타내는 각 실행기당 하나씩입니다.
이러한 아이콘을 교체하고 Nerdpack을 게시하여 변경 사항을 확인하세요.
Nerdpack 루트에서 icon.png
업데이트합니다. 이 아이콘은 카탈로그와 Nerdpack의 상세 페이지에서 사용됩니다.
하나 이상의 실행기로 Nerdpack을 빌드하는 경우 각 실행기의 하위 폴더에서 icon.png
업데이트하세요.
package.json
버전을 업데이트하세요.
{ "private": true, "name": "demo-app", "version": "1.0.1", "scripts": { "start": "nr1 nerdpack:serve", "test": "exit 0" }, "nr1": { "uuid": "f2dbc999-e9a3-49b9-933d-5a704c6750bd" }, "dependencies": { "prop-types": "^15.6.2", "react": "^16.6.3", "react-dom": "^16.6.3" }, "browserslist": ["last 2 versions", "not ie < 11", "not dead"]}
이를 통해 Nerdpack의 새 버전을 게시할 수 있습니다.
Nerdpack 게시 :
$nr1 nerdpack:publish
catalog/config.json
에서 whatsNew
문자열을 업데이트합니다.
{ "tagline": "Say hi!", "details": "DemoApp says Hello to a user.", "categoryTerms": [], "keywords": ["hello world"], "repository": "https://github.com/newrelic/developer-website", "whatsNew": "feat: Add new icons"}
이것은 Nerdpack의 최신 버전에 추가한 내용을 사용자에게 알려줍니다.
이 새 메타데이터를 카탈로그에 제출합니다.
$nr1 catalog:submitUploading screenshots from demo-app... ✔ Screenshots uploaded from: demo-appUploading screenshots from demo-app/launchers/launcher... ✔ Screenshots uploaded from: demo-app/launchers/launcherUploading screenshots from demo-app/nerdlets/home... ✔ Screenshots uploaded from: demo-app/nerdlets/home ✔ Updated metadata for DemoApp 1.0.1
카탈로그로 이동하여 Nerdpack을 구독하여 새 아이콘을 확인하세요.
카탈로그 정보 제출 관련 문제 해결
때로는 카탈로그 메타데이터로 작업할 때 문제가 발생할 수 있습니다. 이러한 문제를 해결하기 위한 몇 가지 일반적인 솔루션을 고려해 보십시오.
Nerdpack 게시
이미 게시된 Nerdpack에 대한 카탈로그 메타데이터만 제출할 수 있다는 점을 기억하세요. 게시되지 않은 Nerdpack에 대한 정보를 제출하려고 하면 CLI가 다음을 지원하려고 시도합니다.
$nr1 catalog:submitUploading screenshots... › Error: 1 error while updating DemoApp 1.0.0 › › Invalid Version: Nerdpack version 1.0.0 not found. Have you run `nr1 nerdpack:publish` yet? › Code: UNKNOWN
이미지 크기 조정
카탈로그의 스크린샷은 이 가이드의 앞부분에 지정된 기준을 충족해야 합니다. 그렇지 않은 경우 CLI는 다음을 지원하려고 시도합니다.
$nr1 catalog:submitUploading screenshots... › Error: 2 errors while updating DemoApp 1.0.1 › › catalog/screenshots/screenshot.png › Invalid Screenshot: screenshot.png has a size ratio of 4:2. Update size ratio to 3:2. › › catalog/screenshots/screenshot.png › Invalid Screenshot: screenshot.png has a width of 3054px. Update size to be between 1600px and 2400px. › Code: UNKNOWN
끈의 길이를 확인하세요
config.json
의 콘텐츠 대부분에는 문자열 길이 요구 사항이 있습니다. config.json
파일을 업데이트할 때 이러한 요구 사항을 검토하고 이를 준수해야 합니다. 그렇지 않으면 설정을 카탈로그에 제출하려고 할 때 오류가 표시됩니다.
$nr1 catalog:submitUploading screenshots... ✔ Screenshots uploaded › Error: 2 errors while updating DemoApp 1.0.1 › › catalog/config.json › Invalid Metadata: `details` has a character length of 2204. Must be no longer than 1000 characters › › catalog/config.json › Invalid Metadata: `tagline` has a character length of 266. Must be no longer than 30 characters › Code: UNKNOWN