-
Notifications
You must be signed in to change notification settings - Fork 6
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Update README.md #204
base: main
Are you sure you want to change the base?
Update README.md #204
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change | ||||
---|---|---|---|---|---|---|
@@ -1,5 +1,10 @@ | ||||||
# jenkins-k8s-operator | ||||||
|
||||||
[![CharmHub Badge](https://charmhub.io/jenkins-k8s/badge.svg)](https://charmhub.io/jenkins-k8s) | ||||||
[![Publish to edge](https://github.com/canonical/jenkins-k8s-operator/actions/workflows/publish_charm.yaml/badge.svg)](https://github.com/canonical/jenkins-k8s-operator/actions/workflows/publish_charm.yaml) | ||||||
[![Promote charm](https://github.com/canonical/jenkins-k8s-operator/actions/workflows/promote_charm.yaml/badge.svg)](https://github.com/canonical/jenkins-k8s-operator/actions/workflows/promote_charm.yaml) | ||||||
[![Discourse Status](https://img.shields.io/discourse/status?server=https%3A%2F%2Fdiscourse.charmhub.io&style=flat&label=CharmHub%20Discourse)](https://discourse.charmhub.io) | ||||||
|
||||||
A [Juju](https://juju.is/) [charm](https://juju.is/docs/olm/charmed-operators) | ||||||
deploying and managing [Jenkins](https://jenkins.io/) on Kubernetes. Jenkins is an open source | ||||||
automation server, providing plugins to support building, deploying and automating any project. | ||||||
|
@@ -15,30 +20,35 @@ For DevOps and SRE teams, this charm will make operating Jenkins simple and stra | |||||
through Juju's clean interface. Allowing both kubernetes and machine agent relations, it supports | ||||||
multiple environments for automation. | ||||||
|
||||||
For information about how to deploy, integrate, and manage this charm, see the Official [jenkins-k8s charm Documentation](https://charmhub.io/jenkins-k8s/docs). | ||||||
|
||||||
## Project and community | ||||||
## Get started | ||||||
|
||||||
To begin, refer to the [Getting Started](https://charmhub.io/jenkins-k8s/docs/tutorial-getting-started) tutorial for step-by-step instructions. | ||||||
|
||||||
### Basic operations | ||||||
|
||||||
#### Expose jenkins-k8s through ingress | ||||||
|
||||||
See the [Expose jenkins-k8s through ingress](https://charmhub.io/jenkins-k8s/docs/tutorial-getting-started#expose-jenkins-k8s-through-ingress) section in the jenkins-k8s-operator documentation. | ||||||
|
||||||
The Jenkins-k8s Operator is a member of the Ubuntu family. It's an open source | ||||||
project that warmly welcomes community projects, contributions, suggestions, | ||||||
fixes and constructive feedback. | ||||||
* [Code of conduct](https://ubuntu.com/community/code-of-conduct) | ||||||
* [Get support](https://discourse.charmhub.io/) | ||||||
* [Join our online chat](https://chat.charmhub.io/charmhub/channels/charm-dev) | ||||||
* [Contribute](https://charmhub.io/jenkins-k8s/docs/contributing) | ||||||
* [Getting Started](https://charmhub.io/jenkins-k8s/docs/tutorial-getting-started) | ||||||
Thinking about using the Jenkins-k8s Operator for your next project? | ||||||
[Get in touch](https://chat.charmhub.io/charmhub/channels/charm-dev)! | ||||||
#### Integrate with the jenkins-agent and the jenkins-agent-k8s charm | ||||||
|
||||||
--- | ||||||
See the [deploy and integrate k8s agents](https://charmhub.io/jenkins-k8s/docs/tutorial-getting-started#deploy-and-integrate-k8s-agents) section and the [deploy and integrate machine agents](https://charmhub.io/jenkins-k8s/docs/tutorial-getting-started#deploy-and-integrate-machine-agents-optional) section in the jenkins-k8s-operator documentation. | ||||||
|
||||||
For further details, | ||||||
[see the charm's detailed documentation](https://charmhub.io/jenkins-k8s/docs). | ||||||
#### Use agent-discovery-ingress integration to integrate with "external" agents | ||||||
|
||||||
See the [how-to-integrate-with-external-agents](https://charmhub.io/jenkins-k8s/docs/how-to-integrate-with-external-agents) section in the jenkins-k8s-operator documentation. | ||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
|
||||||
## Learn more | ||||||
|
||||||
- [Read more](https://charmhub.io/jenkins-k8s/docs) | ||||||
|
||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
|
||||||
## Project and community | ||||||
|
||||||
## Generating src docs for every commit | ||||||
The Jenkins-agent-k8s Operator is a member of the Ubuntu family. It's an open source project that warmly welcomes community projects, contributions, suggestions, fixes and constructive feedback. | ||||||
|
||||||
Run the following command: | ||||||
* [Issues](https://github.com/canonical/jenkins-k8s-operator/issues) <!--Link to GitHub issues (if applicable)--> | ||||||
* [Contributing](https://charmhub.io/jenkins-k8s#contributing-to-this-documentation) <!--Link to any contribution guides--> | ||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Could you link https://github.com/canonical/jenkins-k8s-operator/blob/main/CONTRIBUTING.md instead? |
||||||
- [Matrix](https://matrix.to/#/#charmhub-charmdev:ubuntu.com) | ||||||
|
||||||
```bash | ||||||
echo -e "tox -e src-docs\ngit add src-docs\n" > .git/hooks/pre-commit | ||||||
chmod +x .git/hooks/pre-commit | ||||||
``` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.