openshift/rosa

ملف openshift

آخر نشاط مصدر مسجل: ٢٢ سبتمبر ٢٠٢٦ في ١٤:٠٤

آخر تحديث لفهرس SkillsMP: ١٧ أكتوبر ٢٠٢٦ في ٠٠:٠٩

skills مجمعة: ٤

نجوم GitHub: ١٠٣
تفرعات GitHub: ٢٦٠

ملف README للمستودع

مصدر ملف README للمستودع: README.md

قراءة الملف الأصلي

عرض ملف README كاملًا

# Red Hat OpenShift Service on AWS (ROSA) Command Line Tool This project contains the `rosa` command line tool that simplifies the use of Red Hat OpenShift Service on AWS, also known as _ROSA_. ## Quick start guide Refer to the official ROSA documentation: https://access.redhat.com/products/red-hat-openshift-service-aws 1. Follow the [AWS Command Line Interface](https://aws.amazon.com/cli/) documentation to install and configure the AWS CLI for your operating system. 2. Download the [latest release of rosa](https://github.com/openshift/rosa/releases/latest) and add it to your path. 3. Initialize your AWS account by running `rosa init` and following the instructions. 4. Create your first ROSA cluster by running `rosa create cluster --interactive` ## Contributor setup BEFORE MAKING YOUR FIRST COMMIT IN A CLONE, YOU MUST INSTALL LOCAL GIT HOOKS: ``` make install-hooks ``` YOU MUST LET THESE HOOKS RUN ON EVERY COMMIT AND PUSH. DO NOT BYPASS LOCAL HOOKS. Installed hooks run staged-file formatting at commit time and full verification checks before push. Formatting commands: - `make fmt` formats all Go files in `cmd/`, `pkg/`, and `tests/` and fails if rewrites were needed so you can review/stage changes - `make fmt-staged` formats only staged Go files and fails if it had to rewrite files so you can review/stage changes - `make fmt-check` validates formatting without changing files - changed-files coverage checks use `github.com/vearutop/gocovdiff@v1.4.2` via `go run` and fetch it automatically when missing See `CONTRIBUTING.md` for the full contribution workflow and commit requirements. ## Repository guidance - [AGENTS.md](AGENTS.md) routes agents to the topic-specific guidance for this repository. - `CONTRIBUTING.md` is the canonical contributor workflow for humans and agents. - [guidelines/](guidelines/) contains tool-agnostic architecture and domain guidance. ## Build from source If you'd like to build this project from source use the following steps: 1. Clone the repository ``` git clone https://github.com/openshift/rosa.git ``` 2. `cd` to the checkout out source directory ``` cd rosa ``` 3. Install the binary ``` make install ``` NOTE: If you don't have `$GOPATH/bin` in your `$PATH` you need to add it or move `rosa` to a standard system directory eg. for Linux/OSX: ``` sudo install -m 0755 "$GOPATH/bin/rosa" /usr/local/bin/rosa ``` ## Try the ROSA cli from binary If you don't want to build from sources you can retrieve the `rosa` binary from the latest image. You can copy it to your local with this command: ``` podman run --pull=always --rm registry.ci.openshift.org/ci/rosa-aws-cli:latest cat /usr/bin/rosa > ~/rosa && chmod +x ~/rosa ``` Also you can test a binary created after a specific merged commit just using the commit hash as image tag: ``` podman run --pull=always --rm registry.ci.openshift.org/ci/rosa-aws-cli:f7925249718111e3e9b61e2df608a6ea9cf5b6ce cat /usr/bin/rosa > ~/rosa && chmod +x ~/rosa ``` NOTE: There is a side-effect of container image registry authentication which results in an [auth error](https://docs.ci.openshift.org/docs/how-tos/use-registries-in-build-farm/#why-i-am-getting-an-authentication-error) when your token is expired even when the image requires no authentication. In that case all you need to do is authenticate again: ``` $ oc registry login info: Using registry public hostname registry.ci.openshift.org Saved credentials for registry.ci.openshift.org $ cat ~/.docker/config.json | jq '.auths["registry.ci.openshift.org"]' { "auth": "token" } ``` ## Secure Credentials Storage The `OCM_KEYRING` environment variable provides the ability to store the ROSA configuration containing your authentication tokens in your OS keyring. This is provided as an alternative to storing the configuration in plain text on your system. `OCM_KEYRING` will override all other token or configuration related flags. `OCM_KEYRING` supports the following keyrings: * [Windows Credential Manager](https://support.microsoft.com/en-us/windows/accessing-credential-manager-1b5c916a-6a16-889f-8581-fc16e8165ac0) - `wincred` * [macOS Keychain](https://support.apple.com/en-us/guide/keychain-access/welcome/mac) - `keychain` * Secret Service ([Gnome Keyring](https://wiki.gnome.org/Projects/GnomeKeyring), [KWallet](https://apps.kde.org/kwalletmanager5/), etc.) - `secret-service` * [Pass](https://www.passwordstore.org/) - `pass` To ensure `OCM_KEYRING` is provided to all `rosa` commands, it is recommended to set it in your `~/.bashrc` file or equivalent. | | wincred | keychain | secret-service | pass | | ------------- | ------------- | ------------- | ------------- | ------------- | | Windows | :heavy_check_mark: | :x: | :x: | :x: | | macOS | :x: | :heavy_check_mark: | :x: | :heavy_check_mark: | | Linux | :x: | :x: | :heavy_check_mark: | :heavy_check_mark: | ## Have you got feedback? We want to hear it. [Open an issue](https://github.com/openshift/rosa/issues/new) against the repo and someone from the team will be in touch.

جارٍ تحميل ملف README للمستودع…

Skills في هذا المستودع

مطوّرو البرمجيات

١ فئات مهنية · 75% مصنفة

skill

المهنة

الوصف

آخر تحديث

rosa-aws-context

غير مصنف

Cross-check AWS-facing code and docs against official ROSA and AWS references before changing behavior.

لغة النص الأصلي: الإنجليزية

2026-09-22

rosa-command-authoring

مطوّرو البرمجيات

Add or edit Cobra commands in openshift/rosa while keeping command wiring thin and package logic aligned with repo structure.

لغة النص الأصلي: الإنجليزية

2026-04-13

rosa-docs-and-structure-tests

مطوّرو البرمجيات

Keep CLI docs, structure tests, and user-facing guidance in sync when commands or workflow docs change.

لغة النص الأصلي: الإنجليزية

2026-04-13

rosa-verification-gates

مطوّرو البرمجيات

Choose the right local verification steps before claiming a ROSA change is complete.

لغة النص الأصلي: الإنجليزية

2026-04-13

عرض ٤ من أصل ٤ skills مجمعة.

التثبيت بمساعدة مساعد ذكي

انسخ هذا الطلب إلى المساعد الذكي الذي تستخدمه.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/openshift/rosa.