Welcome to my website. I am always posting links to photo albums, art, technology and other creations. Everything that you will see on my numerous personal sites is powered by the formVistaTM Website Management Engine.

icon.linkedin.jpgicon.twitter.jpg

  • Subscribe to this RSS Feed
  • Connecting To a Test Kitchen Instance Via SFTP, SSH, or SCP
    06/23/2015 5:25PM

    If you are using Chef and Test Kitchen to test your cookbooks you may have need to connect to the Test Kitchen VM in some other fashion other than $ kitchen login instance-name.

    To do so:

    Do a $ kitchen list to see the running vms

    $ kitchen list
    Instance                      Driver   Provisioner  Verifier  Transport  Last Action
    default-centos-66             Vagrant  ChefSolo     Busser    Ssh        Converged

    Then look in the .kitchen directory from where you ran your $ kitchen command and look for the corresponding .yml config file for the vm

    $ ls .kitchen
    default-centos-66.yml  kitchen-vagrant  logs

    Inside the .yml file for the vm is the path to the ssh key

    $ more .kitchen/default-centos-66.yml
    ---
    hostname: 127.0.0.1
    port: '2222'
    username: vagrant
    ssh_key: "/home/rchapin/.vagrant.d/insecure_private_key"
    last_action: converge

    With that, just use the -i argument to point to the identity file and sftp to the box

    sftp -P 2222 -i /home/rchapin/.vagrant.d/insecure_private_key vagrant@127.0.0.1

    If the VM prompts you for a user name when logging in, you can always login via kitchen, change the password for that user and then retry

    To login via kitchen issue the following command:

    kitchen login default-centos-66

  • Setting the Compiler Version for Maven from the Command Line
    06/18/2015 10:42AM

    By default maven sets the compiler version for you.  Of course, you can always set it in the pom, but there are cases where you cannot modify the pom, and/or you might want to test compilation and tests with different versions of java.

    Following are the specific arguments to pass the compiler version to maven from the command line:

    $ mvn clean install -Dmaven.compiler.source=1.7 -Dmaven.compiler.target=1.7

  • An Excellent Article on finalize in Java
    06/08/2015 3:40PM

    From Joshua Bloch's Effective Java, 2nd Edition.

    A good read for any Java programmer.
  • Writing a BASH Script to Read from STDIN to a Variable
    05/15/2015 1:33PM

    Let's say you have some program that is generating output to STDOUT and you want to write a script to read that output from STDIN and use it as a variable in your script.

    To do so:

    #!/bin/bash

    SOME_VAR=$(cat)

    echo "SOME_VAR = $SOME_VAR" 

  • How To Distributed Artifacts in the Maven Central Repository
    04/02/2015 1:27PM

    I have just finished releasing my first project to Maven Central Repository and wanted to capture my notes for the setup of the project and all of the steps required.

    Publishing Artifacts to Maven Central:

    - -------------------------------------
    - Links:

    http://central.sonatype.org/pages/requirements.html
    http://maven.apache.org/guides/mini/guide-central-repository-upload.html
    http://ruleoftech.com/2014/distribute-projects-artifacts-in-maven-central-with-ossrh

    - -------------------------------------
    - Create account on OSSRH: You will need an account to the sonatype JIRA for OSSRH.  From there, you can request the creation of a new project.

       . See http://central.sonatype.org/pages/ossrh-guide.html for details


    - -------------------------------------
    - Setup of the Project/pom and Pre-requisites:

    1.  PGP keys
    http://central.sonatype.org/pages/working-with-pgp-signatures.html

       . Create a set of PGP keys
    $ gpg2 --gen-key

       . List the keys:
    $ gpg2 --list-keys
    /usr/local2/home/rchapin/.gnupg/pubring.gpg
    -------------------------------------------
    pub   4096R/E5170CE8 2015-03-26 [expires: 2016-03-25]
    uid                  Ryan Chapin <rchapin@nbinteractive.com>
    sub   4096R/8DAF9AD6 2015-03-26 [expires: 2016-03-25]

          . The id for the key created is 'E5170CE8'

       . Distribute the public key:
    $ gpg2 --keyserver hkp://pool.sks-keyservers.net --send-keys E5170CE8


    2. Pom additions:
       . License: Add the <license> tag to your pom.

       . Some links regarding available licenses and an example of it's use in the pom.
          . http://choosealicense.com/licenses/
          . http://mojo.codehaus.org/license-maven-plugin/examples/example-license-list.html

       . I ended up using the BSD 3 License, and used the following in the pom:

    <project>
      ...
      <licenses>
        <license>
          <name>The BSD 3-Clause License</name>
          <url>http://opensource.org/licenses/BSD-3-Clause</url>
          <distribution>repo</distribution>
        </license>
      </licenses>
      ...
    </project>


       . Developer:

    <project>
      ...
      <developers>
        <developer>
          <id>rchapin</id>
          <name>Ryan Chapin</name>
          <email>rchapin@nbinteractive.com</email>
          <url>http://www.ryanchapin.com</url>
          <roles>
            <role>architect</role>
            <role>developer</role>
          </roles>
          <timezone>America/New_York</timezone>
          <properties>
            <picUrl>http://www.gravatar.com/516f2158d74d134faa9649e9180ef782</picUrl>
          </properties>
        </developer>
      </developers>
      ...
    </project>


       . Scm:
    <project>
      ...
      <scm>
        <connection>scm:git:git@github.com:rchapin/hash-generator.git</connection>
        <developerConnection>scm:git:git@github.com:rchapin/hash-generator.git</developerConnection>
        <url>git@github.com:rchapin/hash-generator.git</url>
        <tag>HEAD</tag>
      </scm>
      ...
    </project>


       . Distribution Management and Authentication:  Configure the pom to enable maven to deploy to OSSRH Nexus server with the Nexus Staging Maven plugin.  See below for the release profile configuration which will contain the configs for the nexus-staging-maven-plugin.

    <project>
      ...
      <distributionManagement>
        <snapshotRepository>
        <id>ossrh</id>
        <url>https://oss.sonatype.org/content/repositories/snapshots</url>
        </snapshotRepository>
      </distributionManagement>
      ...
    </project>


       . Create a profile to encapsulate the creation of the javadoc and source jar as well as the pgp signing f the artifacts.  In my case, I set the profile to <activeByDefault>true</activeByDefault> true to ease release builds and simply invoke a build as such during development of the project to turn off the release profile:
    $ mvn package -P\!release

          . Additionally, the nexus-staging-maven-plugin is configured <autoReleaseAfterClose>false</autoReleaseAfterClose> to enable manual inspection of the staging repository BEFORE it is released to central.  To deploy to OSSRH and release to the Central Repository in one step, set autoReleaseAfterClose:true.

      <profiles>
        <profile>
          <id>release</id>
          <activation>
            <activeByDefault>true</activeByDefault>
          </activation>
          <build>
            <plugins>

              <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-javadoc-plugin</artifactId>
                <version>${maven.javadoc.plugin.version}</version>
                <executions>
                  <execution>
                    <id>attach-javadocs</id>
                    <goals>
                      <goal>jar</goal>
                    </goals>
                  </execution>
                </executions>
              </plugin>

              <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-source-plugin</artifactId>
                <version>${maven.source.plugin.version}</version>
                <executions>
                  <execution>
                    <id>attach-sources</id>
                    <goals>
                      <goal>jar</goal>
                    </goals>
                  </execution>
                </executions>
              </plugin>

              <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-gpg-plugin</artifactId>
                <version>1.6</version>
                <executions>
                  <execution>
                  <id>sign-artifacts</id>
                  <phase>verify</phase>
                  <goals>
                    <goal>sign</goal>
                  </goals>
                  </execution>
                </executions>
              </plugin>

              <plugin>
                <groupId>org.sonatype.plugins</groupId>
                <artifactId>nexus-staging-maven-plugin</artifactId>
                <version>1.6.5</version>
                <extensions>true</extensions>
                <configuration>
                  <serverId>ossrh</serverId>
                  <nexusUrl>https://oss.sonatype.org/</nexusUrl>
                  <autoReleaseAfterClose>false</autoReleaseAfterClose>
                </configuration>
              </plugin>

            </plugins>
          </build>
        </profile>

      </profiles>


       . Add the maven-release-plugin to the <build> section.  This should include disabling the 'release' profile that we added/describe above, and then specify the deploy goal together with the activation of the 'release' profile for the deploy goal.

    <project>
      ...
      <build>
        ...
        <plugins>
          ...
          <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-release-plugin</artifactId>
            <version>2.5.1</version>
            <configuration>
              <autoVersionSubmodules>true</autoVersionSubmodules>
              <useReleaseProfile>false</useReleaseProfile>
              <releaseProfiles>release</releaseProfiles>
              <goals>deploy</goals>
            </configuration>
          </plugin>
          ...
        </plugins>
        ...
      </build>
      ...
    </project>

    3.  Adding credentials to the settings.xml:  Credentials for both the distributionManagement and the pgp signing need to be added to the ~/.m2/settings.xml.

       . OSSRH login:

    <setting>
      ...
      <servers>
        <server>
          <id>ossrh</id>
          <username>your-uid</username>
          <password>your-passwd</password>
        </server>
      </servers>
      ...
    </settings>

       . PGP Signing Passphrase:

    <setting>
      ...
      <profiles>
        <profile>
          <id>ossrh</id>
          <activation>
            <activeByDefault>true</activeByDefault>
          </activation>
          <properties>
            <gpg.executable>gpg2</gpg.executable>
            <gpg.passphrase>your-passphrase</gpg.passphrase>
          </properties>
        </profile>
      </profiles>
      ...
    </settings>

    - -------------------------------------
    - Performing a SNAPSHOT deployment:

    1. As long as your current pom version still ends in 'SNAPSHOT' you can deploy a snapshot version to the OSSRH:
    $ mvn clean deploy

       . To use the SNAPSHOT version in a project, users will need to add the snapshot repo to their Nexus, settings.xml or pom.xml. 

    <project>
      ...
      <repositories>
        <repository>
          <id>ossrh-snapshots</id>
          <url>https://oss.sonatype.org/content/repositories/snapshots/</url>
        </repository>
      </repositories>
      ...
    </project>

    - -------------------------------------
    - Release and Deployment:

    1. Push all code to master:  First make sure that all of the code is pushed to the remote repo and that everything is merged into master.  Then make sure that you are ON the master branch on the local machine.


    2. Prepare Release:
       . To do a dry run and insure that pom will be bumped as expected and to check that everything is in order.  Will also NOT checkin or tag anyting in the scm repository
    $ mvn release:prepare -DdryRun=true

       . Check the output and then do the following before running the actual prepare command
    $ mvn release:clean

       . Execute the release:prepare
    $ mvn release:prepare

       . If errors occur:
    $ mvn release:prepare -Dresume=false

       . Alternatively, you can use:
    $ mvn release:clean release:prepare

       . See http://maven.apache.org/maven-release/maven-release-plugin/examples/prepare-release.html for details.

       . Once the release has been performed the scm repository should be updated with the new tag and the pom should be bumped to the next version for the next iteration of development.


    3. Perform Release:  Once the release has been prepared and a tag created and the scm repository has been update, you can deploy to OSSRH:

       . This will deploy to a staging repository.
    $ mvn release:perform


    4. Inspecting Staging Repo and Releasing to Central:
       . Login to OSSRH via https://oss.sonatype.org/.  Uid and passwd are the same for issues.sonatype.org
       . See http://central.sonatype.org/pages/releasing-the-deployment.html for details


    5. Releasing to Central: Once you have inspected the staging repo and are ready to release the deployment to Central do the following:

    $ cd target/checkout
    $ mvn nexus-staging:release


    6. If this is your first release to central, don't forget to go back to your project creation request ticket and add a comment that you have promoted your first release so that your promotion can be verified and your artifacts synced with Central.  This step only needs to be done the first time you promote to central with a new OSSRH project.

Advanced Search

Categories

Archives