reading the mini guide
 https://maven.apache.org/guides/mini/guide-creating-archetypes.html
I see that it mixes the archetype = the jar that is stored to the repository 
and the archetype project = the Maven project that will create the archetype jar

please look at the schema in the plugin page:
https://maven.apache.org/archetype/maven-archetype-plugin/
It shows the full lifecycle:
- from an eventual sample project
- to an archetype project
- to the built archetype
- an finally to the project generated from the archetype
and it lists the goals of the maven-artifact-plugin to go from one step to the 
next one

The mini guide only covers writing the archetype project by hand, and building 
it to get the archetype jar

I hope this will help understanding the wider logic, before digging into 
eventual bugs or not clear messages when something gets wrong

Regards,

Hervé

On 2023/10/05 23:15:50 Herve Boutemy wrote:
> documentation probably also needs love:
> you found the mini-guide, but not the plugin reference documentation that 
> explains much more: 
> https://maven.apache.org/archetype/maven-archetype-plugin/index.html
> 
> I'm not sure mini guide was updated as it should
> 
> Regards,
> 
> Hervé
> 
> On 2023/10/05 20:38:20 David Karr wrote:
> > I support and maintain a platform used by a couple hundred
> > SpringBoot/JAX-RS/Maven/K8S services.  When new services are created, a
> > Maven archetype is used to create the service skeleton.  This has worked
> > fine for quite a while.
> > 
> > We're now working on a variation using SpringMVC instead of JAX-RS, and
> > eventually making that the default.
> > 
> > One of my team members took the existing Jersey/JAX-RS archetype project,
> > made a copy, and then changed a bunch of things for SpringMVC instead of
> > JAX-RS.  We installed that archetype in our local maven repo for initial
> > testing, using "mvn install".
> > 
> > We run a command line like the following:
> > 
> >     mvn archetype:generate -DgroupId=com.org.idp -DartifactId=MyApplication
> > -Dpackage=com.org.idp -DarchetypeGroupId=com.org.idse
> > -DarchetypeArtifactId=idse-springmvc-archetype
> > -DarchetypeVersion=2.0.0-SNAPSHOT
> > 
> > The "archetypeVersion" property value corresponds to the version attribute
> > in the pom.xml of the archetype.
> > 
> > This produces the following output:
> > --------------------
> >  [INFO] Generating project in Batch mode
> > [WARNING] Archetype not found in any catalog. Falling back to central
> > repository.
> > [WARNING] Add a repository with id 'archetype' in your settings.xml if
> > archetype's repository is elsewhere.
> > Downloading from nexus:
> > https://repocentral.it.att.com:8443/nexus/content/groups/att-public-group/com/att/idse/idse-springmvc-archetype/2.0.0-SNAPSHOT/maven-metadata.xml
> > [INFO]
> > ------------------------------------------------------------------------
> > [INFO] BUILD FAILURE
> > [INFO]
> > ------------------------------------------------------------------------
> > [INFO] Total time:  52.232 s
> > [INFO] Finished at: 2023-10-04T13:33:46-07:00
> > [INFO]
> > ------------------------------------------------------------------------
> > [ERROR] Failed to execute goal
> > org.apache.maven.plugins:maven-archetype-plugin:3.2.1:generate
> > (default-cli) on project standalone-pom: The defined artifact is not an
> > archetype -> [Help 1]
> > [ERROR]
> > [ERROR] To see the full stack trace of the errors, re-run Maven with the -e
> > switch.
> > [ERROR] Re-run Maven using the -X switch to enable full debug logging.
> > [ERROR]
> > [ERROR] For more information about the errors and possible solutions,
> > please read the following articles:
> > [ERROR] [Help 1]
> > http://cwiki.apache.org/confluence/display/MAVEN/MojoFailureException
> > --------------------
> > 
> > This doesn't tell me WHY it thinks this is not an archetype.
> > 
> > I find some confusing docs about creating and installing archetypes.
> > 
> > I found this page:
> > https://maven.apache.org/guides/mini/guide-creating-archetypes.html .
> > This example is curious, as the pom.xml for the archetype references the
> > "archetype-packaging" extension, but the text says nothing about this. In
> > fact, it clearly says "All you need to specify is a groupId, artifactId and
> > version". Neither our working archetype or the new one references that
> > extension.
> > 
> > I also found this issue: https://issues.apache.org/jira/browse/ARCHETYPE-529
> > . No one ever responded to this, so perhaps the reporter is way off. I see
> > that this mentions the "create-from-project" goal. This is not mentioned in
> > the previous doc page.
> > 
> > What else can I look at to debug this problem?
> > 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscr...@maven.apache.org
> For additional commands, e-mail: users-h...@maven.apache.org
> 
> 

---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscr...@maven.apache.org
For additional commands, e-mail: users-h...@maven.apache.org

Reply via email to