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
Add doc for quickstart #738
Conversation
--set-file secret.minioAccessKey.data=./quickstart/credentials/minio-access-key | ||
--set-file secret.minioSecretKey.data=./quickstart/credentials/minio-secret-key | ||
git clone https://github.com/pipe-cd/pipe.git | ||
cd pipe |
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.
Instead of cloning pipe
repository, we can clone the manifest repository and install the chart inside that repository.
helm install pipecd manifests/pipecd --values ./quickstart/values.yaml
The values file for quickstart is also copied to that repository too.
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.
The quickstart/ directory is also copied! Ok I'll do so.
|
||
### 3. Registering and installing a `piped` | ||
### 3. Accessing the API server |
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.
I think "the PipeCD web" is better than "API server"
quickstart/piped-config.yaml
Outdated
syncInterval: 1m | ||
repositories: | ||
- repoId: examples | ||
remote: git@github.com:pipe-cd/examples.git | ||
remote: git@github.com:YOUR_USERNAME/examples.git |
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.
So let's tell the users to fork the example repository. That note can be added to the "Prerequisites" part.
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.
For that, added instruction to fork the repo: https://github.com/pipe-cd/pipe/pull/738/files#diff-d2444df65bafce568307b6f02d03d45dR77
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.
clone -> fork
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.
I see.
/hold |
1bb7038
to
31f308d
Compare
31f308d
to
08386d7
Compare
08386d7
to
9964495
Compare
/hold cancel |
Btw, could you update the screenshots? |
Fixed! |
|
||
|
||
Open [`./quickstart/values-piped.yaml`](https://github.com/pipe-cd/manifests/blob/master/quickstart/values-piped.yaml) with your editor and: | ||
- replace `FORKED_REPO_URL` with forked repository of [Examples](https://github.com/pipe-cd/examples), such as `https://github.com/foo/examples.git` |
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.
We are using SSH to clone the repository so this should be git@github.com:YOUR_ORG/examples.git
.
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.
This message was not forwarded to slack. lol.
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.
In that case, users have to prepare them ssh-key and give it piped. For quickstart, I'd say clone with https scheme is enough, but what do you think?
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.
https://github.com/YOUR_ORG/examples.git
looks good.
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.
Got it. The forked repo is a public one so we don't need to enter the username and password while cloning by https.
Ok. Let's update to https://github.com/YOUR_ORG/examples.git
and merge this PR. 👍
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.
I get it. Thanks
Nice. Just left one comment. |
Nice. Thank you. |
What this PR does / why we need it:
The complete doc for quickstart
Which issue(s) this PR fixes:
Fixes #
Does this PR introduce a user-facing change?: