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

Docs: Autogenerated code in examples doesn't work for 999-SNAPSHOT #37482

Closed
fedinskiy opened this issue Dec 4, 2023 · 3 comments · Fixed by quarkusio/quarkusio.github.io#1853
Labels
area/documentation kind/bug Something isn't working

Comments

@fedinskiy
Copy link
Contributor

Describe the bug

Multiple Quarkus guides[1][2][3] contain code examples for creation of application using maven-plugin. If we use them with version 999-SNAPSHOT, these code examples start with io.quarkus.platform:quarkus-maven-plugin:999-SNAPSHOT:create. The problems is, quarkus-maven-plugin uses io.quarkus.platform group only for released versions, and uses io.quarkus for 99-SNAPSHOT. Because of that, the code in examples fails with exception Could not find artifact io.quarkus.platform:quarkus-maven-plugin:jar:999-SNAPSHOT .

[1] https://quarkus.io/version/main/guides/security-oidc-code-flow-authentication-tutorial#create-the-maven-project
[2] https://quarkus.io/version/main/guides/telemetry-opentracing-to-otel-tutorial#generate-the-legacy-project
[3] https://quarkus.io/version/main/guides/getting-started-dev-services#bootstrapping-the-project

Expected behavior

Code from tutorials should not fail an, probably, should use io.quarkus:quarkus-maven-plugin:999-SNAPSHOT:create command

Actual behavior

The code fails

How to Reproduce?

  1. Open any of guides linked above, eg https://quarkus.io/version/main/guides/security-oidc-code-flow-authentication-tutorial#create-the-maven-project
  2. Copy generator code for maven:
mvn io.quarkus.platform:quarkus-maven-plugin:999-SNAPSHOT:create \
    -DprojectGroupId=org.acme \
    -DprojectArtifactId=security-openid-connect-web-authentication-quickstart \
    -Dextensions='resteasy-reactive,oidc' \
    -DnoCode
  1. Run the code, the generation fails
  2. Edit the platform part out:
mvn io.quarkus:quarkus-maven-plugin:999-SNAPSHOT:create \
-DprojectGroupId=org.acme \
-DprojectArtifactId=security-openid-connect-web-authentication-quickstart \
-Dextensions='resteasy-reactive,oidc' \
-DnoCode
  1. Run the code, the generation succeeds

Output of uname -a or ver

6.5.12-300.fc39.x86_64

Output of java -version

17.0.8, vendor: Eclipse Adoptium

Quarkus version or git rev

38ac518

Build tool (ie. output of mvnw --version or gradlew --version)

Apache Maven 3.8.7 (b89d5959fcde851dcb1c8946a785a163f14e1e29)

Additional information

No response

@fedinskiy
Copy link
Contributor Author

area/documentation

Copy link

quarkus-bot bot commented Dec 4, 2023

/cc @MichalMaler (documentation), @ebullient (documentation), @inoxx03 (documentation), @michelle-purcell (documentation), @rolfedh (documentation), @sheilamjones (documentation), @sunayna15 (documentation)

@gsmet
Copy link
Member

gsmet commented Dec 4, 2023

I will adjust it but keep in mind that the main documentation is for people who knows what they are doing.

In this case, you would either have to also install locally a working platform or use the io.quarkus groupId.

I will adjust to use the io.quarkus groupId: quarkusio/quarkusio.github.io#1853

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/documentation kind/bug Something isn't working
Projects
Development

Successfully merging a pull request may close this issue.

3 participants