docs(samples): Refactoring product package (Import) (new)

[dfirova]

Thank you for opening a Pull Request! Before submitting your PR, there are a few things you can do to make sure it goes smoothly:

• Make sure to open an issue as a bug/issue before writing your code! That way we can discuss the change, evaluate designs, and agree on the general idea
• Ensure the tests and linter pass
• Code coverage does not decrease (if any source code was changed)
• Appropriate docs were updated (if necessary)

Fixes #<issue_number_goes_here> ☕️

If you write sample code, please follow the samples format.

[google-cla]

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

[dfirova]

@alicejli , I don't have permission to see the details of owlbot failed run, would appreciate the details on this issue.

[alicejli]

Looks like some permissions issue on some changes owlbot was trying to run:

Step #8: Status: Downloaded newer image for gcr.io/cloud-devrel-public-resources/owlbot-cli:latest
Step #8: gcr.io/cloud-devrel-public-resources/owlbot-cli:latest
Step #8: git add -A .
Step #8: git status . --porcelain
Step #8: Retrieving PR info for googleapis/java-retail
Step #8: Retrieved PR info for googleapis/java-retail
Step #8: git log -1 --format=%B
Step #8: git commit -m "🦉 Updates from OwlBot post-processor
Step #8: 
Step #8: See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md"
Step #8: git pull --no-verify
Step #8: git push --no-verify
Step #8: To https://github.com/dfirova/java-retail.git
Step #8:  ! [remote rejected] refactoring-products-import -> refactoring-products-import (permission denied)
Step #8: error: failed to push some refs to 'https://github.com/dfirova/java-retail.git'
Step #8: owl-bot.js commit-post-processor-update
Step #8: 
Step #8: Runs either `git commit -m "Updates from OwlBot"` or `git commit --amend
Step #8: --no-edit`
Step #8: depending on the squash flag in .OwlBot.yaml.
Step #8: 
Step #8: Run this command in the root directory of a client library repository after
Step #8: running the post processor.
Step #8: 
Step #8: Options:
Step #8:   --help          Show help                                            [boolean]
Step #8:   --version       Show version number                                  [boolean]
Step #8:   --dest-repo     The PR's destination repo (e.g., googleapis/foo)
Step #8:                                                              [string] [required]
Step #8:   --pr            The pull request number                    [number] [required]
Step #8:   --github-token  Short-lived GitHub token.                  [string] [required]
Step #8:   --repo-path     Local path to the repository
Step #8:                                     [string] [default: "/workspace/java-retail"]
Step #8: 
Step #8: Error: Command failed: git push --no-verify
Step #8: To https://github.com/dfirova/java-retail.git
Step #8:  ! [remote rejected] refactoring-products-import -> refactoring-products-import (permission denied)
Step #8: error: failed to push some refs to 'https://github.com/dfirova/java-retail.git'
Step #8: 
Step #8:     at checkExecSyncError (child_process.js:790:11)
Step #8:     at Object.execSync (child_process.js:863:15)
Step #8:     at cmd (/usr/src/app/build/src/cmd.js:44:29)
Step #8:     at commitPostProcessorUpdate (/usr/src/app/build/src/bin/commands/commit-post-processor-update.js:146:5)
Step #8:     at processTicksAndRejections (internal/process/task_queues.js:95:5) {
Step #8:   status: 1,
Step #8:   signal: null,
Step #8:   output: [
Step #8:     null,
Step #8:     <Buffer >,
Step #8:     <Buffer 54 6f 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 64 66 69 72 6f 76 61 2f 6a 61 76 61 2d 72 65 74 61 69 6c 2e 67 69 74 0a 20 21 20 5b ... 176 more bytes>
Step #8:   ],
Step #8:   pid: 43,
Step #8:   stdout: <Buffer >,
Step #8:   stderr: <Buffer 54 6f 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 64 66 69 72 6f 76 61 2f 6a 61 76 61 2d 72 65 74 61 69 6c 2e 67 69 74 0a 20 21 20 5b ... 176 more bytes>
Step #8: }
Finished Step #8

I think this happens when an update to a PR is made after an OwlBot post processor is already running. Try doing a git pull and see if there's any changes that need to be rebased before doing a git push to retrigger.

[dfirova]

@yoshi-kokoro please trigger Kokoro checks.

[dfirova]

@chenlei1216 , the tests haven't been triggered in over a week, kindly ask to trigger them

[chenlei1216]

@chenlei1216 , the tests haven't been triggered in over a week, kindly ask to trigger them

Triggerred.