<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 15157 -->
<!-- Reviewed: no -->
<sect1 id="zend.service.amazon.ec2.instance">
    <title>Zend_Service_Amazon_Ec2: Instanzen</title>

    <sect2 id="zend.service.amazon.ec2.instance.types">
        <title>Instanz Typen</title>

        <para>
            Amazon EC2 Instanzen werden in zwei Familien gruppiert: Standard und High-CPU. Standard
            Instanzen haben Speicher und CPU Ratio die für die meisten generell gedachten
            Anwendungen passen; High-CPU Instanzen haben proportional mehr CPI Ressourcen als
            Speicher (RAM) und sind gedacht für rechen-intensive Anwendungen. Wenn Instanz-Typen
            ausgewählt werden, kann es gewünscht sein wenig intensive Instanztypen für Web-Server
            Instanzen zu verwenden und intensivere Instanz-Typen für eigene Datenbank-Instanzen.
            Zusätzlich kann es gewünscht sein CPU Instanztypen für CPU-intensive Datenverarbeitungs
            Tasks zu verwenden.
        </para>
        <para>
            Eine der Vorteile von EC2 ist das man pro Stunde der Instanz zahlt, was es bequem und
            kostengünstig macht die Performance der eigenen Anwendung auf verschiedenen
            Instanzfamilien und Typen zu testen. Ein guter Weg um zu erkennen welches die
            passenste Instanzfamilie und der passenste Instanztyp ist, besteht darin Testinstanzen
            zu starten und die Anweundung zu benchmarken.
        </para>

        <note>
            <title>Instanz Typen</title>
            <para>
                Der Instanztyp ist als Konstante im Code definiert. Spalte acht in der Tabelle ist
                der definierte Name der Konstante
            </para>
        </note>
        <table id="zend.service.amazon.ec2.instance.types-table">
            <title>Vorhandene Instanztypen</title>
            <tgroup cols="8">
                <thead>
                    <row>
                        <entry>Typ</entry>
                        <entry>CPU</entry>
                        <entry>Hauptspeicher</entry>
                        <entry>Plattenspeicher</entry>
                        <entry>Plattform</entry>
                        <entry>I/O</entry>
                        <entry>Name</entry>
                        <entry>Name der Konstante</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry><code>Klein</code></entry>
                        <entry><para>
                            1 EC2 Recheneinheit (1 virtueller Kern mit 1 EC2 Recheneinheit)
                        </para></entry>
                        <entry><para>
                            1.7 GB
                        </para></entry>
                        <entry><para>
                            160 GB Speicher der Instanz (150 GB plus 10 GB Root Partition)
                        </para></entry>
                        <entry><para>
                            32-bit
                        </para></entry>
                        <entry><para>
                            Moderat
                        </para></entry>
                        <entry><para>
                            m1.small
                        </para></entry>
                        <entry><classname>Zend_Service_Amazon_Ec2_Instance::SMALL</classname></entry>
                    </row>
                    <row>
                        <entry><code>Groß</code></entry>
                        <entry><para>
                            4 EC2 Recheneinheiten (2 virtuelle Kerne mit jeweils 2 EC2
                            Recheneinheiten)
                        </para></entry>
                        <entry><para>
                            7.5 GB
                        </para></entry>
                        <entry><para>
                            850 GB Speicher der Instanz (2 x 420 GB plus 10 GB Root Partition)
                        </para></entry>
                        <entry><para>
                            64-bit
                        </para></entry>
                        <entry><para>
                            Hoch
                        </para></entry>
                        <entry><para>
                            m1.large
                        </para></entry>
                        <entry><classname>Zend_Service_Amazon_Ec2_Instance::LARGE</classname></entry>
                    </row>
                    <row>
                        <entry><code>Extra Groß</code></entry>
                        <entry><para>
                            8 EC2 Recheneinheiten (4 virtuelle Kerne mit jeweils 2 EC2
                            Recheneinheiten)
                        </para></entry>
                        <entry><para>
                            15 GB
                        </para></entry>
                        <entry><para>
                            1,690 GB Speicher der Instanz (4 x 420 GB plus 10 GB Root Partition)
                        </para></entry>
                        <entry><para>
                            64-bit
                        </para></entry>
                        <entry><para>
                            Hoch
                        </para></entry>
                        <entry><para>
                            m1.xlarge
                        </para></entry>
                        <entry><classname>Zend_Service_Amazon_Ec2_Instance::XLARGE</classname></entry>
                    </row>
                    <row>
                        <entry><code>High-CPU Medium</code></entry>
                        <entry><para>
                            5 EC2 Recheneinheiten (2 virtuelle Kerne mit jeweils 2.5 EC2
                            Recheneinheiten)
                        </para></entry>
                        <entry><para>
                            1.7 GB
                        </para></entry>
                        <entry><para>
                            350 GB Speicher der Instanz (340 GB plus 10 GB Root Partition)
                        </para></entry>
                        <entry><para>
                            32-bit
                        </para></entry>
                        <entry><para>
                            Durchschnittlich
                        </para></entry>
                        <entry><para>
                            c1.medium
                        </para></entry>
                        <entry><classname>Zend_Service_Amazon_Ec2_Instance::HCPU_MEDIUM</classname></entry>
                    </row>
                    <row>
                        <entry><code>High-CPU Extra Groß</code></entry>
                        <entry><para>
                            20 EC2 Recheneinheiten (8 virtuelle Kerne mit jeweils 2.5 EC2
                            Recheneinheiten)
                        </para></entry>
                        <entry><para>
                            7 GB
                        </para></entry>
                        <entry><para>
                            1,690 GB Speicher der Instanz (4 x 420 GB plus 10 GB Root Partition)
                        </para></entry>
                        <entry><para>
                            64-bit
                        </para></entry>
                        <entry><para>
                            Hoch
                        </para></entry>
                        <entry><para>
                            c1.xlarge
                        </para></entry>
                        <entry><classname>Zend_Service_Amazon_Ec2_Instance::HCPU_XLARGE</classname></entry>
                    </row>
                </tbody>
            </tgroup>
        </table>
    </sect2>

    <sect2 id="zend.service.amazon.ec2.instance.operations">
        <title>Ausführen von Amazon EC2 Instanzen</title>
        <para>
            Dieses Kapitel beschreibt die Methoden für die Behandlung von Amazon EC2 Instanzen.
        </para>

        <example id="zend.service.amazon.ec2.instance.operations.run">
            <title>Starten neuer EC2 Instanzen</title>
            <para>
                <code>run</code> startetn eine spezifische Anzahl von EC2 Instanzen.
                <code>run</code> nimmt für den Start ein Array von Parametern. Anbei ist eine
                Tabelle welche die gültigen Werte enthält.
            </para>
            <para>
            <table id="zend.service.amazon.ec2.instance.operations.run-table">
                <title>Gültige Optionen für das Starten</title>
                <tgroup cols="3">
                    <thead>
                        <row>
                            <entry>Name</entry>
                            <entry>Beschreibung</entry>
                            <entry>Benötigt</entry>
                        </row>
                    </thead>
                    <tbody>
                        <row>
                            <entry><code>imageId</code></entry>
                            <entry><para>
                                ID der AMI mit der Instanzen gestartet werden.
                            </para></entry>
                            <entry><para>Ja</para></entry>
                        </row>
                        <row>
                            <entry><code>minCount</code></entry>
                            <entry><para>
                                Minimale Anzahl der zu startenden Instanzen. Standardwert: 1
                            </para></entry>
                            <entry><para>Nein</para></entry>
                        </row>
                        <row>
                            <entry><code>maxCount</code></entry>
                            <entry><para>
                                Maximale Anzahl der zu startenden Instanzen. Standardwert: 1
                            </para></entry>
                            <entry><para>Nein</para></entry>
                        </row>
                        <row>
                            <entry><code>keyName</code></entry>
                            <entry><para>
                                Name des Schlüsselpaares mit dem Instanzen gestartet werden. Wenn
                                man keinen Schlüssel angibt, wird der Zugriff auf die Instanzen
                                nicht möglich sein.
                            </para></entry>
                            <entry><para>Nein</para></entry>
                        </row>
                        <row>
                            <entry><code>securityGroup</code></entry>
                            <entry><para>
                                Name der Sicherheitsgruppe mit der Instanzen zu assoziieren sind.
                            </para></entry>
                            <entry><para>Nein</para></entry>
                        </row>
                        <row>
                            <entry><code>userData</code></entry>
                            <entry><para>
                                Die Benutzerdaten welche bei den zu startenden Instanzen vorhanden
                                sind. Diese sollten nicht Base64 verschlüsselt sein.
                            </para></entry>
                            <entry><para>Nein</para></entry>
                        </row>
                        <row>
                            <entry><code>instanceType</code></entry>
                            <entry><para>
                                Spezifiziert den Instanztyp. Standardwert: m1.small
                            </para></entry>
                            <entry><para>Nein</para></entry>
                        </row>
                        <row>
                            <entry><code>placement</code></entry>
                            <entry><para>
                                Spezifiziert die Availability Zone in der Instanz(en) zu starten
                                sind. Standardmäßig wählt Amazon EC2 eine Availability Zone aus.
                            </para></entry>
                            <entry><para>Nein</para></entry>
                        </row>
                        <row>
                            <entry><code>kernelId</code></entry>
                            <entry><para>
                                Die ID des Kernels mit dem die Instanz gestartet werden soll.
                            </para></entry>
                            <entry><para>Nein</para></entry>
                        </row>
                        <row>
                            <entry><code>ramdiskId</code></entry>
                            <entry><para>
                                Die ID der RAM Dist mit der die Instanz gestartet werden soll.
                            </para></entry>
                            <entry><para>Nein</para></entry>
                        </row>
                        <row>
                            <entry><code>blockDeviceVirtualName</code></entry>
                            <entry><para>
                                Spezifiziert den virtuellen Name der zu dem korrespondierenden
                                Devicenamen gemappt werden soll. Zum Beispiel: instancestore0
                            </para></entry>
                            <entry><para>Nein</para></entry>
                        </row>
                        <row>
                            <entry><code>blockDeviceName</code></entry>
                            <entry><para>
                                Spezifiziert das Device zu dem der virtuelle Name gemappt werden
                                soll. Zum Beispiel: sdb
                            </para></entry>
                            <entry><para>Nein</para></entry>
                        </row>
                    </tbody>
                </tgroup>
            </table>
            </para>
            <para>
                <code>run</code> gibt Informationen über jede Instanz zurück die gestartet wird.
            </para>
            <programlisting role="php"><![CDATA[
$ec2_instance = new Zend_Service_Amazon_Ec2_Instance('aws_key',
                                                     'aws_secret_key');
$return = $ec2_instance->run(array('imageId' => 'ami-509320',
                                   'keyName' => 'myKey',
                                   'securityGroup' => array('web',
                                                            'default')));
]]></programlisting>

        </example>

        <example id="zend.service.amazon.ec2.instance.operations.reboot">
            <title>Neu booten von EC2 Instanzen</title>
            <para>
                <code>reboot</code> bootet eine oder mehrere Instanzen.
            </para>
            <para>
                Diese Operation ist asynchron; die queuet nur die Anfrage eine spezifizierte
                Instanz(en) zu rebooten. Die Operation wird erfolgreich sein wenn die Instanzen
                gültig sind und dem Benutzer gehören. Anfragen um beendete Instanzen zu rebooten
                werden ignoriert.
            </para>
            <para>
                <code>reboot</code> gibt ein boolsches true oder false zurück
            </para>
            <programlisting role="php"><![CDATA[
$ec2_instance = new Zend_Service_Amazon_Ec2_Instance('aws_key',
                                                     'aws_secret_key');
$return = $ec2_instance->reboot('instanceId');
]]></programlisting>

        </example>

        <example id="zend.service.amazon.ec2.instance.operations.terminate">
            <title>Beenden von EC2 Instanzen</title>
            <para>
                <code>terminate</code> führt eine oder mehrere Instanzen herunter. Diese Operation
                ist idempotent; wenn eine Instanz mehr als einmal terminiert wird, wird jeder
                Aufruf erfolgreich sein.
            </para>
            <para>
                <code>terminate</code> gibt ein boolsches true oder false zurück
            </para>
            <programlisting role="php"><![CDATA[
$ec2_instance = new Zend_Service_Amazon_Ec2_Instance('aws_key',
                                                     'aws_secret_key');
$return = $ec2_instance->terminate('instanceId');
]]></programlisting>
        </example>
        <note>
            <title>Terminierte Instanzen</title>
            <para>Terminierte Instanzen bleiben nach der Terminierung sichtbar (voraussichtlich
            eine Stunde).</para>
        </note>
    </sect2>

    <sect2 id="zend.service.amazon.ec2.instance.utility">
        <title>Utilities für Amazon Instanzen</title>
        <para>
            In diesem Kapitel erfährt man wie man Informationen über die Ausgabe der Console
            erhält und sieht ob eine Instanz einen Produktcode enthält.
        </para>

        <example id="zend.service.amazon.ec2.instance.utility.describe">
            <title>Instanzen beschreiben</title>
            <para>
                <code>describe</code> gibt Information über die Instanzen zurück die einem
                gehören.
            </para>
            <para>
                Wenn man eine oder mehrere Instanz IDs spezifiziert, gibt Amazon EC2 Informationen
                über diese Instanzen zurück. Wenn man keine Instanz IDs spezifiziert, gibt Amazon
                EC2 Informationen über alle relevanten Instanzen zurück. Wenn eine ungültige
                Instanz ID spezifiziert wird, wird ein Fehler zurückgegeben. Wenn eine Instanz
                spezifiziert wird die man nicht besitzt, wird diese in den zurückgegebenen
                Ergebnissen nicht enthalten sein.
            </para>
            <para>
                <code>describe</code> gibt ein Array zurück das Informationen über die Instanz
                enthält.
            </para>
            <programlisting role="php"><![CDATA[
$ec2_instance = new Zend_Service_Amazon_Ec2_Instance('aws_key',
                                                     'aws_secret_key');
$return = $ec2_instance->describe('instanceId');
]]></programlisting>
        </example>

        <note>
            <title>Beendete Instanzen</title>
            <para>
                Kürzlich beendete Instanzen können in den zurückgegebenen Ergebnissen
                vorkommen. Das Interval ist normalerweise weniger als eine Stunde. Wenn man
                nicht will das beendete Instanzen zurückgegeben werden, muß eine zweite
                Variable, ein boolsches true, an <code>describe</code> übergeben werden,
                und die beendete Instanz wird ignoriert.
            </para>
        </note>

        <example id="zend.service.amazon.ec2.instance.utility.describebyimageid">
            <title>Instanzen anhand der Image Id beschreiben</title>
            <para>
                <code>describeByImageId</code> ist funktional identisch mit <code>describe</code>
                gibt aber nur die Instanz zurück, die die angegebene imageId verwendet.
            </para>
            <para>
                <code>describeByImageId</code>  gibt ein Array zurück das Informationen über die
                Instanzen enthält, die von der übergebenen imageId gestartet wurden.
            </para>
            <programlisting role="php"><![CDATA[
$ec2_instance = new Zend_Service_Amazon_Ec2_Instance('aws_key',
                                                     'aws_secret_key');
$return = $ec2_instance->describeByImageId('imageId');
]]></programlisting>
        </example>

        <note>
            <title>Beendete Instanzen</title>
            <para>
                Kürzlich beendete Instanzen können in den zurückgegebenen Ergebnissen
                vorkommen. Das Interval ist normalerweise weniger als eine Stunde. Wenn man
                nicht will das beendete Instanzen zurückgegeben werden, muß eine zweite
                Variable, ein boolsches true, an <code>describe</code> übergeben werden,
                und die beendete Instanz wird ignoriert.
            </para>
        </note>

        <example id="zend.service.amazon.ec2.instance.utility.consoleOutput">
            <title>Empfangen von Konsolen-Ausgaben</title>
            <para>
                <code>consoleOutput</code> empfänge die Ausgabe der Konsole für eine spezifizierte
                Instanz.
            </para>
            <para>
                Die Ausgabe der Konsole einer Instanz wird gepuffert und kurz nach dem Booten, neu
                Booten, und Beenden der Instanz gesendet. Amazon EC2 sichert die letzten 64 KB
                Ausgabe, welche zumindest eine Stunde nach dem letzten Senden verfügbar sein ist.
            </para>
            <para>
                <code>consoleOutput</code> gibt ein Array zurück das
                <code>instanceId</code>, <code>timestamp</code> von der letzten Ausgabe enthält und
                <code>output</code> von der Konsole.
            </para>
            <programlisting role="php"><![CDATA[
$ec2_instance = new Zend_Service_Amazon_Ec2_Instance('aws_key',
                                                     'aws_secret_key');
$return = $ec2_instance->consoleOutput('instanceId');
]]></programlisting>

        </example>

        <example id="zend.service.amazon.ec2.instance.utility.confirmproduct">
            <title>Produktcode an einer Instanz bestätigen</title>
            <para>
                <code>confirmProduct</code> gibt true zurück wenn der spezifizierte Produktcode
                der spezifizierten Instanz angehängt ist. Die Operation gibt false zurück wenn
                der Produktcode der Instanz nicht angehängt ist.
            </para>
            <para>
                Die <code>confirmProduct</code> Operation kann nur von dem Eigentümer der AMI
                ausgeführt werden. Dieses Feature ist nützlich wenn ein AMI Eigentümer
                Support anbietet und sicherstellen will ob die Instanz eines Benutzer
                korrekt ist.
            </para>
            <programlisting role="php"><![CDATA[
$ec2_instance = new Zend_Service_Amazon_Ec2_Instance('aws_key',
                                                     'aws_secret_key');
$return = $ec2_instance->terminate('productCode', 'instanceId');
]]></programlisting>

        </example>
    </sect2>
</sect1>