various: set passwords in state at bootstrap time.

environs/interface.go

 package environs
 
 import (
         "errors"
         "io"
         "launchpad.net/juju-core/environs/config"
         "launchpad.net/juju-core/state"
 )
 
 // A EnvironProvider represents a computing and storage provider.
@@ skipping 106 matching lines @@
 // an operation succeeds, even if that success is not
 // consistent with a previous operation.
 //·
 type Environ interface {
         // Name returns the Environ's name.
         Name() string
 
         // Bootstrap initializes the state for the environment, possibly
         // starting one or more instances.  If uploadTools is true, the
         // current version of the juju tools will be uploaded and used
-        // on the environment's instances.
-        // If the configuration's AdminSecret is non-empty, the
-        // adminstrator password on the newly bootstrapped
-        // state will be set to a hash of it (see trivial.PasswordHash),
-        // and should be changed at the first opportunity.
+        // on the environment's instances.  If the configuration's
+        // AdminSecret is non-empty, the adminstrator password on the
+        // newly bootstrapped state will be set to a hash of it (see
+        // trivial.PasswordHash), When first connecting to the
+        // environment via the juju package, the password hash will be
+        // automatically replaced by the real password.
         Bootstrap(uploadTools bool) error
 
         // StateInfo returns information on the state initialized
         // by Bootstrap.
         StateInfo() (*state.Info, error)
 
         // Config returns the current configuration of this Environ.
         Config() *config.Config
 
         // SetConfig updates the Environs configuration.
@@ skipping 43 matching lines @@
         // When Destroy has been called, any Environ referring to the
         // same remote environment may become invalid
         Destroy(insts []Instance) error
 
         // AssignmentPolicy returns the environment's unit assignment policy.
         AssignmentPolicy() state.AssignmentPolicy
 
         // Provider returns the EnvironProvider that created this Environ.
         Provider() EnvironProvider
 }