Nothing Goes From Idea To Container Faster

Frequently Asked Questions (FAQ)

Installation

  1. How do I connect my CLI NodeJS installation to a realMethods Host Platform?
  2. In order to connect the CLI to a realMethods Host Platform instance, two things are required:

    (1) User token and
    (2) The URL to the host

    Using your web browser to launch the realMethods Web App client, you must have created an account via Registration. Once registration is complete, you will be presented with a token. This token is a series of unique characters you should keep in a safe place. Use this token during initialization of the CLI.

  3. The CLI says I need a user token. Where to do I get one?
  4. Once registration is successfully completed, a unique user token will be assigned and presented to you. You will need this token if using the Command Line Interface verion. This token can later be read from the User Input page.

  5. How do I access the realMethods platform running inside the Community Edition Docker image?
  6. realMethods CE runs inside a Docker container. To access it, issue the following command:

    docker ps : to display the container name which realMethods is running
    docker exec -it __your_container_name__ /bin/bash : Review Docker exec docs 
    cd /usr/local/tomcat/webapps/ROOT : change directory to root dir of the realMethods webapp running on Tomcat 9

  7. What components are installed and used in the Community Edition Docker image
  8. How do I install the Enterprise Edition?
  9. Contact realMethods Support.

Models

  1. How do I get realMethods to deduce an object model from a JAR file containing certain Java objects?
  2. From either the CLI or Web interface, you can provide a JAR file to use as input for the model portion of generating a project. In both cases, you will need to provide the root Java package name of the classes that comprise what you could consider to be the collection of Beans or Plain Old Java Objects. This will allow realMethods to parse the JAR file using the package name to determine which files to consider or ignore.

  3. What is the best way to use a SQL script file as a model?
  4. Read all about this here

  5. Are there any issues using a compound primary key instead of a simple primary key?
  6. Read all about this here


Tech Stack Package

  1. Are Tech Stack Packages open source?
  2. Yes. All realMethods supported Tech Stack Packages are located here.

  3. I have an idea for a Tech Stack Package. Is there a way to work with realMethods to create one?
  4. Absolutely!! There are massive # of great technology combinations and there is no way we could ever capture them all. realMethods has been designed as an open tech-stack-agnostic project generation platform. This means the tech stack definitions are separate from the platform itself. As long as a tech stack is packaged according to our well defined methodology, it can be easily made part of our Teck Stack Package ecosystem. In fact, this is how we have developed every available Tech Stack Package.

    Receive a Free Enterprise license
    If you create a Tech Stack Package and are willing to allow us to validate and share it with our DevOps community, your company will receive a free Enterprise license, which includes source code and early access to point releases and features.

    Contact support to learn more.

  5. How can I make modifications to an existing Tech Stack Package?
  6. Modifications to an existing Tech Stack Package are only available through the CLI.

    Follow These Steps:
    1. Download the Tech Stack Package
    2. A tech stack package can be either downloaded from the realMethods public Git Repo or it can be downloaded via the CLI:

      realmethods_cli stack_download _stack_identifier_ _output_package_file_path_ 

    3. Make modifications
      • Edit the package descriptor
      • Locate file techstackpackage.xml in the root of the package to minimally change the name and shortName fields to unique values.

      • Rename the package
      • Again, for the purpose of uniqueness among already published packages.

      • Update the README.md
      • Be sure to reference that this package is derived from another package and include the differences.

      • Change any of the contents!!
      • The purpose of a Tech Stack Package is to serve as a collection of reusable assets that are captured in a series of template files. Each template file name and/or contents produce output predicated on the model applied.

        Review the common templates
        Each realMethods Tech Stack Package refers to a set of common macros and template files found in the common templates package. This package is not itself a Tech Stack Package, but you may want to access it since any package you edit will likely reference components within it.

    4. Validate
    5. realmethods_cli stack_validate __package_file_path__
    6. Publish
    7. Publishing makes the Tech Stack Package available for use during project generation. Publishing causes validation first.
      realmethods_cli stack_publish __tech_stack_package_yaml_file__ [scope]
      Scope: public or private [default].
      Note: Click here for an example of Tech Stack Package YAML input file.
  7. What is in a Tech Stack Package?
  8. The purpose and components of what realMethods calls a Tech Stack Package is found here.

Resource Management

  1. What is a resource?
  2. A resource is a single file that can be applied to a project generation session. For example, if you have a Dockerfile you prefer to use instead of what is generaed by default, you can publish the resource via the CLI using:

    realmethods_cli resource_publsh ./myfiles/Dockerfile myDockerFile DOCKERFILE private
  3. Can more than one resource be applied to a project generation YAML?
  4. Yes. You can list multiple resource refereneces by separating them with either a space or comma.

    useResources:  myDockerfile, myCirciCIConfigyYAML
    This assumes resources by the referenced names have already been published.

  5. Are resources able to be shared?
  6. Yes. A resource can be published and made public, indicating others can reference the resource within the Project-as-Code YAML file. Care should be taken when both using and sharing a public resource.

Project Generation

  1. Is it project, application, or code generation
  2. realMethods feels it is important to distinguish between generating a project, an application and code.

    Code generation encompasses any tool which creates any amount of code. This could be a simple as 'Hello World'. The code itself may not execute or be of entire use on it's own.

    Application generation includes code generation. It encompasses the generation of enough assets so the final output is minimally considered an initial version. This initial version is often seen as enough to commit to a Git repository. The application itself is not necessarily buildable, testable, or deployable.

    Project generation includes application generation. It encompasses the generation of every component required of a project to build, test, package, archive, and deploy the resulting application.

  3. For security reasons, can I generate an application without publishing my model?
  4. Yes. If you are using the Community or Enterprise Editions of realMethods, all activities with your host are secure and confined to that instance. If you prefer not to publish a model for reuse later during a generation session, you can provide the

CI Platform

  1. Which CI platforms are supported?
  2. A list of supported CI platforms is found here.

  3. Do all Tech Stack Packages output YAML for each supported CI Platform?
  4. The short answer is Yes with a but not all output includes every available feature.

    Some CI platforms do not (or did not) have support for Windows builds so the ASP.NET package must be built manually (instructions included).

    Terraform output is supported on both CircleCI and CloudBees with full support on all supported CI platforms underway

    Kubernetes output is supported on CloudBees with full support on all CI platform underway


Git Repo

  1. How do I use a private Git repository
  2. Private Git repo support is only available for the Enterprise edition.

  3. Can I use my own Git host?
  4. Yes. Simply provide it's root URL as the host parameter when specifying the Git parameters.


Common Issues

  1. Generated project code not found in Git repository
  2. Even though all project code and related files are appropriately generated, committing them to a Git repo may fail. Failure often takes place for the following reasons:

    1. The Git repo name is misspelled.
    2. The Git repo is not public. (Both Community and Enterprise Editions)
    3. The Git SSH is failing for private repo. (Both Enterprise Editions)
    4. Recheck the Git credentials and host name.
  3. Failure during initialization of the realMethods CLI
    1. Wrong realMethods Platform host URL.
    2. The realMethods Platform host is not running or accessible.
    3. Incorrect user token being supplied.

  4. CI platform pipeline not starting when project code is commited to the Git host's repository
  5. With any CI platform, it requires a connection be made to a Git repository. Once it detects a commit, the CI platform will attempt to read a specific YAML file. This YAML file contains directives on environment setup as well as how to build, test, package, and deploy the generated application. realMethods generates this YAML file for a variety of CI vendors.
Close Menu