Skip to content
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

Merged
merged 7 commits into from Sep 9, 2020
Merged

Add doc for quickstart #738

merged 7 commits into from Sep 9, 2020

Conversation

nakabonne
Copy link
Member

@nakabonne nakabonne commented Sep 4, 2020

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?:

NONE

@pipecd-bot
Copy link
Collaborator

COVERAGE

Code coverage for golang is 21.41%. This pull request does not change code coverage.

--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
Copy link
Member

@nghialv nghialv Sep 4, 2020

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.

Copy link
Member Author

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
Copy link
Member

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"

syncInterval: 1m
repositories:
- repoId: examples
remote: git@github.com:pipe-cd/examples.git
remote: git@github.com:YOUR_USERNAME/examples.git
Copy link
Member

@nghialv nghialv Sep 4, 2020

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.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

clone -> fork

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I see.

@pipecd-bot pipecd-bot added size/M and removed size/L labels Sep 4, 2020
@pipecd-bot
Copy link
Collaborator

COVERAGE

Code coverage for golang is 21.41%. This pull request does not change code coverage.

@nakabonne
Copy link
Member Author

/hold

@pipecd-bot
Copy link
Collaborator

COVERAGE

Code coverage for golang is 20.96%. This pull request does not change code coverage.

@pipecd-bot
Copy link
Collaborator

COVERAGE

Code coverage for golang is 20.96%. This pull request does not change code coverage.

@nakabonne
Copy link
Member Author

/hold cancel

@pipecd-bot
Copy link
Collaborator

COVERAGE

Code coverage for golang is 20.96%. This pull request does not change code coverage.

@pipecd-bot
Copy link
Collaborator

COVERAGE

Code coverage for golang is 20.96%. This pull request does not change code coverage.

@pipecd-bot
Copy link
Collaborator

COVERAGE

Code coverage for golang is 20.96%. This pull request does not change code coverage.

@nghialv
Copy link
Member

nghialv commented Sep 8, 2020

Btw, could you update the screenshots?
(Because we have just added the logo. lol)

@nakabonne
Copy link
Member Author

Fixed!

@pipecd-bot
Copy link
Collaborator

COVERAGE

Code coverage for golang is 20.96%. This pull request does not change code coverage.



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`
Copy link
Member

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.

Copy link
Member

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.

Copy link
Member Author

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?

Copy link
Member Author

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.

Copy link
Member

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. 👍

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I get it. Thanks

@nghialv
Copy link
Member

nghialv commented Sep 9, 2020

Nice. Just left one comment.

@nghialv
Copy link
Member

nghialv commented Sep 9, 2020

Nice. Thank you.
/approve

@pipecd-bot
Copy link
Collaborator

APPROVE

This pull request is APPROVED by nghialv.

Approvers can cancel the approval by writing /approve cancel in a comment. Any additional commits also will change this pull request to be not-approved.

@pipecd-bot pipecd-bot merged commit f2d888a into master Sep 9, 2020
@pipecd-bot pipecd-bot deleted the quickstart branch September 9, 2020 01:52
@pipecd-bot
Copy link
Collaborator

TEMPLATE

failed to handle template rule examples

Details
Error: unabled to push rendered files to destination

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants