In Red Hat OpenShift 4.6, we introduced quick starts, an exciting feature that enables users to learn more about new key services and features. As we’ve added more quick starts to the OpenShift console, we thought that our users may want to add their own to the console as well. So, the quick start custom resource definition (CRD) was born.
Read on to learn more about how administrators can create their own quick starts and make them available in their cluster using the ConsoleQuickStart CRD.
Accessing the ConsoleQuickStart CRD
To access the ConsoleQuickStart CRD, enter the Administrator perspective. Then select Administration > CustomResourceDefinitions:
In the list view, click ConsoleQuickStart CRD, and then click the Instances tab. You’ll see a list of the quick starts that are already in the console. These are shipped with the console operator and are already accessible from the quick starts catalog page, which you can find under the help menu:
OpenShift 4.7 Blog: Quick Starts Extensibility
To create your own quick start, click Create ConsoleQuickStart. You’ll notice the YAML editor is prefilled. We’ve included a small sample quick start to help show you the ropes of creating your own. Notice that the resource’s schema is also shown to the right of the YAML editor. This will be useful if you want to dive into the resource’s spec to better understand how to build your quick start:
Starting With a Sample
Now, let’s dive into the ConsoleQuickStart YAML sample. The quick start YAML sample can be created as-is. No need to edit it if you just want to create something quickly to see the CRD work. Feel free to click Create, and then navigate to the quick start catalog. You’ll see a new card appear called Deploy image:
Walk through the sample quick start and compare it to the quick start’s YAML so that you get a better sense of how the YAML content maps to the actual quick start. Let’s look at some examples.
First, let’s take a look at a section of YAML and the corresponding quick start tile:
- The displayName is what appears on the quick start tile and panel header.
- The durationMinutes shows on both the tile as a badge and at the top of the panel. This lets you define the estimated time required for completing the quick start.
- The description is the short blurb that appears on the tile, giving users a preview of what’s to come in the quick start.
- The introduction corresponds to the introduction panel of the quick start. Here, you can go into more detail about what the quick start will walk users through and why it’s useful.
- You can also use tags to categorize the type of content in your quick start. In future releases, we’re hoping to allow users to filter by different tags and categories to better find what they need in the quick start catalog.
You can continue viewing the rest of the YAML section with its corresponding quick start areas.
Tip: As a shortcut, go to the quick start catalog and open your quick start so that it’s viewable in the side panel. Once you do that, navigate back to your quick start CRD’s YAML to see both at the same time:
Writing Best Practices
Now that we’ve walked through how to create a quick start, let’s go over some quick start content best practices:
- Make sure your content is technically accurate.
- Use plain language and short sentences so that users can easily follow along.
- Follow this content guidelines document so that your quick start is clear and consistent. It covers how to write card copy, the introduction, task steps, modals, and more.
We look forward to seeing all the cool quick starts you create!
Want to Try It Out?
If you are up for trying out this new feature, or if you are just getting started with OpenShift, visit Try OpenShift to get instant access to a cluster.
And, as always, we want to connect with users like you. Learn more about what the OpenShift design team is up to on our OpenShift Design site, and be sure to catch us on the OpenShift Twitch channel.
저자 소개
채널별 검색
오토메이션
기술, 팀, 인프라를 위한 IT 자동화 최신 동향
인공지능
고객이 어디서나 AI 워크로드를 실행할 수 있도록 지원하는 플랫폼 업데이트
오픈 하이브리드 클라우드
하이브리드 클라우드로 더욱 유연한 미래를 구축하는 방법을 알아보세요
보안
환경과 기술 전반에 걸쳐 리스크를 감소하는 방법에 대한 최신 정보
엣지 컴퓨팅
엣지에서의 운영을 단순화하는 플랫폼 업데이트
인프라
세계적으로 인정받은 기업용 Linux 플랫폼에 대한 최신 정보
애플리케이션
복잡한 애플리케이션에 대한 솔루션 더 보기
오리지널 쇼
엔터프라이즈 기술 분야의 제작자와 리더가 전하는 흥미로운 스토리
제품
- Red Hat Enterprise Linux
- Red Hat OpenShift Enterprise
- Red Hat Ansible Automation Platform
- 클라우드 서비스
- 모든 제품 보기
툴
체험, 구매 & 영업
커뮤니케이션
Red Hat 소개
Red Hat은 Linux, 클라우드, 컨테이너, 쿠버네티스 등을 포함한 글로벌 엔터프라이즈 오픈소스 솔루션 공급업체입니다. Red Hat은 코어 데이터센터에서 네트워크 엣지에 이르기까지 다양한 플랫폼과 환경에서 기업의 업무 편의성을 높여 주는 강화된 기능의 솔루션을 제공합니다.